@cosmicdrift/kumiko-framework 0.356.0 → 0.357.0

package/dist/db/event-store-executor-context.d.ts

@@ -29,7 +29,9 @@ export type ExecutorContext = {
     readonly streamTenantFor: (user: SessionUser, requestedStreamTenantId?: TenantId) => TenantId;
     readonly streamTenantOverrideFailure: (db: TenantDb, row: Record<string, unknown>, requestedStreamTenantId: TenantId | undefined) => WriteFailure | undefined;
     readonly idFilter: (id: EntityId) => WhereObject;
-    readonly loadById: (id: EntityId, db: TenantDb) => Promise<Record<string, unknown> | null>;
+    readonly loadById: (id: EntityId, db: TenantDb, options?: {
+        readonly includeDeleted?: boolean;
+    }) => Promise<Record<string, unknown> | null>;
     readonly assertStreamWritable: (db: TenantDb, id: EntityId, tenantId: TenantId) => Promise<void>;
     readonly loadWithOwnership: (db: TenantDb, idWhere: WhereObject, ownership: {
         kind: "pass";

package/dist/db/event-store-executor-context.js

@@ -272,8 +272,9 @@ export function buildExecutorContext(table, entity, options) {
             filter["isDeleted"] = false;
         return filter;
     }
-    async function loadById(id, db) {
-        const row = await db.fetchOne(table, idFilter(id));
+    async function loadById(id, db, options) {
+        // Only the soft-delete predicate is relaxed; the tenant filter of db.fetchOne stays.
+        const row = await db.fetchOne(table, options?.includeDeleted ? { id } : idFilter(id));
         if (!row)
             return null;
         return await decryptForRead(rehydrateCompoundTypes(row, entity));

package/dist/db/event-store-executor-write.js

@@ -343,7 +343,9 @@ export function createWriteVerbs(ctx) {
                         "be SYSTEM_TENANT_ID or omitted.",
                 });
             }
-            const previous = await loadById(payload.id, db);
+            const previous = await loadById(payload.id, db, {
+                includeDeleted: updateOptions?.includeDeleted === true,
+            });
             if (!previous)
                 return writeFailure(new NotFoundError(entityName, payload.id));
             const streamTenantId = updateOptions?.streamTenantId;

package/dist/engine/boot-validator/card-meta-overflow.d.ts

@@ -0,0 +1,10 @@
+import type { FeatureDefinition } from "../types/index.js";
+export type CardMetaOverflow = {
+    readonly feature: string;
+    readonly screen: string;
+    readonly location?: string;
+    readonly count: number;
+    readonly fields: readonly string[];
+};
+export declare function collectCardMetaOverflow(features: readonly FeatureDefinition[]): readonly CardMetaOverflow[];
+export declare function validateCardMetaOverflow(features: readonly FeatureDefinition[]): void;

package/dist/engine/boot-validator/card-meta-overflow.js

@@ -0,0 +1,95 @@
+import { CARD_META_MAX, cardColumnRoles } from "../../ui-types/card-column-roles.js";
+import { LIST_ROW_META_COLUMNS } from "../../ui-types/list-row-meta.js";
+import { parseRefTarget } from "../parse-ref-target.js";
+import { normalizeListColumn } from "../screen-helpers.js";
+// Mirrors the type resolution of headless computeListViewModel; only the
+// "select" outcome matters for the card status role.
+function resolveColumnType(spec, storedType, entity) {
+    const col = normalizeListColumn(spec);
+    if (col.refEntity !== undefined && (storedType === undefined || storedType === "text")) {
+        return "reference";
+    }
+    if (storedType !== undefined)
+        return storedType;
+    const derived = entity?.derivedFields?.[col.field];
+    if (derived !== undefined)
+        return derived.valueType;
+    return LIST_ROW_META_COLUMNS[col.field] ?? "text";
+}
+function countOverflow(feature, screen, location, columns, storedTypeOf, entity) {
+    const cardColumns = columns.map((spec) => {
+        const col = normalizeListColumn(spec);
+        return {
+            field: col.field,
+            type: resolveColumnType(spec, storedTypeOf(col.field), entity),
+            renderer: col.renderer,
+            hideOnNarrow: col.hideOnNarrow,
+        };
+    });
+    const { meta } = cardColumnRoles(cardColumns);
+    if (meta.length <= CARD_META_MAX)
+        return undefined;
+    return {
+        feature: feature.name,
+        screen,
+        ...(location !== undefined && { location }),
+        count: meta.length,
+        fields: meta.map((col) => col.field),
+    };
+}
+function relatedListOverflow(features, feature, screen, location, section) {
+    let source;
+    if (section.entity !== undefined) {
+        const target = parseRefTarget(section.entity, feature.name);
+        source = features.find((f) => f.name === target.featureName)?.entities?.[target.entityName];
+    }
+    const synthesizedTypes = new Map(section.columns.map((spec) => {
+        const col = normalizeListColumn(spec);
+        return [col.field, col.valueType ?? "text"];
+    }));
+    return countOverflow(feature, screen, location, section.columns, (field) => source?.fields[field]?.type ?? synthesizedTypes.get(field), source);
+}
+// Every declaration whose columns the narrow layout draws as a DataTable card.
+// Dashboard list panels have their own table and are not covered.
+export function collectCardMetaOverflow(features) {
+    const found = [];
+    const add = (overflow) => {
+        if (overflow !== undefined)
+            found.push(overflow);
+    };
+    for (const feature of features) {
+        for (const screen of Object.values(feature.screens)) {
+            if (screen.type === "entityList") {
+                const entity = feature.entities?.[screen.entity];
+                add(countOverflow(feature, screen.id, undefined, screen.columns, (field) => entity?.fields[field]?.type, entity));
+                if (screen.expandableRow !== undefined) {
+                    add(relatedListOverflow(features, feature, screen.id, `expandableRow "${screen.expandableRow.title}"`, screen.expandableRow));
+                }
+            }
+            else if (screen.type === "projectionList") {
+                // The projection shim types every column "text"; only refEntity changes it.
+                add(countOverflow(feature, screen.id, undefined, screen.columns, () => "text", undefined));
+            }
+            else if (screen.type === "projectionDetail") {
+                const isTabs = screen.layout.mode === "tabs";
+                for (const section of screen.layout.sections) {
+                    if (!("kind" in section) || section.kind !== "relatedList")
+                        continue;
+                    const location = isTabs
+                        ? `tab "${section.id ?? section.title}" section "${section.title}"`
+                        : `section "${section.title}"`;
+                    add(relatedListOverflow(features, feature, screen.id, location, section));
+                }
+            }
+        }
+    }
+    return found;
+}
+export function validateCardMetaOverflow(features) {
+    const overflows = collectCardMetaOverflow(features);
+    // skip: nothing overflows, so there is nothing to report
+    if (overflows.length === 0)
+        return;
+    const lines = overflows.map((o) => `  - Feature "${o.feature}" screen "${o.screen}"${o.location !== undefined ? ` ${o.location}` : ""}: ${o.count} meta columns (${o.fields.join(", ")})`);
+    throw new Error(`List cards show at most ${CARD_META_MAX} meta columns (all columns except title, status select and hideOnNarrow ones); more would be cut off on narrow screens:\n${lines.join("\n")}\nReduce each to ${CARD_META_MAX} columns or mark the others hideOnNarrow: true.`);
+}

package/dist/engine/boot-validator/entity-handler.js

@@ -710,11 +710,12 @@ function assertNoSelectOptionsQuery(field, path, featureName) {
 export function validateEntitySelectAvailabilityQuery(feature, queryHandlers) {
     for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
         for (const [fieldName, field] of Object.entries(entity.fields)) {
-            if (field.type !== "select" || field.optionsAvailabilityQuery === undefined)
+            if ((field.type !== "select" && field.type !== "multiSelect") ||
+                field.optionsAvailabilityQuery === undefined)
                 continue;
             const query = field.optionsAvailabilityQuery;
             if (query.length === 0 || !queryHandlers.has(query)) {
-                throw new Error(`[Feature ${feature.name}] Select field "${fieldName}" on entity "${entityName}" ` +
+                throw new Error(`[Feature ${feature.name}] ${field.type === "select" ? "Select" : "MultiSelect"} field "${fieldName}" on entity "${entityName}" ` +
                     `declares optionsAvailabilityQuery "${query}" which is not a registered query-handler. ` +
                     `Check the QN spelling (expected "<feature>:query:<short>") and that the handler ` +
                     `is declared via r.queryHandler(...).`);

package/dist/engine/boot-validator/index.d.ts

@@ -1,5 +1,6 @@
 import type { EnvelopeCipher } from "../../secrets/envelope-cipher.js";
 import type { FeatureDefinition } from "../types/index.js";
+export { type CardMetaOverflow, collectCardMetaOverflow } from "./card-meta-overflow.js";
 export { validateAppCustomScreenWriteQns } from "./custom-screen-write-qns.js";
 export { collectWriteHandlerQns } from "./nav.js";
 export { SECURITY_BASELINE_FEATURE_NAMES } from "./security-baseline.js";

package/dist/engine/boot-validator/index.js

@@ -7,6 +7,7 @@ import { warnOnUniqueAccessRoles } from "./access-roles.js";
 import { validateActionWiring, validateFieldWiring } from "./action-wiring.js";
 import { validateApiExposureMatching, validateExtensionUsages } from "./api-ext.js";
 import { validateFeatureBootChecks } from "./boot-check.js";
+import { validateCardMetaOverflow } from "./card-meta-overflow.js";
 import { validateCircularDeps, validateConfigKeyAllowPerRequest, validateConfigKeyBacking, validateConfigKeyBounds, validateConfigKeyComputed, validateConfigKeyOptionsQuery, validateConfigKeyPiiEncrypted, validateConfigKeyRequired, validateConfigReads, warnOnToggleableDependencies, } from "./config-deps.js";
 import { collectDetailForScreens } from "./detail-screens.js";
 import { validateDerivedFieldCollisions, validateEmbeddedFields, validateEncryptedFields, validateEntityIndexes, validateEntitySelectAvailabilityQuery, validateEntitySelectConditionalOptions, validateEntitySelectOptionsQuery, validateExtendSchemaCollisions, validateExtensionPreSaveWiring, validateFileFields, validateHandlerAccess, validateImageVariants, validateLocatedTimestamps, validateMultiSelectFields, validateMultiStreamProjections, validateReferenceFields, validateSearchableFieldReadAccess, validateTransitions, } from "./entity-handler.js";
@@ -29,10 +30,11 @@ import { validateExtensionSelectorPanels } from "./selector-owner-panels.js";
 import { validateTransferGraph } from "./transfer-graph.js";
 import { validateSubmitPrefilledHiddenFields } from "./url-prefill-fields.js";
 import { collectWorkspaceQns, resolveNavAllowlist, validateDefaultWorkspaceUniqueness, validateWorkspaces, } from "./workspaces.js";
-export { validateAppCustomScreenWriteQns } from "./custom-screen-write-qns.js";
 // Re-export: wird von run-dev-app.ts benötigt um Write-Handler-QNs
 // an den Codegen zu übergeben. Nicht Teil von validateBoot, aber
 // dieselbe Extraktionslogik.
+export { collectCardMetaOverflow } from "./card-meta-overflow.js";
+export { validateAppCustomScreenWriteQns } from "./custom-screen-write-qns.js";
 export { collectWriteHandlerQns } from "./nav.js";
 export { SECURITY_BASELINE_FEATURE_NAMES } from "./security-baseline.js";
 export { MAX_TRANSFER_DEPTH } from "./transfer-graph.js";
@@ -217,6 +219,7 @@ export function validateBoot(rawFeatures, options) {
     validateI18nSurfaceKeys(features);
     validateEntityListScreens(features);
     validateSubmitPrefilledHiddenFields(features);
+    validateCardMetaOverflow(features);
     // Must run before validateProjectionListScreens: an unresolvable query
     // there is silently treated as "capability absent" and surfaces as a
     // misleading "no search parameter in its Zod schema" error instead of

package/dist/engine/boot-validator/query-refs.js

@@ -45,6 +45,9 @@ function checkDashboardQueryRefs(queryHandlers, featureName, screenId, screen) {
 }
 function checkFormFieldQueryRefs(queryHandlers, featureName, screenId, screenType, fields) {
     for (const [fieldName, field] of Object.entries(fields)) {
+        if (field.type === "multiSelect" && field.optionsAvailabilityQuery !== undefined) {
+            checkQueryRef(queryHandlers, field.optionsAvailabilityQuery, () => `[Feature ${featureName}] Screen "${screenId}" (${screenType}) multiSelect field "${fieldName}" optionsAvailabilityQuery`);
+        }
         if (field.type !== "select")
             continue;
         if (field.optionsQuery !== undefined) {

package/dist/engine/boot-validator/screens.js

@@ -550,6 +550,11 @@ function validateFormSelectOptions(featureName, screenId, context, fieldName, fd
             throw new Error(`${where} has optionsQueryPayload without optionsQuery`);
         }
     }
+    else if (fdef.type === "multiSelect" && fdef.optionsAvailabilityQuery !== undefined) {
+        if (fdef.optionsAvailabilityQuery.length === 0) {
+            throw new Error(`[Feature ${featureName}] Screen "${screenId}" (${context}) multiSelect field "${fieldName}" has an empty optionsAvailabilityQuery`);
+        }
+    }
 }
 // Fail-closed currency-source gate (fw#2839), the runtime half of the
 // narrowed `FormFieldDefinition` — an untyped JS consumer has no compiler to

package/dist/engine/boot-validator.d.ts

@@ -1 +1 @@
-export { collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, type ValidateBootOptions, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator/index.js";
+export { type CardMetaOverflow, collectCardMetaOverflow, collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, type ValidateBootOptions, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator/index.js";

package/dist/engine/boot-validator.js

@@ -1 +1 @@
-export { collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator/index.js";
+export { collectCardMetaOverflow, collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator/index.js";

package/dist/engine/index.d.ts

@@ -3,7 +3,7 @@ export { hasAccess } from "./access.js";
 export { isPrincipalStatusPlugin, isTenantLifecycleStatusPlugin, type PrincipalProfile, type PrincipalStatus, type PrincipalStatusPlugin, TENANT_TEARDOWN_STATUSES, type TenantLifecycleStatusPlugin, } from "./active-membership.js";
 export { PII_DIRECT_NAME_HINTS, PII_USER_OWNED_NAME_HINTS, PII_USER_REFERENCE_NAME_HINTS, } from "./boot-validator/entity-handler.js";
 export { entityHasAnonymizableSubjectField } from "./boot-validator/pii-retention.js";
-export { collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, type ValidateBootOptions, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator.js";
+export { type CardMetaOverflow, collectCardMetaOverflow, collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, type ValidateBootOptions, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator.js";
 export { type BuildAppSchemaOptions, buildAppSchema } from "./build-app-schema.js";
 export type { ConfigFeatureSchema } from "./build-config-feature-schema.js";
 export { buildConfigFeatureSchema, SETTINGS_HUB_FEATURE, SETTINGS_HUB_WORKSPACE, } from "./build-config-feature-schema.js";

package/dist/engine/index.js

@@ -4,7 +4,7 @@ export { hasAccess } from "./access.js";
 export { isPrincipalStatusPlugin, isTenantLifecycleStatusPlugin, TENANT_TEARDOWN_STATUSES, } from "./active-membership.js";
 export { PII_DIRECT_NAME_HINTS, PII_USER_OWNED_NAME_HINTS, PII_USER_REFERENCE_NAME_HINTS, } from "./boot-validator/entity-handler.js";
 export { entityHasAnonymizableSubjectField } from "./boot-validator/pii-retention.js";
-export { collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator.js";
+export { collectCardMetaOverflow, collectWriteHandlerQns, MAX_TRANSFER_DEPTH, SECURITY_BASELINE_FEATURE_NAMES, validateAppCustomScreenWriteQns, validateBoot, } from "./boot-validator.js";
 export { buildAppSchema } from "./build-app-schema.js";
 export { buildConfigFeatureSchema, SETTINGS_HUB_FEATURE, SETTINGS_HUB_WORKSPACE, } from "./build-config-feature-schema.js";
 export { buildTarget } from "./build-target.js";

package/dist/files/file-ref-entity.d.ts

@@ -4,6 +4,7 @@ export declare const fileRefEntity: import("@cosmicdrift/kumiko-types/fields").E
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -26,6 +27,7 @@ export declare const fileRefEntity: import("@cosmicdrift/kumiko-types/fields").E
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -48,6 +50,7 @@ export declare const fileRefEntity: import("@cosmicdrift/kumiko-types/fields").E
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -82,6 +85,7 @@ export declare const fileRefEntity: import("@cosmicdrift/kumiko-types/fields").E
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -104,6 +108,7 @@ export declare const fileRefEntity: import("@cosmicdrift/kumiko-types/fields").E
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -126,6 +131,7 @@ export declare const fileRefEntity: import("@cosmicdrift/kumiko-types/fields").E
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;

package/dist/files/file-ref-table.d.ts

@@ -4,6 +4,7 @@ export declare const fileRefsTable: import("../db/table-builder.js").EntityTable
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -26,6 +27,7 @@ export declare const fileRefsTable: import("../db/table-builder.js").EntityTable
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -48,6 +50,7 @@ export declare const fileRefsTable: import("../db/table-builder.js").EntityTable
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -82,6 +85,7 @@ export declare const fileRefsTable: import("../db/table-builder.js").EntityTable
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -104,6 +108,7 @@ export declare const fileRefsTable: import("../db/table-builder.js").EntityTable
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -126,6 +131,7 @@ export declare const fileRefsTable: import("../db/table-builder.js").EntityTable
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;

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

@@ -283,6 +283,7 @@ export function requiredKeysFromScreen(featureName, screen, options = {}) {
             pushKey(out, mint.reveal.title);
             pushKey(out, mint.reveal.warning);
             pushKey(out, mint.reveal.confirmLabel);
+            pushKey(out, mint.reveal.acknowledge);
             for (const revealField of mint.reveal.fields) {
                 pushKey(out, revealField.label);
             }

package/dist/pipeline/system-hooks.js

@@ -37,15 +37,19 @@ import { InternalError } from "../errors/index.js";
 // call per tenant instead of one round-trip per event; handler stays the
 // per-event fallback the dispatcher falls back to when a batch throws.
 export const SEARCH_CONSUMER_NAME = "system:consumer:search";
+// An executor update with includeDeleted leaves the row deleted; indexing it would make it findable again.
+function isUpdateOfSoftDeletedRow(event, verb) {
+    return (verb === "updated" && reconstructStateForSearch(event.payload, "updated")["isDeleted"] === true);
+}
 // Resolves what one event implies for the search index, without touching
 // the adapter — same decision tree the old per-event handler ran inline.
 async function resolveSearchOperation(event, ctx, registry) {
     const entityName = event.aggregateType;
     const verb = event.type.split(".").pop();
     const tenantId = event.tenantId;
-    // skip: delete/forgotten remove the index entry — reconstruct only
-    // makes sense for created/updated/restored (field data in payload).
-    if (verb === "deleted" || verb === "forgotten") {
+    // skip: delete/forgotten (and an update on a still soft-deleted row) remove the
+    // index entry — reconstruct only makes sense for live created/updated/restored.
+    if (verb === "deleted" || verb === "forgotten" || isUpdateOfSoftDeletedRow(event, verb)) {
         return { kind: "remove", tenantId, entityType: entityName, entityId: event.aggregateId };
     }
     let state;

package/dist/testing/shared-entities.d.ts

@@ -4,6 +4,7 @@ export declare const sharedWidgetEntity: import("@cosmicdrift/kumiko-types/field
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -28,6 +29,7 @@ export declare const sharedWidgetTable: import("../db/table-builder.js").EntityT
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -52,6 +54,7 @@ export declare const sharedUserEntity: import("@cosmicdrift/kumiko-types/fields"
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -74,6 +77,7 @@ export declare const sharedUserEntity: import("@cosmicdrift/kumiko-types/fields"
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -96,6 +100,7 @@ export declare const sharedUserEntity: import("@cosmicdrift/kumiko-types/fields"
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -123,6 +128,7 @@ export declare const sharedUserTable: import("../db/table-builder.js").EntityTab
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -145,6 +151,7 @@ export declare const sharedUserTable: import("../db/table-builder.js").EntityTab
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -167,6 +174,7 @@ export declare const sharedUserTable: import("../db/table-builder.js").EntityTab
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -194,6 +202,7 @@ export declare const sharedItemEntity: import("@cosmicdrift/kumiko-types/fields"
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;
@@ -237,6 +246,7 @@ export declare const sharedItemTable: import("../db/table-builder.js").EntityTab
         readonly description?: string;
         readonly maxLength?: number;
         readonly minLength?: number;
+        readonly autoComplete?: string;
         readonly required?: boolean;
         readonly searchable?: boolean;
         readonly sortable?: boolean;

package/dist/ui-types/card-column-roles.d.ts

@@ -0,0 +1,14 @@
+export declare const CARD_META_MAX = 3;
+export type CardRoleColumn = {
+    readonly field: string;
+    readonly highlighted?: boolean;
+    readonly type?: string;
+    readonly renderer?: unknown;
+    readonly hideOnNarrow?: boolean;
+};
+export type CardColumnRoles<C extends CardRoleColumn> = {
+    readonly title: C | undefined;
+    readonly status: C | undefined;
+    readonly meta: readonly C[];
+};
+export declare function cardColumnRoles<C extends CardRoleColumn>(columns: readonly C[]): CardColumnRoles<C>;

package/dist/ui-types/card-column-roles.js

@@ -0,0 +1,9 @@
+export const CARD_META_MAX = 3;
+// One rule for the narrow-layout list card, shared by the renderer and the
+// boot validator so the validator counts exactly what the card would draw.
+export function cardColumnRoles(columns) {
+    const title = columns.find((col) => col.highlighted === true) ?? columns[0];
+    const status = columns.find((col) => col !== title && col.type === "select" && col.renderer === undefined);
+    const meta = columns.filter((col) => col !== title && col !== status && col.hideOnNarrow !== true);
+    return { title, status, meta };
+}

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

@@ -16,6 +16,8 @@ export type { TreeAction, TreeNode, TreeNodeState } from "../engine/types/tree-n
 export type { WorkspaceDefinition } from "../engine/types/workspace.js";
 export { ACTION_FORM_ENTITY, handlerFieldLabelKey, handlerTitleKey, PROJECTION_DETAIL_ENTITY, WRITE_FORM_SECTION_ENTITY, } from "../i18n/required-surface-keys.js";
 export type { AppSchema, FeatureSchema, QualifiedContentCollection, WorkspaceSchema, } from "./app-schema.js";
+export type { CardColumnRoles, CardRoleColumn } from "./card-column-roles.js";
+export { CARD_META_MAX, cardColumnRoles } from "./card-column-roles.js";
 export { type Formality, formalLocaleTag } from "./formality.js";
 export type { ListRowMetaColumnType, ListRowMetaReference, ReferenceLookupSource, SystemReferenceLabel, } from "./list-row-meta.js";
 export { LIST_ROW_META_COLUMNS, LIST_ROW_META_REFERENCES, REFERENCE_LOOKUP_SOURCES, SYSTEM_REFERENCE_LABELS, } from "./list-row-meta.js";

package/dist/ui-types/index.js

@@ -26,6 +26,7 @@ export { availableSelectOptions, evalFieldCondition, explicitListScreenId, findU
 export { isOpenToAllGranted, isUiAccessGranted } from "../engine/types/handlers.js";
 export { metricField, relatedListGroupHeaderLabel, relatedListGroupKey, } from "../engine/types/screen.js";
 export { ACTION_FORM_ENTITY, handlerFieldLabelKey, handlerTitleKey, PROJECTION_DETAIL_ENTITY, WRITE_FORM_SECTION_ENTITY, } from "../i18n/required-surface-keys.js";
+export { CARD_META_MAX, cardColumnRoles } from "./card-column-roles.js";
 export { formalLocaleTag } from "./formality.js";
 export { LIST_ROW_META_COLUMNS, LIST_ROW_META_REFERENCES, REFERENCE_LOOKUP_SOURCES, SYSTEM_REFERENCE_LABELS, } from "./list-row-meta.js";
 export { resolveTranslationValue, translationValueOtherText, } from "./plural.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.356.0",
+  "version": "0.357.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>",
@@ -210,8 +210,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-http": "0.356.0",
-    "@cosmicdrift/kumiko-types": "0.356.0",
+    "@cosmicdrift/kumiko-http": "0.357.0",
+    "@cosmicdrift/kumiko-types": "0.357.0",
     "bullmq": "^5.76.7",
     "bun-types": "^1.3.13",
     "hono": "^4.13.1",
@@ -227,7 +227,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.356.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.357.0",
     "bun-types": "^1.3.13",
     "pino-pretty": "^13.1.3"
   },

package/src/changes.json

@@ -1,4 +1,15 @@
 [
+  {
+    "version": "0.357.0",
+    "type": "improvement",
+    "title": "Executor update accepts includeDeleted for soft-deleted rows",
+    "detail": "`executor.update(payload, user, db, { includeDeleted: true })` loads the row without the soft-delete filter (the tenant filter stays), so server code can move a trashed row together with its parent (for example a team change) and a later restore lands consistently. The row stays deleted. The default is unchanged (NotFound) and the generic HTTP update handler never sets the option. The projection apply was already unfiltered by `isDeleted`, so live and rebuild agree. The search consumer treats an update on a soft-deleted row as a removal, so the moved row does not reappear in search."
+  },
+  {
+    "version": "0.357.0",
+    "type": "improvement",
+    "title": "Boot validation covers multiSelect optionsAvailabilityQuery on entity and screen fields"
+  },
   {
     "version": "0.356.0",
     "type": "improvement",