@cosmicdrift/kumiko-renderer 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,82 @@
 # @cosmicdrift/kumiko-renderer
 
+## 0.4.1
+
+### Patch Changes
+
+- 010b410: feat(auth-email-password): "Bestätigungs-Mail erneut senden" im LoginScreen
+
+  LoginScreen bietet bei reason=email_not_verified jetzt einen Resend-Link
+  im Fehler-Banner — der existierende `requestEmailVerification`-Endpoint
+  wird direkt aufgerufen, der Banner wechselt nach Erfolg zum Info-Variant
+  ("Wir haben dir eine neue Bestätigungs-Mail geschickt.").
+
+  UX-Details:
+
+  - Bei 429 → inline-Hint "Bitte warte kurz und versuche es erneut."
+  - Bei Netzwerk/sonstigen Fehlern → inline-Hint "Konnte nicht senden."
+  - Anti-Typo-Gate: ändert der User die Email-Eingabe nach dem Login-Fail,
+    verschwindet der Resend-Link — sonst würde Resend silent-success an die
+    geänderte (potentiell typoed) Adresse gehen ohne User-Feedback.
+  - Andere Failure-Codes (invalid_credentials etc.) zeigen weiterhin keinen
+    Resend-Link.
+
+  i18n: 4 neue Keys (DE+EN) im `auth.login.resend*`-Namespace, additive.
+  Apps die ihre Translations override-en müssen nichts ändern.
+
+  Additive UI-Feature — keine API-Breaks, keine Schema-Migration.
+
+- Updated dependencies [010b410]
+  - @cosmicdrift/kumiko-framework@0.4.1
+  - @cosmicdrift/kumiko-headless@0.4.1
+
+## 0.4.0
+
+### Minor Changes
+
+- 825e7d2: Visual-Tree V.1.4 → V.1.6 — Feature-complete Editor + Folder-Hierarchy + Roving-tabindex.
+
+  **V.1.4** — explicit `folder?: string` Schema-Field auf text-block-entity. Slug bleibt
+  kebab-only validiert, Folder explizit gesetzt. Tree gruppiert via `groupBlocksByFolder`
+  (ersetzt `groupBlocksBySlugPrefix`). `Subscribe<T>` Signature um optional `emitError`
+  erweitert für explicit async-error-Pfade. ProviderBranch zeigt Error-Banner mit
+  Retry-Button. Drift-Test pinnt seedTextBlock-vs-set.write Slug-Validation.
+
+  **V.1.4b** — URL-State-Routing für Editor-Target via `nav.searchParams`. F5 + Back-Button
+  stellen den Editor-State wieder her. Format: `?t=text-content:edit&a_slug=...&a_lang=...`.
+  Plus `useDispatchTarget` hook ersetzt globalen `dispatchTarget` als empfohlenen Production-
+  Pfad (legacy bleibt für Test-Hooks).
+
+  **V.1.5** — Arrow-Key-Navigation (`<aside role="tree">`, ARIA-tree-Pattern) + SSE-driven
+  Tree-Refresh. `ClientFeatureDefinition.treeEntities?: string[]` listet Entity-Namen pro
+  Provider; live-events triggern provider-re-mount → Stale-Tree-state="stub"→"filled"
+  flippt nach save automatisch.
+
+  **V.1.5c+d** — Active-Node-Highlight (explicit blue + 2px border-l + scrollIntoView),
+  VS-Code-Polish (compact spacing, focus-visible, folder-icon-color text-amber, indent-
+  guides per ancestor-depth), Folder-Wrapper für legal-pages ("📁 Legal" + slug-first
+  Verschachtelung) und text-content ("📁 Content").
+
+  **V.1.6** — Multi-level Folder-Splitting (`folder="page/marketing"` → nested folders,
+  walk-or-create-pattern, folder/leaf-collision-tolerant). Roving-tabindex (nur focused-
+  treeitem hat tabIndex=0, Tab cyclt aus dem Tree raus).
+
+  35/35 kumiko check PASS, 13/13 group-blocks + 22/22 text-content integration tests grün.
+  Browser + Keyboard lokal validated.
+
+  **Breaking**: `TreeContext` Type entfernt (V.1.2 SR2-Rip — war nie genutzt). Provider sind
+  session-bound: `TreeChildrenSubscribe = () => Subscribe<T>` statt `(ctx) => Subscribe<T>`.
+
+  **V.1.7-Followups**: useEffect-deps in VisualTree-focus-init (Performance), Cancellation-
+  Token in TreeProvider's fetch (emit-after-unmount-warning), inline-rename, drag-drop,
+  file-icons per slug-extension, parent-jump bei ArrowLeft auf collapsed-item.
+
+### Patch Changes
+
+- Updated dependencies [825e7d2]
+  - @cosmicdrift/kumiko-framework@0.4.0
+  - @cosmicdrift/kumiko-headless@0.4.0
+
 ## 0.3.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,8 +15,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.3.0",
-    "@cosmicdrift/kumiko-headless": "0.3.0",
+    "@cosmicdrift/kumiko-framework": "0.4.1",
+    "@cosmicdrift/kumiko-headless": "0.4.1",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/src/app/kumiko-screen.tsx

@@ -1,3 +1,4 @@
+import type { ConfigCascade, ConfigValueSource } from "@cosmicdrift/kumiko-framework/engine";
 import type {
   ActionFormScreenDefinition,
   ConfigEditScreenDefinition,
@@ -918,8 +919,12 @@ function ActionFormBody({
 // Banner/Submit-Button-State sind identisch zu entityEdit. Der einzige
 // Pfad-Unterschied ist customSubmit das mehrere config:write:set-Calls
 // orchestriert.
+//
+// Response enthält seit config-seeding auch `source` (z.B. "system-row")
+// für das ConfigSourceBadge. Type wird lokal gehalten da er nur hier
+// relevant ist — kein eigener Export nötig.
 type ConfigValueResponse = Readonly<
-  Record<string, { value: string | number | boolean | undefined; scope: string }>
+  Record<string, { value: string | number | boolean | undefined; scope: string; source: string }>
 >;
 
 function ConfigEditBody({
@@ -931,7 +936,7 @@ function ConfigEditBody({
   readonly screen: ConfigEditScreenDefinition;
   readonly translate?: Translate;
 }): ReactNode {
-  const { Banner } = usePrimitives();
+  const { Banner, ConfigSourceBadge, ConfigCascadeView } = usePrimitives();
   const dispatcher = useDispatcher();
 
   // Detail-Load: config:query:values returnt ALLE Keys des Tenants.
@@ -939,6 +944,8 @@ function ConfigEditBody({
   // unsere Form-Field-Werte.
   const valuesQuery = useQuery<ConfigValueResponse>("config:query:values", {});
 
+  const cascadeQuery = useQuery<Record<string, ConfigCascade>>("config:query:cascade", {});
+
   const synthEntity = useMemo(() => synthesizeConfigEditEntity(screen.fields), [screen.fields]);
   const synthScreen = useMemo(() => synthesizeConfigEditScreen(screen), [screen]);
 
@@ -978,6 +985,34 @@ function ConfigEditBody({
     return out as FormValues;
   }, [valuesQuery.data, screen.fields, screen.configKeys]);
 
+  // Sources-Lookup: qualifiedKey → ConfigValueSource für das
+  // ConfigSourceBadge. Wird via fieldAppendix an RenderEdit
+  // durchgereicht.
+  const sources = useMemo<Record<string, ConfigValueSource>>(() => {
+    if (valuesQuery.data === null) return {};
+    const out: Record<string, ConfigValueSource> = {};
+    for (const [shortName, qualified] of Object.entries(screen.configKeys)) {
+      const source = valuesQuery.data[qualified]?.source as ConfigValueSource | undefined; // @cast-boundary engine-payload
+      if (source !== undefined) out[shortName] = source;
+    }
+    return out;
+  }, [valuesQuery.data, screen.configKeys]);
+
+  // Cascade-Lookup: qualifiedKey → ConfigCascade für die
+  // Cascade-Anzeige unter jedem Feld. Defensive `levels`-Shape-Check
+  // damit fremde Query-Mocks (z.B. configEdit-Unit-Tests die nur
+  // `config:query:values` mocken) nicht durch das Cascade-Rendering
+  // crashen.
+  const cascades = useMemo<Record<string, ConfigCascade>>(() => {
+    if (!cascadeQuery.data) return {};
+    const out: Record<string, ConfigCascade> = {};
+    for (const [shortName, qualified] of Object.entries(screen.configKeys)) {
+      const cascade = cascadeQuery.data[qualified];
+      if (cascade && Array.isArray(cascade.levels)) out[shortName] = cascade;
+    }
+    return out;
+  }, [cascadeQuery.data, screen.configKeys]);
+
   // Multi-Write Submit: ein einzelner /api/batch Call mit N
   // config:write:set Commands. Server-side ist batch atomic
   // (transaktional: alle Writes in einer DB-TX, all-or-nothing) und
@@ -1041,6 +1076,27 @@ function ConfigEditBody({
       customSubmit={customSubmit}
       {...(screen.submitLabel !== undefined && { submitLabel: screen.submitLabel })}
       {...(translate !== undefined && { translate })}
+      fieldAppendix={(fieldName: string) => {
+        const source = sources[fieldName];
+        const cascade = cascades[fieldName];
+        return (
+          <>
+            {source ? <ConfigSourceBadge source={source} /> : null}
+            {cascade !== undefined ? (
+              <ConfigCascadeView
+                cascade={cascade}
+                screenScope={screen.scope}
+                qualifiedKey={screen.configKeys[fieldName]}
+                onReset={async (key, scope) => {
+                  await dispatcher.write("config:write:reset", { key, scope });
+                  await valuesQuery.refetch?.();
+                  await cascadeQuery.refetch?.();
+                }}
+              />
+            ) : null}
+          </>
+        );
+      }}
     />
   );
 }

package/src/components/render-edit.tsx

@@ -56,6 +56,10 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
    *  damit "Speichern" durch domain-spezifischere Strings ersetzt
    *  werden kann ("Genehmigen" / "Versenden" / etc.). */
   readonly submitLabel?: string;
+  /** Pro-Field-Zusatz-Inhalt nach dem Label (z.B. ConfigSourceBadge).
+   *  Wird mit dem Field-Namen aufgerufen, returnt ReactNode oder
+   *  undefined. */
+  readonly fieldAppendix?: (fieldName: string) => ReactNode | undefined;
 };
 
 function deriveFormFields<TValues extends FormValues, TCtx>(
@@ -100,6 +104,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
     onCancel,
     onReload,
     submitLabel,
+    fieldAppendix,
   } = props;
   const { customSubmit } = props;
   // Translate-Fallback: wenn der Caller keine Translate-Fn übergibt,
@@ -267,6 +272,10 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
                 }}
                 GridCell={GridCell}
                 featureName={featureName}
+                {...(fieldAppendix !== undefined && {
+                  labelAppendix: fieldAppendix(field.field),
+                  fieldAppendix: fieldAppendix(field.field),
+                })}
               />
             ))}
           </Grid>
@@ -323,6 +332,8 @@ type GridCellForFieldProps = {
   /** Tier 2.7e-3: durchgereicht damit Reference-Felder die richtige
    *  Lookup-Query-QN bauen können (`<feature>:query:<refEntity>:list`). */
   readonly featureName: string;
+  readonly labelAppendix?: ReactNode;
+  readonly fieldAppendix?: ReactNode;
 };
 
 function GridCellForField({
@@ -332,6 +343,8 @@ function GridCellForField({
   onChange,
   GridCell,
   featureName,
+  labelAppendix,
+  fieldAppendix,
 }: GridCellForFieldProps): ReactNode {
   const effectiveSpan = field.span !== undefined ? Math.min(field.span, columns) : 1;
   return (
@@ -341,6 +354,8 @@ function GridCellForField({
         {...(issues !== undefined && { issues })}
         onChange={onChange}
         featureName={featureName}
+        {...(labelAppendix !== undefined && { labelAppendix })}
+        {...(fieldAppendix !== undefined && { fieldAppendix })}
       />
     </GridCell>
   );

package/src/components/render-field.tsx

@@ -14,14 +14,27 @@ import { usePrimitives } from "../primitives";
 export type RenderFieldProps = {
   readonly field: EditFieldViewModel;
   readonly issues?: readonly FieldIssue[];
-  readonly onChange: (value: unknown) => void;
+  readonly onChange: (val: unknown) => void;
   /** Nur bei type:"reference" relevant — Feature-Name für die Lookup-
    *  Query-QN (`<feature>:query:<refEntity>:list`). Andere Field-Types
    *  ignorieren das Prop. */
   readonly featureName?: string;
+  /** Optionaler Zusatz-Inhalt der nach dem Label gerendert wird (z.B.
+   *  ConfigSourceBadge). */
+  readonly labelAppendix?: ReactNode;
+  /** Optionaler Zusatz-Inhalt der nach dem Input gerendert wird (z.B.
+   *  ConfigCascade). */
+  readonly fieldAppendix?: ReactNode;
 };
 
-export function RenderField({ field, issues, onChange, featureName }: RenderFieldProps): ReactNode {
+export function RenderField({
+  field,
+  issues,
+  onChange,
+  featureName,
+  labelAppendix,
+  fieldAppendix,
+}: RenderFieldProps): ReactNode {
   const { Field, Input } = usePrimitives();
   if (!field.visible) return null;
 
@@ -51,6 +64,8 @@ export function RenderField({ field, issues, onChange, featureName }: RenderFiel
       label={field.label}
       required={field.required}
       {...(issues !== undefined && { issues })}
+      {...(labelAppendix !== undefined && { labelAppendix })}
+      {...(fieldAppendix !== undefined && { fieldAppendix })}
       testId={`field-${field.field}`}
     >
       {control}

package/src/primitives.tsx

@@ -29,6 +29,11 @@
 // nicht), aber der App-Code hat ein einheitliches Primitive-Vokabular
 // über Core + Custom.
 
+import type {
+  ConfigCascade,
+  ConfigScope,
+  ConfigValueSource,
+} from "@cosmicdrift/kumiko-framework/engine";
 import type {
   FieldIssue,
   ListColumnViewModel,
@@ -88,6 +93,8 @@ export type FieldProps = {
   readonly label: string;
   readonly required?: boolean;
   readonly issues?: readonly FieldIssue[];
+  readonly labelAppendix?: ReactNode;
+  readonly fieldAppendix?: ReactNode;
   readonly children: ReactNode;
   readonly testId?: string;
 };
@@ -466,6 +473,22 @@ export type DialogProps = {
   readonly testId?: string;
 };
 
+/** Source-badge for one cascade step (User / Tenant / System / …).
+ *  Used inline next to a config value to indicate where it came from. */
+export type ConfigSourceBadgeProps = {
+  readonly source: ConfigValueSource;
+};
+
+/** Collapsible cascade-view that lives under a config-edit input.
+ *  Shows the active level inline; click expands the full cascade and
+ *  exposes a Reset-button if the active level matches `screenScope`. */
+export type ConfigCascadeViewProps = {
+  readonly cascade: ConfigCascade;
+  readonly screenScope: ConfigScope;
+  readonly onReset?: (key: string, scope: ConfigScope) => void;
+  readonly qualifiedKey?: string;
+};
+
 // ---- Core-Registry (Kumiko-eigene Primitives) ----
 
 export type CorePrimitives = {
@@ -481,6 +504,8 @@ export type CorePrimitives = {
   readonly Text: ComponentType<TextProps>;
   readonly Heading: ComponentType<HeadingProps>;
   readonly Dialog: ComponentType<DialogProps>;
+  readonly ConfigSourceBadge: ComponentType<ConfigSourceBadgeProps>;
+  readonly ConfigCascadeView: ComponentType<ConfigCascadeViewProps>;
 };
 
 /** Offene Extension-Zone für App-eigene Primitives. Devs erweitern