@cosmicdrift/kumiko-types 0.193.0 → 0.194.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.193.0",
+  "version": "0.194.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": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/fields.ts

@@ -604,6 +604,9 @@ export type ImageFieldDef = {
    *  thing a caller may ask for — the spec lives here, never in a request,
    *  so nobody can drive arbitrary renders. Boot-validated. */
   readonly variants?: Readonly<Record<string, VariantSpec>>;
+  /** Forwarded to the file input's `capture` attribute so a phone opens the
+   *  camera instead of the file picker. */
+  readonly capture?: "environment" | "user";
   readonly access?: FieldAccess;
 };
 

package/src/handlers.ts

@@ -343,8 +343,10 @@ export type AppContext = SharedContextFields & {
 export type HandlerContext<TMap extends object = KumikoEventTypeMap> = SharedContextFields & {
   readonly db: TenantDb;
   // Same tenant scoping as `db`, but never bound to the handler's tx: writes
-  // through it survive a rollback, for side effects that already happened outside the DB.
-  readonly dbOutsideTransaction: TenantDb;
+  // through it survive a rollback, for side effects that already happened
+  // outside the DB. `undefined` when the pipeline has no outside-tx source
+  // for this dispatch (see dispatch-shared.ts) — callers must check before use.
+  readonly dbOutsideTransaction: TenantDb | undefined;
   readonly registry: Registry;
   /** Aktiver SessionUser des Handler-Aufrufs — Convenience-Alias zu
    *  `event.user`. Existiert weil Handler intuitiv `ctx.user.tenantId`

package/src/screen.ts

@@ -607,7 +607,11 @@ export type EntityEditScreenDefinition = {
    *  resolves both against the schema; boot-validator checks the target
    *  resolves to a registered screen. Overrides the default post-save
    *  target (the entity's list screen); delete is unaffected and still
-   *  always navigates to the list. */
+   *  always navigates to the list. A cross-feature QN hard-couples this
+   *  feature to the target at boot time — an app that doesn't mount the
+   *  target feature fails the boot-validator; only use this form in a
+   *  reusable feature when the target feature is guaranteed to be
+   *  mounted alongside it. */
   readonly redirect?: string;
   /** Optionaler per-Field-Label-i18n-Key (Field-Name → Key), überschreibt
    *  die Default-Konvention `<feature>:entity:<entity>:field:<name>`.
@@ -655,20 +659,28 @@ export type ActionFormScreenDefinition = {
   /** i18n-key für den Submit-Button. Default: i18n-Default des
    *  Renderers (typischerweise "actions.submit"). */
   readonly submitLabel?: string;
-  /** Nach erfolgreichem Submit zu dieser Screen-ID navigieren: entweder
-   *  kurze ID (z.B. "item-list" — gleiche Feature, der nav-Router
-   *  resolved zum vollen Pfad) oder voll-qualifizierte Cross-Feature-QN
-   *  (`<feature>:screen:<id>`). Wenn nicht gesetzt, bleibt der User auf
-   *  dem Form-Screen. Boot-Validator prüft dass das Ziel einen
-   *  registrierten Screen meint. */
+  /** Navigate to this screen ID after a successful submit: either a short
+   *  ID (e.g. "item-list" — same feature, the nav-router resolves to the
+   *  full path) or a fully-qualified cross-feature QN
+   *  (`<feature>:screen:<id>`). If not set, the user stays on the form
+   *  screen. Boot-validator checks that the target resolves to a
+   *  registered screen. A cross-feature QN hard-couples this feature to
+   *  the target at boot time — an app that doesn't mount the target
+   *  feature fails the boot-validator; only use this form in a reusable
+   *  feature when the target feature is guaranteed to be mounted
+   *  alongside it. */
   readonly redirect?: string;
-  /** Ziel des Abbrechen-Buttons. Default: `redirect` (historisches
-   *  Verhalten — Cancel und Submit-Redirect landen dann am selben Ort).
-   *  `false` = kein Abbrechen-Button; richtig für Single-Action-Screens
-   *  ohne verwerfbaren Zustand (z.B. "Test-Mail senden"), wo Abbrechen
-   *  nur ein zweiter Weg zum selben Ziel wäre. Akzeptiert dieselben
-   *  String-Targets wie `redirect` (kurze ID oder Cross-Feature-QN);
-   *  Boot-Validator prüft das. */
+  /** Target of the Cancel button. Default: `redirect` (historical
+   *  behavior — Cancel and the submit-redirect then land in the same
+   *  place). `false` = no Cancel button; correct for single-action
+   *  screens with no discardable state (e.g. "Send test mail"), where
+   *  Cancel would just be a second path to the same target. Accepts the
+   *  same string targets as `redirect` (short ID or cross-feature QN);
+   *  boot-validator checks it. A cross-feature QN hard-couples this
+   *  feature to the target at boot time — an app that doesn't mount the
+   *  target feature fails the boot-validator; only use this form in a
+   *  reusable feature when the target feature is guaranteed to be
+   *  mounted alongside it. */
   readonly cancelTarget?: string | false;
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;