@cosmicdrift/kumiko-types 0.393.0 → 0.395.0

package/dist/config.d.ts

@@ -144,6 +144,7 @@ export type JobHandlerFn = (payload: Record<string, unknown>, context: JobContex
 export type JobTrigger = {
     readonly on: import("./handlers.ts").NameOrRef | readonly import("./handlers.ts").NameOrRef[];
     readonly where?: Readonly<Record<string, string | number | boolean>>;
+    readonly catchUp?: boolean;
 } | {
     readonly cron: string;
     readonly tz?: string;

package/dist/define-handler.d.ts

@@ -1,9 +1,9 @@
 import type * as z from "zod";
 import type { ZodType } from "zod";
 import type { KumikoEventTypeMap } from "./event-type-map.ts";
-import type { AccessRule, AgentHandlerHints, BeforeTransactionPhase, EscapeHatchDeclaration, HandlerContext, PayloadRateLimitOption, PreparedWriteEvent, PreTransactionReservation, QueryEvent, RateLimitDeclaration, WriteHandlerTransactionMode, WriteResult } from "./handlers.ts";
+import type { AccessRule, AgentHandlerHints, BeforeTransactionPhase, BeforeTransactionWhenNested, EscapeHatchDeclaration, HandlerContext, PayloadRateLimitOption, PreparedOrSkipped, PreparedWriteEvent, PreTransactionReservation, QueryEvent, RateLimitDeclaration, WriteHandlerTransactionMode, WriteResult } from "./handlers.ts";
 import type { PipelineDef } from "./step.ts";
-export type WriteHandlerDefinition<TName extends string = string, TSchema extends ZodType = ZodType, TData = unknown, TMap extends object = KumikoEventTypeMap, TPrepared = undefined> = {
+export type WriteHandlerDefinition<TName extends string = string, TSchema extends ZodType = ZodType, TData = unknown, TMap extends object = KumikoEventTypeMap, TPrepared = undefined, TWhenNested extends BeforeTransactionWhenNested | undefined = undefined> = {
     readonly name: TName;
     readonly schema: TSchema;
     readonly access: AccessRule;
@@ -20,12 +20,13 @@ export type WriteHandlerDefinition<TName extends string = string, TSchema extend
     readonly escapeHatch?: EscapeHatchDeclaration;
     readonly reserveBeforeTransaction?: PreTransactionReservation;
     readonly beforeTransaction?: BeforeTransactionPhase<z.infer<TSchema>, TPrepared>;
+    readonly beforeTransactionWhenNested?: TWhenNested;
     readonly tenantlessAnonymous?: boolean;
     readonly transaction?: WriteHandlerTransactionMode;
-    readonly handler: (event: PreparedWriteEvent<z.infer<TSchema>, TPrepared>, context: HandlerContext<TMap>) => Promise<WriteResult<TData>>;
+    readonly handler: (event: PreparedWriteEvent<z.infer<TSchema>, PreparedOrSkipped<TPrepared, TWhenNested>>, context: HandlerContext<TMap>) => Promise<WriteResult<TData>>;
     readonly perform?: PipelineDef<z.infer<TSchema>, TData>;
 };
-export type WriteHandlerInput<TName extends string = string, TSchema extends ZodType = ZodType, TData = unknown, TMap extends object = KumikoEventTypeMap, TPrepared = undefined> = {
+export type WriteHandlerInput<TName extends string = string, TSchema extends ZodType = ZodType, TData = unknown, TMap extends object = KumikoEventTypeMap, TPrepared = undefined, TWhenNested extends BeforeTransactionWhenNested | undefined = undefined> = {
     readonly name: TName;
     readonly schema: TSchema;
     readonly access: AccessRule;
@@ -40,10 +41,11 @@ export type WriteHandlerInput<TName extends string = string, TSchema extends Zod
     readonly escapeHatch?: EscapeHatchDeclaration;
     readonly reserveBeforeTransaction?: PreTransactionReservation;
     readonly beforeTransaction?: BeforeTransactionPhase<z.infer<TSchema>, TPrepared>;
+    readonly beforeTransactionWhenNested?: TWhenNested;
     readonly tenantlessAnonymous?: boolean;
     readonly transaction?: WriteHandlerTransactionMode;
 } & ({
-    readonly handler: (event: PreparedWriteEvent<z.infer<TSchema>, TPrepared>, context: HandlerContext<TMap>) => Promise<WriteResult<TData>>;
+    readonly handler: (event: PreparedWriteEvent<z.infer<TSchema>, PreparedOrSkipped<TPrepared, TWhenNested>>, context: HandlerContext<TMap>) => Promise<WriteResult<TData>>;
     readonly perform?: never;
 } | {
     readonly perform: PipelineDef<z.infer<TSchema>, TData>;

package/dist/feature-registrar.d.ts

@@ -8,7 +8,7 @@ import type { KumikoEventTypeMap } from "./event-type-map.ts";
 import type { ExtensionOptionsArgs, ExtensionOptionsFor } from "./extension-options-map.ts";
 import type { BootCheckFn, MetricOptions, SecretKeyHandle, SecretNamespaceHandle, SecretNamespaceOptions, SecretOptions, StoreTableOptions, UiHints } from "./feature.ts";
 import type { EntityDefinition } from "./fields.ts";
-import type { AccessRule, AuthClaimsFn, ClaimKeyHandle, ClaimKeyType, DeclarativeEventMigration, EntityRef, EscapeHatchDeclaration, EventDef, EventPiiStance, EventUpcastFn, HandlerRef, NameOrRef, QualifiedEventName, RateLimitDeclaration, StreamHandlerFn } from "./handlers.ts";
+import type { AccessRule, AuthClaimsFn, BeforeTransactionWhenNested, ClaimKeyHandle, ClaimKeyType, DeclarativeEventMigration, EntityRef, EscapeHatchDeclaration, EventDef, EventPiiStance, EventUpcastFn, HandlerRef, NameOrRef, QualifiedEventName, RateLimitDeclaration, StreamHandlerFn } from "./handlers.ts";
 import type { HookPhase, PostDeleteHookFn, PostQueryHookFn, PostSaveHookFn, PreDeleteHookFn, PreSaveHookFn, SearchPayloadContributorFn, ValidationHookFn } from "./hooks.ts";
 import type { HttpRouteDefinition } from "./http-route.ts";
 import type { ContentCollectionDefinition, NavDefinition } from "./nav.ts";
@@ -109,7 +109,7 @@ export type FeatureRegistrar<TFeature extends string = string> = {
     /**
      * @example r.writeHandler({ name: "note:archive", schema, handler, access: { roles: ["User"] } });
      */
-    writeHandler<TName extends string, TSchema extends ZodType, TPrepared = undefined>(def: WriteHandlerDefinition<TName, TSchema, unknown, KumikoEventTypeMap, TPrepared>): HandlerRef;
+    writeHandler<TName extends string, TSchema extends ZodType, TPrepared = undefined, TWhenNested extends BeforeTransactionWhenNested | undefined = undefined>(def: WriteHandlerDefinition<TName, TSchema, unknown, KumikoEventTypeMap, TPrepared, TWhenNested>): HandlerRef;
     /**
      * @example r.queryHandler({ name: "note:list", schema, handler, access: { roles: ["User"] } });
      */

package/dist/feature.d.ts

@@ -201,6 +201,8 @@ export type Registry = {
     readonly features: ReadonlyMap<string, FeatureDefinition>;
     getFeature(name: string): FeatureDefinition | undefined;
     getEntity(name: string): EntityDefinition | undefined;
+    getReadModelEntity(name: string): EntityDefinition | undefined;
+    getReadModelEntityOwner(name: string): string | undefined;
     getAllEntities(): ReadonlyMap<string, EntityDefinition>;
     getWriteHandler(name: string): WriteHandlerDef | undefined;
     getQueryHandler(name: string): QueryHandlerDef | undefined;

package/dist/fields.d.ts

@@ -858,15 +858,13 @@ export type EntityDefinition<F extends FieldsMap = FieldsMap, T extends EntityTe
     readonly derivedFields?: DerivedFieldsMap;
     /** Optional free-text semantics for the AI agent manifest — see TextFieldDef.description. */
     readonly description?: string;
-    /**
-     * Opts this entity's rows into the `tenant-handover` bundled feature
-     *: a row-bound-grant-legitimated ownership change
-     * from an anonymous/public tenant to a freshly signed-up account's tenant.
-     * An entity reachable from a transfer's root — the root itself, or any
-     * entity whose `parentRef` names the root's type — that is NOT declared
-     * `transferable: true` makes the whole transfer fail with a named error
-     * instead of silently leaving that entity's rows behind.
-     */
+    /** Opts the rows into `tenant-handover`, a grant-legitimated move from an anonymous tenant to the
+     *  signed-up account's tenant. An entity reachable from a transfer's root (the root, or one whose
+     *  `parentRef` names the root's type) without `transferable: true` fails the whole transfer with
+     *  a named error instead of silently leaving its rows behind. */
     readonly transferable?: boolean;
+    /** Attached files are readable only through the record's detail query: the files feature's
+     *  privilegedRoles do not bypass it, the uploader check stays. */
+    readonly attachedFileAccess?: "record-only";
 };
 export {};

package/dist/handlers.d.ts

@@ -132,6 +132,7 @@ export type JobTriggerEvent = {
 };
 export type JobRunnerRef = {
     handleEvent(eventName: string, payload: Record<string, unknown>, user?: SessionUser, triggerEvent?: JobTriggerEvent): Promise<void>;
+    handleCatchUpEvent?(jobName: string, eventName: string, payload: Record<string, unknown>, user: SessionUser, triggerEvent: JobTriggerEvent): Promise<void>;
     dispatch?(jobName: string, payload: Record<string, unknown>, meta?: {
         readonly priority?: number;
         readonly jobId?: string;
@@ -261,10 +262,11 @@ export type AppContext = SharedContextFields & {
         readonly tenantId: TenantId;
     } | null;
     /** For job-handler calls triggered by an event
-     *  (`r.job` with `trigger: { on: ... }`): the name of the handler that
-     *  emitted the event. For multi-trigger jobs (`on: [...]`), this is the
-     *  only way for the handler to know which trigger fired. Cron and manual
-     *  jobs leave the field undefined. */
+     *  (`r.job` with `trigger: { on: ... }`): the qualified name of the event
+     *  that fired the trigger, e.g. `inbound-mail-foundation:event:inbound-message-received`.
+     *  For multi-trigger jobs (`on: [...]`), this is the only way for the
+     *  handler to know which trigger fired. Cron and manual jobs leave the
+     *  field undefined. */
     readonly triggerName?: string;
     /** Optional Geo→zone adapter. When set (via buildServer context or
      *  `runProdApp`/`runDevApp` `extraContext`), the dispatcher passes it to
@@ -550,6 +552,12 @@ export type BeforeTransactionResult<TPrepared = unknown> = {
 export type BeforeTransactionPhase<TPayload = unknown, TPrepared = unknown> = (event: WriteEvent<TPayload>, ctx: BeforeTransactionContext) => Promise<BeforeTransactionResult<TPrepared>>;
 /** `perCommand`: the handler runs without a transaction of its own. */
 export type WriteHandlerTransactionMode = "perCommand";
+/** `skip`: run as a nested write without the `beforeTransaction` phase. */
+export type BeforeTransactionWhenNested = "skip";
+/** The `prepared` type a handler sees: with `beforeTransactionWhenNested: "skip"` a nested run leaves it undefined. */
+export type PreparedOrSkipped<TPrepared, TWhenNested> = [TWhenNested] extends [
+    BeforeTransactionWhenNested
+] ? TPrepared | undefined : TPrepared;
 export type WriteHandlerDef = {
     readonly name: string;
     readonly schema: ZodType;
@@ -579,6 +587,11 @@ export type WriteHandlerDef = {
      *  `ctx.tenants.writeTarget` is available but read-only here: its db denies writes for the own and a
      *  foreign tenant alike (a foreign tenant stays gated by the SystemAdmin check). */
     readonly beforeTransaction?: BeforeTransactionPhase;
+    /** `"skip"`: a nested ctx.dispatch.write of this handler runs without the beforeTransaction phase
+     *  (`event.prepared` is undefined) and without a reservation, so the handler does that work inside
+     *  its own transaction. Top-level commands still run the phase. Requires beforeTransaction; not
+     *  combinable with reserveBeforeTransaction or transaction: "perCommand". */
+    readonly beforeTransactionWhenNested?: BeforeTransactionWhenNested;
     /** `"perCommand"`: the handler runs without a transaction of its own. Every ctx.dispatch.write/writeAs it
      *  issues runs as its own top-level command with its own transaction and afterCommit hooks;
      *  ctx.db writes and event appends throw. It cannot run as a nested write or inside a

package/dist/kebab-case.d.ts

@@ -0,0 +1 @@
+export declare function toKebab(input: string): string;

package/dist/kebab-case.js

@@ -0,0 +1,14 @@
+// Convert camelCase or dot.separated strings to kebab-case.
+// "task.create" → "task-create"
+// "ticketAssigned" → "ticket-assigned"
+// "billing-period.create" → "billing-period-create"
+// "monthlyReport" → "monthly-report"
+// Already kebab-case → unchanged
+// Colons are preserved: "task:create" → "task:create"
+export function toKebab(input) {
+    return input
+        .replace(/\./g, "-") // dots → dashes
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2") // consecutive uppercase: SSEBroadcast → SSE-Broadcast
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2") // camelCase boundaries: ticketAssigned → ticket-Assigned
+        .toLowerCase();
+}

package/dist/nav.d.ts

@@ -18,7 +18,7 @@ export type NavDefinition = {
     readonly workspaces?: readonly string[];
 };
 /** Client editor format for r.contentCollection() — not template body storage formats. */
-export type ContentEditorFormat = "plain" | "rich" | "markdown" | "document";
+export type ContentEditorFormat = "plain" | "document";
 export type ContentCollectionDefinition = {
     readonly id: string;
     readonly kind: string;

package/dist/screen-action-form.d.ts

@@ -4,6 +4,7 @@ import type { IconKey } from "./nav-icon.ts";
 import type { ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ScreenVisibility } from "./screen-dashboard.ts";
 import type { EditLayout } from "./screen-entity-edit.ts";
+import type { ScreenFallback } from "./screen-fallback.ts";
 /** A form field computed from other fields of the same form. `listSum` adds one
  *  numeric cell over all rows of an embedded list field; its `whenEmpty`
  *  fallback applies while the list has no rows (it must not be a `listSum`). */
@@ -37,7 +38,7 @@ export type ActionFormScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     /** Derived by buildAppSchema — see EntityEditScreenDefinition.urlPrefillFields. */
     readonly urlPrefillFields?: readonly string[];
     /** Derived by buildAppSchema from the `excludedFields` of the called `handler`; the form
@@ -274,7 +275,7 @@ export type SecretMintScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     /** Derived by buildAppSchema — see EntityEditScreenDefinition.urlPrefillFields. */
     readonly urlPrefillFields?: readonly string[];
     /** Submit is enabled without edits: values seeded from navigate `params` count as the

package/dist/screen-custom-config.d.ts

@@ -3,6 +3,7 @@ import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ScreenVisibility } from "./screen-dashboard.ts";
 import type { EditLayout } from "./screen-entity-edit.ts";
+import type { ScreenFallback } from "./screen-fallback.ts";
 export type CustomScreenRoute = {
     readonly path: string;
     readonly component: PlatformComponent;
@@ -32,7 +33,7 @@ export type CustomScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
 };
 export type ConfigEditScreenDefinition = {
     readonly id: string;
@@ -50,7 +51,7 @@ export type ConfigEditScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     /** scope for config:write:set calls. Must match the scope declaration of
      *  the keys referenced in `configKeys` — the boot validator checks that
      *  against the registry. */
@@ -103,7 +104,7 @@ export type SecretsEditScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     /** field id -> qualified secret name (`<feature>:secret:<kebab>`). */
     readonly secretKeys: Readonly<Record<string, string>>;
     /** field id -> i18n key for the label. */

package/dist/screen-dashboard.d.ts

@@ -1,6 +1,7 @@
 import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ListColumnSpec, RowAction } from "./screen-entity-list.ts";
+import type { ScreenFallback } from "./screen-fallback.ts";
 /** Text a query handler can send untranslated: the renderer translates it. */
 export type DashboardI18nText = {
     readonly i18nKey: string;
@@ -331,7 +332,7 @@ export type DashboardScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     readonly panels: readonly DashboardPanelDefinition[];
     /** Binds the dashboard to one record via a URL search param, see DashboardRecordBinding. */
     readonly record?: DashboardRecordBinding;

package/dist/screen-entity-edit.d.ts

@@ -6,6 +6,7 @@ import type { FieldRenderer, PlatformComponent, ScreenNavSugar, ScreenSlots } fr
 import type { ActionFormRedirect } from "./screen-action-form.ts";
 import type { ScreenVisibility } from "./screen-dashboard.ts";
 import type { ListColumnSpec, ListSortSpec, RelatedListToolbarAction, RowAction, RowActionMode, RowFieldExtractor } from "./screen-entity-list.ts";
+import type { ScreenFallback } from "./screen-fallback.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
 import type { ListTableGrouping, ListTableOptions } from "./screen-list-table.ts";
 import type { ListFacetSpec } from "./screen-projection.ts";
@@ -391,7 +392,7 @@ export type EntityEditScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     /** Derived by buildAppSchema from the navigate `params` targeting this
      *  screen — the only URL query keys the create form prefills. An authored
      *  value is overwritten. */

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

@@ -3,9 +3,10 @@ import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { IconKey } from "./nav-icon.ts";
 import type { FieldRenderer, PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ActionFormRedirect } from "./screen-action-form.ts";
-import type { ScreenVisibility } from "./screen-dashboard.ts";
+import type { DashboardPanelVisibility, ScreenVisibility } from "./screen-dashboard.ts";
 import type { ListEmptyStateSpec } from "./screen-entity-edit.ts";
 import type { EntityListExpandableRow } from "./screen-expandable-row.ts";
+import type { ScreenFallback } from "./screen-fallback.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
 import type { ListColumnPin, ListTableOptions } from "./screen-list-table.ts";
 export type ListColumnSpec = string | {
@@ -274,7 +275,7 @@ export type RowActionClientAction = {
      *  (default `kumiko.clientAction.success`). */
     readonly successMessage?: string;
 };
-export type ToolbarAction = {
+export type ToolbarAction = ({
     readonly kind: "navigate";
     readonly id: string;
     readonly label: string;
@@ -319,6 +320,11 @@ export type ToolbarAction = {
     readonly title?: string;
     /** Line under the drawer heading (i18n key). */
     readonly subtitle?: string;
+}) & {
+    /** Shown only while the query's `field` equals `eq` (live, empty payload). Hidden while the
+     *  query loads and when it fails. Named like the screen and panel gates because it is
+     *  query-based; a list toolbar has no record to evaluate a row condition against. */
+    readonly visibleWhen?: DashboardPanelVisibility;
 };
 export type RelatedListToolbarAction = (Extract<ToolbarAction, {
     readonly kind: "navigate";
@@ -390,7 +396,7 @@ export type EntityListScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     readonly entity: string;
     /** Short screen id (same feature) the create button opens instead of the entity's default edit screen. */
     readonly createScreen?: string;

package/dist/screen-fallback.d.ts

@@ -0,0 +1,16 @@
+/** Why a screen gate is not open. `hidden`: the gate query answered but the condition is unmet
+ *  (also a missing route id with `idParam`); `forbidden`/`notFound`: the gate query failed with
+ *  HTTP 403/404; `error`: any other failure. */
+export type ScreenFallbackReason = "hidden" | "forbidden" | "notFound" | "error";
+/** Per-reason fallback screens (same-feature short id or cross-feature QN). A reason without an
+ *  entry gets the default notice. At least one key is required. */
+export type ScreenFallbackByReason = {
+    readonly [Reason in ScreenFallbackReason]?: string;
+};
+/** Screen-level `fallback`: one screen for every reason, or one per reason. */
+export type ScreenFallback = string | ScreenFallbackByReason;
+export declare const SCREEN_FALLBACK_REASONS: readonly ScreenFallbackReason[];
+/** The fallback screen for one reason, or undefined when the map has no entry for it. */
+export declare function fallbackTargetFor(fallback: ScreenFallback, reason: ScreenFallbackReason): string | undefined;
+/** Every screen a fallback can render, in reason order. */
+export declare function fallbackTargets(fallback: ScreenFallback): readonly string[];

package/dist/screen-fallback.js

@@ -0,0 +1,16 @@
+export const SCREEN_FALLBACK_REASONS = [
+    "hidden",
+    "forbidden",
+    "notFound",
+    "error",
+];
+/** The fallback screen for one reason, or undefined when the map has no entry for it. */
+export function fallbackTargetFor(fallback, reason) {
+    return typeof fallback === "string" ? fallback : fallback[reason];
+}
+/** Every screen a fallback can render, in reason order. */
+export function fallbackTargets(fallback) {
+    if (typeof fallback === "string")
+        return [fallback];
+    return SCREEN_FALLBACK_REASONS.flatMap((reason) => fallback[reason] ?? []);
+}

package/dist/screen-projection.d.ts

@@ -5,6 +5,7 @@ import type { FormatSpec, PlatformComponent, ScreenNavSugar, ScreenSlots } from
 import type { DashboardStatTone, ScreenVisibility } 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 { ScreenFallback } from "./screen-fallback.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
 import type { ListTableOptions } from "./screen-list-table.ts";
 export type ListFacetSpec = {
@@ -66,7 +67,7 @@ export type ProjectionListScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     readonly query: string;
     readonly columns: readonly ListColumnSpec[];
     readonly rowRenderer?: PlatformComponent;
@@ -176,7 +177,7 @@ export type ProjectionDetailScreenDefinition = {
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
-    readonly fallback?: string;
+    readonly fallback?: ScreenFallback;
     readonly query: string;
     /** Query output field whose value titles the page header (breadcrumb) when no `header` is set. */
     readonly recordTitleField?: string;

package/dist/screen.d.ts

@@ -123,6 +123,8 @@ export type { EditExtensionSection, EditFieldGroup, EditFieldPrefill, EditFieldS
 export { relatedListGroupHeaderLabel, relatedListGroupKey } from "./screen-entity-edit.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 { ScreenFallback, ScreenFallbackByReason, ScreenFallbackReason, } from "./screen-fallback.ts";
+export { fallbackTargetFor, fallbackTargets, SCREEN_FALLBACK_REASONS } from "./screen-fallback.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";

package/dist/screen.js

@@ -1,4 +1,5 @@
 export { DASHBOARD_MIN_REFRESH_SECONDS, DASHBOARD_STAT_TONES } from "./screen-dashboard.js";
 export { relatedListGroupHeaderLabel, relatedListGroupKey } from "./screen-entity-edit.js";
+export { fallbackTargetFor, fallbackTargets, SCREEN_FALLBACK_REASONS } from "./screen-fallback.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.393.0",
+  "version": "0.395.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>",
@@ -22,6 +22,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./kebab-case": {
+      "types": "./dist/kebab-case.d.ts",
+      "default": "./dist/kebab-case.js"
+    },
     "./identifiers": {
       "types": "./dist/identifiers.d.ts",
       "default": "./dist/identifiers.js"
@@ -313,6 +317,10 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       },
+      "./kebab-case": {
+        "types": "./dist/kebab-case.d.ts",
+        "default": "./dist/kebab-case.js"
+      },
       "./identifiers": {
         "types": "./dist/identifiers.d.ts",
         "default": "./dist/identifiers.js"