@cosmicdrift/kumiko-framework 0.373.0 → 0.374.0

package/dist/engine/build-app-schema.js

@@ -27,6 +27,7 @@ import { ZodObject } from "zod";
 import { collectUrlPrefillFieldsByScreenQn } from "./boot-validator/url-prefill-fields.js";
 import { buildConfigFeatureSchema, SETTINGS_HUB_FEATURE, } from "./build-config-feature-schema.js";
 import { isEncryptedAtRest } from "./config-helpers.js";
+import { isListQueryWithoutSearchableFields } from "./entity-list-searchability.js";
 import { QnTypes, qualifyEntityName } from "./qualified-name.js";
 export function buildAppSchema(registry, options = {}) {
     const features = [];
@@ -341,11 +342,14 @@ function projectConfigEditScreen(screen, encryptedConfigKeyQns) {
     return fields === undefined ? screen : { ...screen, fields };
 }
 function projectProjectionListScreen(screen, registry) {
-    const schema = registry.getQueryHandler(screen.query)?.schema;
-    const capabilities = deriveProjectionListCapabilities(schema);
+    const handler = registry.getQueryHandler(screen.query);
+    const capabilities = deriveProjectionListCapabilities(handler?.schema);
+    // A search box over an entity without searchable fields would never match.
+    const searchable = capabilities.searchable &&
+        !isListQueryWithoutSearchableFields(screen.query, handler, (name) => registry.getEntity(name));
     return {
         ...screen,
-        searchable: screen.searchable ?? capabilities.searchable,
+        searchable: screen.searchable ?? searchable,
         sortable: capabilities.sortable,
         paginated: capabilities.paginated,
     };

package/dist/engine/entity-list-searchability.d.ts

@@ -0,0 +1,5 @@
+import type { EntityDefinition, QueryHandlerDef } from "./types/index.ts";
+export declare function resolveEntityBehindListQuery(queryQn: string, handler: QueryHandlerDef | undefined, lookupEntity: (entityName: string) => EntityDefinition | undefined): EntityDefinition | undefined;
+/** True when the list query is an entity-convention one over an entity with no
+ *  searchable field — a search box would never match anything. */
+export declare function isListQueryWithoutSearchableFields(queryQn: string, handler: QueryHandlerDef | undefined, lookupEntity: (entityName: string) => EntityDefinition | undefined): boolean;

package/dist/engine/entity-list-searchability.js

@@ -0,0 +1,35 @@
+import { ENTITY_CONVENTION_QUERY_BRAND } from "@cosmicdrift/kumiko-types/handlers";
+import { parseQn } from "./qualified-name.js";
+// Mirrors buildSearchableSortableCaches (registry-validate.ts): a `search`
+// payload only matches text fields, embedded sub-fields and references that
+// opted in with `searchable: true`.
+function entityHasSearchableField(entity) {
+    return Object.values(entity.fields).some((field) => {
+        if (field.type === "embedded") {
+            return Object.values(field.schema).some((subField) => subField.searchable === true);
+        }
+        return (field.type === "text" || field.type === "reference") && field.searchable === true;
+    });
+}
+// Entity-convention list queries (ENTITY_CONVENTION_QUERY_BRAND) carry no
+// entity on the handler; the entity name is recovered from the query QN's
+// `<entityName>:list` naming convention. Hand-written handlers resolve to
+// undefined — "capability unknown, no throw".
+export function resolveEntityBehindListQuery(queryQn, handler, lookupEntity) {
+    if (handler === undefined || handler[ENTITY_CONVENTION_QUERY_BRAND] !== true)
+        return undefined;
+    let entityName;
+    try {
+        entityName = parseQn(queryQn).name.split(":")[0] ?? "";
+    }
+    catch {
+        return undefined;
+    }
+    return entityName === "" ? undefined : lookupEntity(entityName);
+}
+/** True when the list query is an entity-convention one over an entity with no
+ *  searchable field — a search box would never match anything. */
+export function isListQueryWithoutSearchableFields(queryQn, handler, lookupEntity) {
+    const entity = resolveEntityBehindListQuery(queryQn, handler, lookupEntity);
+    return entity !== undefined && !entityHasSearchableField(entity);
+}

package/dist/engine/feature-ui-extensions.js

@@ -31,9 +31,12 @@ function qualifySelectorPanel(featureName, panel) {
             throw new Error(`[Feature ${featureName}] extensionSelector screen panel "${panel.id}" must not set a label — ` +
                 `the settings dashboard has no i18n namespace for it; the embedded screen carries its own title.`);
         }
-        if (panel.screen === "" || isValidQn(panel.screen))
+        const qualify = (ref) => ref === "" || isValidQn(ref) ? ref : qualifyEntityName(featureName, "screen", ref);
+        const screen = qualify(panel.screen);
+        const fallback = panel.fallback === undefined ? undefined : qualify(panel.fallback);
+        if (screen === panel.screen && fallback === panel.fallback)
             return panel;
-        return { ...panel, screen: qualifyEntityName(featureName, "screen", panel.screen) };
+        return { ...panel, screen, ...(fallback !== undefined && { fallback }) };
     }
     throw new Error(`[Feature ${featureName}] extensionSelector panel ${JSON.stringify(panel)} has an unsupported kind — ` +
         `only "custom" and "screen" panels are allowed.`);

package/dist/engine/index.d.ts

@@ -51,6 +51,7 @@ export { i18nKey } from "./i18n-key.ts";
 export { buildSessionRoles, findForbiddenMembershipRole, isForbiddenMembershipRole, stripForbiddenMembershipRoles, } from "./membership-roles.ts";
 export type { OwnershipClause, OwnershipMap, OwnershipRef, OwnershipRule } from "./ownership.ts";
 export { buildOwnershipClause, combineClauses, from, normalizeAccessEntry, userCanCreateFieldRow, userCanReadFieldRow, userCanWriteFieldRow, } from "./ownership.ts";
+export { type PagedListRequest, type PagedListRowValue, pagedListSchema, pageRows, } from "./paged-list.ts";
 export type { ParsedRefTarget } from "./parse-ref-target.ts";
 export { parseRefTarget, parseRefTargetEntityName } from "./parse-ref-target.ts";
 export { buildPipelineSteps, stepsPipeline } from "./pipeline.ts";
@@ -83,7 +84,7 @@ export { assertNotificationVariables, templateVariable, templateVariablesToZod,
 export { type EffectiveFeaturesResolver, findTierResolverUsage, isTierResolverPlugin, requireTierResolverPlugin, TENANT_TIER_RESOLVER_EXT, type TierResolverPlugin, type TrialGate, } from "./tier-resolver-extension.ts";
 export { findOverDeepTransferChain, resolveTransferAdjacency as resolveEntityTransferAdjacency, type TransferAdjacency, type TransferEdge, type TransferEdgeLink, } from "./transfer-adjacency.ts";
 export { isSystemTenant, isUuid, parseTenantId, SYSTEM_TENANT_ID } from "./types/identifiers.ts";
-export type { AccessRule, ActionFormScreenDefinition, ActiveMembership, ActiveMembershipRejection, ActiveMembershipResult, AgentExposure, AgentHandlerHints, AgentRisk, AppContext, AppendEventArgs, AppendEventFn, AuthClaimsContext, AuthClaimsFn, AuthClaimsHookDef, BeforeTransactionPhase, BeforeTransactionResult, BelongsToRelation, BigIntFieldDef, BooleanFieldDef, BootOptionName, CamelToKebab, ChatSendFailureCode, ClaimKeyDefinition, ClaimKeyHandle, ClaimKeyJsType, ClaimKeyType, ConcurrencyMode, ConfigAccessor, ConfigAccessorFactory, ConfigBacking, ConfigCascade, ConfigCascadeLevel, ConfigDefinition, ConfigEditScreenDefinition, ConfigKeyAccess, ConfigKeyDefinition, ConfigKeyHandle, ConfigKeyType, ConfigMask, ConfigResolver, ConfigScope, ConfigSecretsReader, ConfigSeedDef, ConfigStoredRow, ConfigStoredRowWithSource, ConfigValidateContext, ConfigValidateFn, ConfigValue, ConfigValueSource, ConfigValueWithSource, ContentCollectionDefinition, CreateSeedOptions, CreateTenantSeedOptions, CreateUserSeedOptions, CustomScreenDefinition, CustomScreenRoute, DashboardChartPanel, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelVisibility, DashboardProgressListPanel, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextParam, DashboardValueFormat, DateFieldDef, DecimalFieldDef, DeleteContext, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, DeriveContext, DerivedFieldDef, DerivedFieldsMap, DerivedValueType, EditExtensionSection, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EmbeddedListEditSpec, EntityDefinition, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityId, EntityListExpandableRow, EntityListScreenDefinition, EntityObjectDefinition, EntityRef, EntityRelations, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchReporter, EscapeHatchTarget, EscapeHatchUseEvent, EventDef, ExtensionOptionsArgs, ExtensionOptionsFor, FeatureDefinition, FeatureRegistrar, FieldAccess, FieldCondition, FieldDefinition, FieldFormatRegistry, FieldIconKey, FieldRenderer, FileFieldDef, FilesFieldDef, Findability, FormatSpec, FormWidth, HandlerContext, HasManyRelation, HookDefinition, HookMap, ImageFieldDef, ImagesFieldDef, JobBackoff, JobBackoffStrategy, JobContext, JobDefinition, JobHandlerFn, JobTrigger, JobTriggerEvent, JsonbFieldDef, KumikoEntityTypeMap, KumikoEventTypeMap, KumikoExtensionOptionsMap, KumikoHandlerPayloadMap, KumikoHandlerResultMap, LifecycleHookType, ListColumnSpec, ListFacetSpec, ListPaginationMode, ListSortDir, ListSortSpec, LongTextFindability, ManyToManyRelation, MaxPerTenantOptions, MemberReader, MetricNavigate, MetricSpec, MspErrorMode, MspErrorPolicy, MultiSelectFieldDef, MultiStreamApplyFn, MultiStreamProjectionDefinition, NameOrRef, NavDefinition, NavIconKey, NotificationDataFn, NotificationDefinition, NotificationLocalizedTemplate, NotificationRecipientFn, NotificationRecordMapping, NotificationTemplateBody, NotificationTemplateFn, NotificationTemplateMeta, NotifyDeferred, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, NumberFieldDef, OnDeleteStrategy, OpenToAllAccessRule, OpenToAllDeclaration, OpenToAllPersonalData, ParentRefDef, PersonalAnnotations, PersonalAnnotationsLongText, PersonalAnnotationsNoFind, PersonalSubject, PlatformComponent, PluralForms, PostDeleteHookFn, PostSaveHookFn, PreDeleteHookFn, PreparedWriteEvent, PreQueryHookFn, PreSaveHookFn, ProjectionDefinition, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, ProjectionTable, QualifiedEventName, QueryEvent, QueryHandlerDef, QueryHandlerFn, RateLimitPer, RecordHeaderSpec, RecordHeaderSubtitlePart, ReferenceDataDef, Registry, RelationDefinition, ResolvedPiiFlags, RetentionDef, RoleAccessPersonalData, RoleAccessRule, RowAction, RowActionNavigate, RowActionNavigateBase, RowActionWriteHandler, RowFieldExtractor, SaveContext, ScreenDefinition, ScreenFilter, ScreenFilterOp, ScreenNavSugar, ScreenSlots, SecretKeyDefinition, SecretKeyHandle, SecretMintConfirmStep, SecretMintScreenDefinition, SecretNamespaceDefinition, SecretNamespaceHandle, SecretNamespaceOptions, SecretReveal, SecretRevealField, SecretsEditScreenDefinition, SecretsEditSection, SelectFieldDef, SessionUser, SessionUserOrigin, StackBootRequirement, StreamHandlerDef, StreamHandlerFn, Subscribe, TargetRef, TemplateListVariableDef, TemplateScalarVariableDef, TemplateVariableDef, TemplateVariables, TenantId, TenantWriteTarget, TextFieldDef, ToolbarAction, TranslationEntry, TranslationKeys, TranslationsDef, TranslationValue, TreeAction, TreeActionDef, TreeActionsHandle, TreeChildrenSubscribe, TreeNode, TreeNodeState, UnitKey, UnsafeAppendEventFn, ValidationError, ValidationHookFn, WorkspaceDefinition, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "./types/index.ts";
+export type { AccessRule, ActionFormScreenDefinition, ActiveMembership, ActiveMembershipRejection, ActiveMembershipResult, AgentExposure, AgentHandlerHints, AgentRisk, AppContext, AppendEventArgs, AppendEventFn, AuthClaimsContext, AuthClaimsFn, AuthClaimsHookDef, BeforeTransactionPhase, BeforeTransactionResult, BelongsToRelation, BigIntFieldDef, BooleanFieldDef, BootOptionName, CamelToKebab, ChatSendFailureCode, ClaimKeyDefinition, ClaimKeyHandle, ClaimKeyJsType, ClaimKeyType, ConcurrencyMode, ConfigAccessor, ConfigAccessorFactory, ConfigBacking, ConfigCascade, ConfigCascadeLevel, ConfigDefinition, ConfigEditScreenDefinition, ConfigKeyAccess, ConfigKeyDefinition, ConfigKeyHandle, ConfigKeyType, ConfigMask, ConfigResolver, ConfigScope, ConfigSecretsReader, ConfigSeedDef, ConfigStoredRow, ConfigStoredRowWithSource, ConfigValidateContext, ConfigValidateFn, ConfigValue, ConfigValueSource, ConfigValueWithSource, ContentCollectionDefinition, CreateSeedOptions, CreateTenantSeedOptions, CreateUserSeedOptions, CustomScreenDefinition, CustomScreenRoute, DashboardChartPanel, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRecordBinding, DashboardRefresh, DashboardRelativeTimeFormat, DashboardRelativeTimeParam, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardValueFormat, DateFieldDef, DecimalFieldDef, DeleteContext, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, DeriveContext, DerivedFieldDef, DerivedFieldsMap, DerivedValueType, EditExtensionSection, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EmbeddedListEditSpec, EntityDefinition, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityId, EntityListExpandableRow, EntityListScreenDefinition, EntityObjectDefinition, EntityRef, EntityRelations, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchReporter, EscapeHatchTarget, EscapeHatchUseEvent, EventDef, ExtensionOptionsArgs, ExtensionOptionsFor, FeatureDefinition, FeatureRegistrar, FieldAccess, FieldCondition, FieldDefinition, FieldFormatRegistry, FieldIconKey, FieldRenderer, FileFieldDef, FilesFieldDef, Findability, FormatSpec, FormWidth, HandlerContext, HasManyRelation, HookDefinition, HookMap, ImageFieldDef, ImagesFieldDef, JobBackoff, JobBackoffStrategy, JobContext, JobDefinition, JobHandlerFn, JobTrigger, JobTriggerEvent, JsonbFieldDef, KumikoEntityTypeMap, KumikoEventTypeMap, KumikoExtensionOptionsMap, KumikoHandlerPayloadMap, KumikoHandlerResultMap, LifecycleHookType, ListColumnSpec, ListFacetSpec, ListPaginationMode, ListSortDir, ListSortSpec, LongTextFindability, ManyToManyRelation, MaxPerTenantOptions, MemberReader, MetricNavigate, MetricSpec, MspErrorMode, MspErrorPolicy, MultiSelectFieldDef, MultiStreamApplyFn, MultiStreamProjectionDefinition, NameOrRef, NavDefinition, NavIconKey, NotificationDataFn, NotificationDefinition, NotificationLocalizedTemplate, NotificationRecipientFn, NotificationRecordMapping, NotificationTemplateBody, NotificationTemplateFn, NotificationTemplateMeta, NotifyDeferred, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, NumberFieldDef, OnDeleteStrategy, OpenToAllAccessRule, OpenToAllDeclaration, OpenToAllPersonalData, ParentRefDef, PersonalAnnotations, PersonalAnnotationsLongText, PersonalAnnotationsNoFind, PersonalSubject, PlatformComponent, PluralForms, PostDeleteHookFn, PostSaveHookFn, PreDeleteHookFn, PreparedWriteEvent, PreQueryHookFn, PreSaveHookFn, ProjectionDefinition, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, ProjectionTable, QualifiedEventName, QueryEvent, QueryHandlerDef, QueryHandlerFn, RateLimitPer, RecordHeaderSpec, RecordHeaderSubtitlePart, ReferenceDataDef, Registry, RelationDefinition, ResolvedPiiFlags, RetentionDef, RoleAccessPersonalData, RoleAccessRule, RowAction, RowActionNavigate, RowActionNavigateBase, RowActionWriteHandler, RowFieldExtractor, SaveContext, ScreenDefinition, ScreenFilter, ScreenFilterOp, ScreenNavSugar, ScreenSlots, SecretKeyDefinition, SecretKeyHandle, SecretMintConfirmStep, SecretMintScreenDefinition, SecretNamespaceDefinition, SecretNamespaceHandle, SecretNamespaceOptions, SecretReveal, SecretRevealField, SecretsEditScreenDefinition, SecretsEditSection, SelectFieldDef, SessionUser, SessionUserOrigin, StackBootRequirement, StreamHandlerDef, StreamHandlerFn, Subscribe, TargetRef, TemplateListVariableDef, TemplateScalarVariableDef, TemplateVariableDef, TemplateVariables, TenantId, TenantWriteTarget, TextFieldDef, ToolbarAction, TranslationEntry, TranslationKeys, TranslationsDef, TranslationValue, TreeAction, TreeActionDef, TreeActionsHandle, TreeChildrenSubscribe, TreeNode, TreeNodeState, UnitKey, UnsafeAppendEventFn, ValidationError, ValidationHookFn, WorkspaceDefinition, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "./types/index.ts";
 export { DEFAULT_CURRENCIES, DEFAULT_LOCALES, DELIVERY_FAILURE_CODES, DELIVERY_SKIP_REASONS, HookPhases, HTTP_ERROR_CODE_PATTERN, isAgentVisibleScreen, isDeliveryErrorCode, isOpenToAllGranted, resolveAgentExposure, } from "./types/index.ts";
 export type { AwaitedEventType, PipelineBuildCtx, PipelineCtx, PipelineDef, StepBuilder, StepDef, StepFailureStrategy, StepInstance, StepKind, StepNamespace, StepResolver, } from "./types/step.ts";
 export { runValidation } from "./validation.ts";

package/dist/engine/index.js

@@ -51,6 +51,7 @@ export { i18nKey } from "./i18n-key.js";
 // surface.
 export { buildSessionRoles, findForbiddenMembershipRole, isForbiddenMembershipRole, stripForbiddenMembershipRoles, } from "./membership-roles.js";
 export { buildOwnershipClause, combineClauses, from, normalizeAccessEntry, userCanCreateFieldRow, userCanReadFieldRow, userCanWriteFieldRow, } from "./ownership.js";
+export { pagedListSchema, pageRows, } from "./paged-list.js";
 export { parseRefTarget, parseRefTargetEntityName } from "./parse-ref-target.js";
 export { buildPipelineSteps, stepsPipeline } from "./pipeline.js";
 export { projectAppSchemaForRoles } from "./project-app-schema-for-roles.js";

package/dist/engine/paged-list.d.ts

@@ -0,0 +1,29 @@
+import type { CursorResult } from "@cosmicdrift/kumiko-types/cursor-types";
+import * as z from "zod";
+export type PagedListRowValue = string | number | boolean | null;
+export declare function pagedListSchema<const TSortField extends string>(sortableFields: readonly [TSortField, ...TSortField[]]): z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    search: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodEnum<{ [k in TSortField]: k; } extends infer T ? { [k in keyof T]: T[k]; } : never>>;
+    sortDirection: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    totalCount: z.ZodOptional<z.ZodBoolean>;
+    cursor: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>;
+export type PagedListRequest<TSortField extends string> = {
+    readonly limit: number;
+    readonly offset?: number | undefined;
+    readonly search?: string | undefined;
+    readonly sort?: TSortField | undefined;
+    readonly sortDirection?: "asc" | "desc" | undefined;
+    readonly totalCount?: boolean | undefined;
+};
+export declare function pageRows<TRow extends Readonly<Record<TSortField, PagedListRowValue>> & {
+    readonly id: string;
+}, TSortField extends string>(rows: readonly TRow[], request: PagedListRequest<TSortField>, options: {
+    readonly searchFields: readonly TSortField[];
+    readonly defaultSort: TSortField;
+}): CursorResult<TRow>;

package/dist/engine/paged-list.js

@@ -0,0 +1,56 @@
+// Search, sort and offset paging for projectionList queries whose rows are
+// assembled in memory (merged from several tables, no single SQL query to
+// page). The projectionList pager sends `offset` + `totalCount`, never a
+// cursor, so `nextCursor` is always null here.
+import * as z from "zod";
+import { MAX_LIST_LIMIT } from "./entity-handlers.js";
+export function pagedListSchema(sortableFields) {
+    return z.object({
+        limit: z.number().int().min(1).max(MAX_LIST_LIMIT).default(50),
+        offset: z.number().int().nonnegative().optional(),
+        search: z.string().optional(),
+        sort: z.enum(sortableFields).optional(),
+        sortDirection: z.enum(["asc", "desc"]).optional(),
+        totalCount: z.boolean().optional(),
+        // Declared so a caller still paging by cursor gets a 400 instead of page one.
+        cursor: z.never({ error: "cursor paging is not supported here; page with offset" }).optional(),
+    });
+}
+function isMissing(value) {
+    return value === null || value === undefined;
+}
+// Missing values sort last in both directions; numbers and booleans compare
+// by value, everything else as a locale-aware string.
+function compareRowValues(a, b, directionMultiplier) {
+    if (isMissing(a) && isMissing(b))
+        return 0;
+    if (isMissing(a))
+        return 1;
+    if (isMissing(b))
+        return -1;
+    if (typeof a === "number" && typeof b === "number")
+        return (a - b) * directionMultiplier;
+    if (typeof a === "boolean" && typeof b === "boolean") {
+        return (Number(a) - Number(b)) * directionMultiplier;
+    }
+    return String(a).localeCompare(String(b)) * directionMultiplier;
+}
+export function pageRows(rows, request, options) {
+    const needle = request.search?.trim().toLowerCase() ?? "";
+    const matching = needle === ""
+        ? rows
+        : rows.filter((row) => options.searchFields.some((field) => String(row[field] ?? "")
+            .toLowerCase()
+            .includes(needle)));
+    const sortField = request.sort ?? options.defaultSort;
+    const directionMultiplier = request.sortDirection === "desc" ? -1 : 1;
+    // The source rows come unordered, so ties fall back to the id; otherwise a
+    // tied row could show up on two pages or on none.
+    const sorted = [...matching].sort((a, b) => compareRowValues(a[sortField], b[sortField], directionMultiplier) || a.id.localeCompare(b.id));
+    const offset = request.offset ?? 0;
+    return {
+        rows: sorted.slice(offset, offset + request.limit),
+        nextCursor: null,
+        ...(request.totalCount === true && { total: matching.length }),
+    };
+}

package/dist/engine/project-app-schema-for-roles.js

@@ -39,8 +39,8 @@
 //     resolves app-wide via a global short-id map, mirroring
 //     resolveRowActionNavigateTarget; kind:"drawer" resolves same-feature
 //     only, mirroring validateDrawerTargetAction)
-//   - projectionDetail header actions + metrics[].navigate
-//   - entityEdit/actionForm/secretMint redirect + actionForm cancelTarget
+//   - projectionDetail and dashboard header actions + projectionDetail metrics[].navigate
+//   - entityEdit/actionForm/secretMint redirect + actionForm successLinks and cancelTarget
 //     (resolveScreenTargetQn: same-feature short id or cross-feature QN)
 //   - dashboard DashboardScreenPanel.screen (resolveScreenTargetQn)
 //   - every EditSectionSpec kind's own `actions` (fields/extension/writeForm/
@@ -418,8 +418,27 @@ function projectHeader(header, indices, keptScreenQns) {
     return changed ? { ...header, subtitle: nextParts } : header;
 }
 function projectDashboardPanels(panels, feature, keptScreenQns) {
-    const kept = panels.filter((p) => p.kind !== "screen" || isScreenTargetKept(feature.featureName, p.screen, keptScreenQns));
-    return kept.length === panels.length ? panels : kept;
+    let changed = false;
+    const kept = [];
+    for (const panel of panels) {
+        if (panel.kind !== "screen") {
+            kept.push(panel);
+        }
+        else if (!isScreenTargetKept(feature.featureName, panel.screen, keptScreenQns)) {
+            changed = true;
+        }
+        else if (panel.fallback !== undefined &&
+            !isScreenTargetKept(feature.featureName, panel.fallback, keptScreenQns)) {
+            // The role cannot reach the stand-in, so the tile just hides.
+            const { fallback: _unreachable, ...withoutFallback } = panel;
+            kept.push(withoutFallback);
+            changed = true;
+        }
+        else {
+            kept.push(panel);
+        }
+    }
+    return changed ? kept : panels;
 }
 // --- per-screen-type projection ---
 function projectListScreenId(listScreenId, indices, keptScreenQns) {
@@ -512,12 +531,15 @@ function projectEntityEditScreen(screen, feature, indices, keptScreenQns) {
     };
 }
 function projectActionFormScreen(screen, feature, indices, keptScreenQns) {
-    const { redirect, cancelTarget, layout, listScreenId, ...rest } = screen;
+    const { redirect, successLinks, cancelTarget, layout, listScreenId, ...rest } = screen;
     const nextRedirect = projectRedirect(feature.featureName, redirect, keptScreenQns);
+    const keptSuccessLinks = successLinks?.filter((link) => isRedirectTargetKept(feature.featureName, link, keptScreenQns));
+    const nextSuccessLinks = keptSuccessLinks?.length === 0 ? undefined : keptSuccessLinks;
     const nextCancelTarget = projectCancelTarget(feature.featureName, cancelTarget, keptScreenQns);
     const nextLayout = projectEditLayout(layout, feature, indices, keptScreenQns);
     const nextListScreenId = projectListScreenId(listScreenId, indices, keptScreenQns);
     const unchanged = nextRedirect === redirect &&
+        nextSuccessLinks?.length === successLinks?.length &&
         nextCancelTarget === cancelTarget &&
         nextLayout === layout &&
         nextListScreenId === listScreenId;
@@ -527,6 +549,7 @@ function projectActionFormScreen(screen, feature, indices, keptScreenQns) {
         ...rest,
         layout: nextLayout,
         ...(nextRedirect !== undefined && { redirect: nextRedirect }),
+        ...(nextSuccessLinks !== undefined && { successLinks: nextSuccessLinks }),
         ...(nextCancelTarget !== undefined && { cancelTarget: nextCancelTarget }),
         ...(nextListScreenId !== undefined && { listScreenId: nextListScreenId }),
     };
@@ -565,8 +588,16 @@ function projectScreen(screen, feature, indices, keptScreenQns) {
         case "projectionDetail":
             return projectProjectionDetailScreen(screen, feature, indices, keptScreenQns);
         case "dashboard": {
+            const { actions, ...rest } = screen;
             const nextPanels = projectDashboardPanels(screen.panels, feature, keptScreenQns);
-            return nextPanels === screen.panels ? screen : { ...screen, panels: nextPanels };
+            const nextActions = projectRowActionArray(actions, feature, indices, keptScreenQns);
+            if (nextPanels === screen.panels && nextActions === actions)
+                return screen;
+            return {
+                ...rest,
+                panels: nextPanels,
+                ...(nextActions !== undefined && { actions: nextActions }),
+            };
         }
         case "entityEdit":
             return projectEntityEditScreen(screen, feature, indices, keptScreenQns);

package/dist/engine/types/index.d.ts

@@ -17,7 +17,7 @@ export type { ContentCollectionDefinition, NavDefinition, NavIconKey, } from "@c
 export type { FromRule, FromRuleKind, OwnershipClause, OwnershipMap, OwnershipRef, OwnershipRule, SqlFragment, WhereRule, WhereRuleContext, } from "@cosmicdrift/kumiko-types/ownership";
 export type { EntityProjectionExtension, MspErrorMode, MspErrorPolicy, MultiStreamApplyFn, MultiStreamProjectionDefinition, ProjectionDefinition, ProjectionRowIdOf, ProjectionTable, SingleStreamApplyFn, } from "@cosmicdrift/kumiko-types/projection";
 export type { BelongsToRelation, EntityRelations, HasManyRelation, ManyToManyRelation, RelationDefinition, } from "@cosmicdrift/kumiko-types/relations";
-export type { ActionFormScreenDefinition, ConfigEditScreenDefinition, CustomScreenDefinition, CustomScreenRoute, DashboardChartMarkerKind, DashboardChartPanel, DashboardChartRangeOption, DashboardChartRanges, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelGate, DashboardPanelVisibility, DashboardProgressListPanel, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextParam, DashboardValueFormat, EditExtensionSection, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityListExpandableRow, EntityListScreenDefinition, FieldCondition, FieldFormatRegistry, FieldRenderer, FormatSpec, FormWidth, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListPaginationMode, ListSortDir, ListSortSpec, MetricNavigate, MetricSpec, PlatformComponent, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSpec, RecordHeaderSubtitlePart, RowAction, RowActionNavigate, RowActionNavigateBase, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFilter, ScreenFilterOp, ScreenNavSugar, ScreenSlots, SecretMintConfirmStep, SecretMintScreenDefinition, SecretReveal, SecretRevealField, SecretsEditScreenDefinition, SecretsEditSection, ToolbarAction, UnitKey, } from "@cosmicdrift/kumiko-types/screen";
+export type { ActionFormScreenDefinition, ConfigEditScreenDefinition, CustomScreenDefinition, CustomScreenRoute, DashboardChartMarkerKind, DashboardChartPanel, DashboardChartRangeOption, DashboardChartRanges, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelGate, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRecordBinding, DashboardRefresh, DashboardRelativeTimeFormat, DashboardRelativeTimeParam, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardValueFormat, EditExtensionSection, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityListExpandableRow, EntityListScreenDefinition, FieldCondition, FieldFormatRegistry, FieldRenderer, FormatSpec, FormWidth, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListPaginationMode, ListSortDir, ListSortSpec, MetricNavigate, MetricSpec, PlatformComponent, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSpec, RecordHeaderSubtitlePart, RowAction, RowActionNavigate, RowActionNavigateBase, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFilter, ScreenFilterOp, ScreenNavSugar, ScreenSlots, SecretMintConfirmStep, SecretMintScreenDefinition, SecretReveal, SecretRevealField, SecretsEditScreenDefinition, SecretsEditSection, ToolbarAction, UnitKey, } from "@cosmicdrift/kumiko-types/screen";
 export { metricField, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
 export type { TargetRef } from "@cosmicdrift/kumiko-types/target-ref";
 export type { Subscribe, TreeAction, TreeActionDef, TreeActionsHandle, TreeChildrenSubscribe, TreeNode, TreeNodeState, } from "@cosmicdrift/kumiko-types/tree-node";

package/dist/i18n/required-surface-keys.js

@@ -45,6 +45,19 @@ function pushKey(out, value, treatAsKey = false) {
 function editFieldName(f) {
     return typeof f === "string" ? f : f.field;
 }
+// Placeholder, affix texts and the fill button label of a field spec; a `{ field }`
+// affix reads another form field and is no key.
+function pushEditFieldTextKeys(out, spec, treatAsKey = false) {
+    // skip: shorthand field name carries no texts
+    if (typeof spec === "string")
+        return;
+    pushKey(out, spec.placeholder, treatAsKey);
+    for (const affix of [spec.prefix, spec.suffix]) {
+        if (typeof affix === "string")
+            pushKey(out, affix, treatAsKey);
+    }
+    pushKey(out, spec.fillAction?.label, treatAsKey);
+}
 // Group titles are translated exactly like the section title (computeEditViewModel).
 function pushSectionTitles(out, section, treatAsKey = false) {
     pushKey(out, section.title, treatAsKey);
@@ -67,15 +80,20 @@ function pushActionFormShapedKeys(out, featureName, step) {
         pushSectionTitles(out, section);
         for (const f of sectionFieldSpecs(section)) {
             out.add(fieldLabelKey(featureName, ACTION_FORM_ENTITY, editFieldName(f)));
+            pushEditFieldTextKeys(out, f);
         }
     }
 }
 function pushRowActionKeys(out, action) {
     pushKey(out, action.label);
-    if (action.kind === "writeHandler" || action.kind === undefined) {
+    if (action.kind === "writeHandler" ||
+        action.kind === "clientAction" ||
+        action.kind === undefined) {
         pushKey(out, action.confirm);
         pushKey(out, action.confirmLabel);
     }
+    if (action.kind === "clientAction")
+        pushKey(out, action.successMessage);
     if (action.kind === "drawer") {
         pushKey(out, action.title);
         pushKey(out, action.subtitle);
@@ -90,6 +108,8 @@ function pushDashboardScreenKeys(out, dashboard) {
         pushKey(out, option.label);
     pushKey(out, dashboard.scope?.badge);
     pushKey(out, dashboard.scope?.notice);
+    for (const action of dashboard.actions ?? [])
+        pushRowActionKeys(out, action);
 }
 function pushDashboardPanelKeys(out, panel) {
     // skip: custom-Panel übersetzt sich selbst, kein Key hier
@@ -98,8 +118,12 @@ function pushDashboardPanelKeys(out, panel) {
     pushKey(out, panel.label);
     if (panel.kind === "chart" || panel.kind === "stat-group")
         pushKey(out, panel.subtitle);
-    if (panel.kind === "chart")
+    if (panel.kind === "text")
+        pushDashboardTextBlockKeys(out, panel);
+    if (panel.kind === "chart") {
+        pushKey(out, panel.unit);
         pushDashboardChartRangeKeys(out, panel);
+    }
     if (panel.kind === "chart" ||
         panel.kind === "list" ||
         panel.kind === "feed" ||
@@ -107,6 +131,9 @@ function pushDashboardPanelKeys(out, panel) {
         pushKey(out, panel.emptyLabel);
         pushKey(out, panel.emptyHint);
     }
+    pushDashboardChildLabelKeys(out, panel);
+}
+function pushDashboardChildLabelKeys(out, panel) {
     if (panel.kind === "stat-group") {
         for (const stat of panel.stats)
             pushKey(out, stat.label);
@@ -119,6 +146,20 @@ function pushDashboardPanelKeys(out, panel) {
         }
     }
 }
+function pushDashboardTextBlockKeys(out, panel) {
+    for (const block of panel.blocks) {
+        // skip: code is shown verbatim, not translated
+        if (block.kind === "code")
+            continue;
+        if (block.kind === "list") {
+            for (const item of block.items)
+                pushKey(out, item);
+        }
+        else {
+            pushKey(out, block.text);
+        }
+    }
+}
 function pushDashboardChartRangeKeys(out, panel) {
     for (const option of panel.ranges?.options ?? [])
         pushKey(out, option.label);
@@ -243,6 +284,7 @@ export function requiredKeysFromScreen(featureName, screen, options = {}) {
                     continue; // rejected at boot, unreachable here
                 pushSectionTitles(out, section);
                 for (const f of sectionFieldSpecs(section)) {
+                    pushEditFieldTextKeys(out, f);
                     const fieldName = editFieldName(f);
                     const override = edit.fieldLabels?.[fieldName];
                     if (override !== undefined)
@@ -260,6 +302,8 @@ export function requiredKeysFromScreen(featureName, screen, options = {}) {
             pushKey(out, form.summary?.subtitle);
             for (const action of form.footerActions ?? [])
                 pushKey(out, action.label);
+            for (const link of form.successLinks ?? [])
+                pushKey(out, link.label);
             for (const fieldName of Object.keys(form.fields)) {
                 const override = form.fieldLabels?.[fieldName];
                 if (override !== undefined)
@@ -276,6 +320,7 @@ export function requiredKeysFromScreen(featureName, screen, options = {}) {
                     continue; // rejected at boot, unreachable here
                 pushSectionTitles(out, section);
                 for (const f of sectionFieldSpecs(section)) {
+                    pushEditFieldTextKeys(out, f);
                     const fieldName = editFieldName(f);
                     const override = form.fieldLabels?.[fieldName];
                     if (override !== undefined)
@@ -328,6 +373,7 @@ export function requiredKeysFromScreen(featureName, screen, options = {}) {
                 pushSectionTitles(out, section, treatDotFormAsKey);
                 pushKey(out, section.description, treatDotFormAsKey);
                 for (const f of sectionFieldSpecs(section)) {
+                    pushEditFieldTextKeys(out, f, treatDotFormAsKey);
                     const fieldName = editFieldName(f);
                     const override = config.fieldLabels?.[fieldName];
                     if (override !== undefined)
@@ -366,6 +412,7 @@ export function requiredKeysFromScreen(featureName, screen, options = {}) {
                     pushKey(out, section.submitLabel);
                     // kumiko-lint-ignore section-fields-raw writeForm sections carry no groups (EditWriteFormSection)
                     for (const f of section.fields) {
+                        pushEditFieldTextKeys(out, f);
                         const fieldName = editFieldName(f);
                         out.add(fieldLabelKey(featureName, WRITE_FORM_SECTION_ENTITY, fieldName));
                     }
@@ -373,6 +420,7 @@ export function requiredKeysFromScreen(featureName, screen, options = {}) {
                 }
                 pushSectionTitles(out, section);
                 for (const f of sectionFieldSpecs(section)) {
+                    pushEditFieldTextKeys(out, f);
                     const fieldName = editFieldName(f);
                     const override = detail.fieldLabels?.[fieldName];
                     if (override !== undefined)

package/dist/ui-types/index.d.ts

@@ -9,7 +9,7 @@ export type { BooleanFieldDef, DateFieldDef, EmbeddedDerivedCellDef, EntityDefin
 export type { AccessRule, OpenToAllAccessRule, OpenToAllDeclaration, OpenToAllPersonalData, RoleAccessPersonalData, RoleAccessRule, } from "../engine/types/handlers.ts";
 export { isOpenToAllGranted, isUiAccessGranted } from "../engine/types/handlers.ts";
 export type { IconKey, NavDefinition, NavIconKey } from "../engine/types/nav.ts";
-export type { ActionFormFooterAction, ActionFormRedirect, ActionFormScreenDefinition, ConfigEditScreenDefinition, CustomScreenDefinition, CustomScreenRoute, DashboardChartKind, DashboardChartMarkerKind, DashboardChartPanel, DashboardChartRangeOption, DashboardChartRanges, DashboardChartTone, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelGate, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextParam, DashboardTimeRangeDefinition, DashboardValueFormat, EditExtensionSection, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityListExpandableRow, EntityListFacetConfig, EntityListFacetExtraOption, EntityListScreenDefinition, EntityWriteExcludedFields, FieldCondition, FieldIconKey, FieldRenderer, FormWidth, ListBadgeTone, ListColumnDisplay, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListSortSpec, MetricNavigate, MetricSpec, PlatformComponent, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSubtitlePart, RelatedListGroupBy, RelatedListRowTone, RelatedListToolbarAction, RowAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFilter, ScreenFilterOp, ScreenSlots, SecretMintConfirmStep, SecretMintScreenDefinition, SecretReveal, SecretRevealField, SecretsEditScreenDefinition, SecretsEditSection, ToolbarAction, } from "../engine/types/screen.ts";
+export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, ActionFormScreenDefinition, ActionFormSuccessLink, ConfigEditScreenDefinition, CustomScreenDefinition, CustomScreenRoute, 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, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, DashboardValueFormat, EditExtensionSection, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityListExpandableRow, EntityListFacetConfig, EntityListFacetExtraOption, EntityListScreenDefinition, EntityWriteExcludedFields, FieldAffix, FieldCondition, FieldFillAction, FieldIconKey, FieldRenderer, FormWidth, ListBadgeTone, ListColumnDisplay, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListSortSpec, MetricNavigate, MetricSpec, PlatformComponent, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSubtitlePart, RelatedListGroupBy, RelatedListRowTone, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFilter, ScreenFilterOp, ScreenSlots, SecretMintConfirmStep, SecretMintScreenDefinition, SecretReveal, SecretRevealField, SecretsEditScreenDefinition, SecretsEditSection, ToolbarAction, } from "../engine/types/screen.ts";
 export { metricField, relatedListGroupHeaderLabel, relatedListGroupKey, } from "../engine/types/screen.ts";
 export type { TargetRef } from "../engine/types/target-ref.ts";
 export type { TreeAction, TreeNode, TreeNodeState } from "../engine/types/tree-node.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.373.0",
+  "version": "0.374.0",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -199,8 +199,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-http": "0.373.0",
-    "@cosmicdrift/kumiko-types": "0.373.0",
+    "@cosmicdrift/kumiko-http": "0.374.0",
+    "@cosmicdrift/kumiko-types": "0.374.0",
     "bullmq": "^5.76.7",
     "bun-types": "^1.3.13",
     "hono": "^4.13.1",
@@ -216,8 +216,8 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.373.0",
-    "@cosmicdrift/kumiko-testing": "0.373.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.374.0",
+    "@cosmicdrift/kumiko-testing": "0.374.0",
     "bun-types": "^1.3.13",
     "pino-pretty": "^13.1.3"
   },

package/src/changes.json

@@ -1,4 +1,65 @@
 [
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "actionForm successLinks and resetOnSuccess",
+    "detail": "successLinks keeps the actionForm open after a successful submit and lists links resolved like redirect; boot rejects it together with redirect, with an unknown target or with a record target without idFrom. resetOnSuccess clears typed values after success. Role projection drops links to screens the role cannot reach."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "clientAction row actions",
+    "detail": "RowAction gains kind \"clientAction\" with a client-registered handler name; boot rejects a name that is not <feature>:<kebab>, and the surface keys include its confirm, confirmLabel and successMessage."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Boot validation for screen-panel fallback and text panels",
+    "detail": "DashboardScreenPanel.fallback needs visibleWhen and a registered, embeddable target without its own visibleWhen. DashboardTextPanel (kind \"text\", exported with DashboardTextBlock) rejects empty blocks and empty lists; its text keys are required translation keys. Extension-selector panels qualify a short fallback ref, and role projection drops a fallback the role cannot reach."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Dashboard record binding, header actions, refresh and relative time",
+    "detail": "Dashboards take record, actions and refresh; stat panels and text params gain a relativeTime format; the surface keys include kumiko.dashboard.record.missing."
+  },
+  {
+    "version": "0.374.0",
+    "type": "breaking",
+    "title": "DashboardChartPanel.valueFormat only takes the currency format",
+    "detail": "DashboardValueFormat is now a union of DashboardCurrencyFormat and DashboardRelativeTimeFormat. Stat panels take both, chart panels only the currency one, and boot rejects relativeTime on a chart.",
+    "migration": "A chart panel that declares valueFormat keeps working with { kind: \"currency\", currency }. Code that types a chart's valueFormat as DashboardValueFormat should use DashboardCurrencyFormat instead; relativeTime on a chart was never meaningful and now fails boot."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Derived list searchability, actionForm load and drawer rowClick",
+    "detail": "projectionList searchable is derived false for entity-convention lists without searchable fields (searchable true is rejected at boot), actionForm.load registers a query checked at boot, and a drawer row action may set rowClick, counted with navigate rowClick and rejected on projectionDetail header actions."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Boot checks for field affixes and fillAction",
+    "detail": "Boot fails when a fillAction query is not a registered query handler, or when a { field } affix or a fillAction params source is not a field of the same form."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "pagedListSchema and pageRows for in-memory list queries",
+    "detail": "pagedListSchema(sortableFields) and pageRows(rows, request, { searchFields, defaultSort }) cover search, sort (missing values last, ties by id), offset paging and an optional total for projectionList queries over merged rows. PagedListRequest and PagedListRowValue are exported; nextCursor is always null."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "DashboardProgressTone type and unlimited label key",
+    "detail": "New exported type DashboardProgressTone for progress-list row tones. The default translations gain kumiko.dashboard.progress.unlimited."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Dashboard chart panels take a y-axis unit",
+    "detail": "DashboardChartPanel.unit (i18n key) is shown once on the y axis of a timeseries chart, with or without valueFormat. The boot validator rejects unit on other chart kinds; an untranslated unit key fails the required-surface key check."
+  },
   {
     "version": "0.373.0",
     "type": "improvement",