@cosmicdrift/kumiko-renderer 0.257.0 → 0.258.0

package/src/i18n-defaults.ts

@@ -153,6 +153,14 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
       "Found an open draft for this form. Do you want to resume it?",
     "kumiko.form.draft.start-new": "Start new",
 
+    "kumiko.secretMint.title": "Your new secret",
+    "kumiko.secretMint.warning":
+      "Copy this now — it is shown only this once and cannot be retrieved later.",
+    "kumiko.secretMint.confirm": "I have copied it",
+    "kumiko.secretMint.copy": "Copy",
+    "kumiko.secretMint.copied": "Copied",
+    "kumiko.secretMint.done": "Done.",
+
     "kumiko.validation.required": "Required.",
     "kumiko.validation.invalid": "Invalid value.",
     "kumiko.validation.too-short": "Too short (at least {min} characters).",

package/src/index.ts

@@ -202,6 +202,8 @@ export type {
   PrimitivesRegistry,
   ProgressProps,
   RuntimeRenderer,
+  SecretRevealProps,
+  SecretRevealValue,
   SectionProps,
   StatusBadgeProps,
   StatusTone,

package/src/primitives.tsx

@@ -88,7 +88,11 @@ export type ButtonProps = {
    *  die Container-Breite (Karten/Panels). Andere Breiten sind Layout-Sache
    *  des Containers, kein Button-Prop (Kit hält arbiträres Sizing draußen). */
   readonly width?: "full" | "auto";
-  readonly children: ReactNode;
+  /** Optional for icon-only buttons (`size="icon"` with a resolved `icon`)
+   *  — the icon carries the content then, `ariaLabel` the accessible name.
+   *  Required in practice otherwise: without children and without `icon`
+   *  the button stays empty. */
+  readonly children?: ReactNode;
   readonly testId?: string;
   /** Layout extras — Web merges via cn(), native impls ignore it
    *  (precedent: LinkProps.className). */
@@ -124,9 +128,11 @@ export type LinkProps = {
  *  Banner nicht edge-to-edge an den Main-Border klebt — relevant
  *  seit `<main>` kein eigenes Padding mehr hat. */
 export type BannerProps = {
-  /** "error" für Alerts (Konflikt, Netzfehler), "info" für neutrale
-   *  Platzhalter (Not-Found, Loading), "loading" für Lade-States. */
-  readonly variant?: "error" | "info" | "loading";
+  /** "error" for alerts (conflict, network error), "info" for neutral
+   *  placeholders (not-found, loading), "loading" for load states, "warning"
+   *  for a non-blocking but attention-grabbing notice (e.g. secretMint's
+   *  "this is shown only once"). */
+  readonly variant?: "error" | "info" | "loading" | "warning";
   readonly children: ReactNode;
   /** Optional — weitere Knöpfe/Elemente rechts vom Text (z.B. "Neu
    *  laden"). Inline, nicht als eigener Block. */
@@ -216,6 +222,8 @@ export type InputProps =
       readonly disabled?: boolean;
       readonly required?: boolean;
       readonly hasError?: boolean;
+      /** Hint text shown when the field is empty (analog to kind:"text"). */
+      readonly placeholder?: string;
       /** "current-password" für Login, "new-password" für Reset/Signup —
        *  Browser-Password-Manager nutzen das für die Speicherentscheidung.
        *  Native: textContentType="password" / "newPassword". */
@@ -231,6 +239,8 @@ export type InputProps =
       readonly disabled?: boolean;
       readonly required?: boolean;
       readonly hasError?: boolean;
+      /** Hint text shown when the field is empty (analog to kind:"text"). */
+      readonly placeholder?: string;
       readonly testId?: string;
       /** Closed FieldIconKey vocabulary (FIELD_ICONS registry, renderer-web). */
       readonly icon?: FieldIconKey;
@@ -461,6 +471,8 @@ export type InputProps =
       readonly disabled?: boolean;
       readonly required?: boolean;
       readonly hasError?: boolean;
+      /** Hint text shown when the field is empty (analog to kind:"text"). */
+      readonly placeholder?: string;
       /** Read-only Textarea. Nicht `disabled` — bleibt fokussier-/
        *  kopierbar (analog zu kind:"text"). */
       readonly readOnly?: boolean;
@@ -1165,6 +1177,28 @@ export type ActionOverflowMenuProps = {
   readonly testId?: string;
 };
 
+/** One revealed value on a `secretMint` screen's confirm phase (fw#2548). */
+export type SecretRevealValue = {
+  readonly label: string;
+  readonly value: string;
+  readonly copyable: boolean;
+  readonly multiline: boolean;
+  /** Render `value` as a scannable QR code instead of monospaced text — for
+   *  an otpauth://-style enrollment URI. Platforms without a QR-capable
+   *  SecretReveal primitive fall back to the monospaced display. */
+  readonly qr?: boolean;
+};
+
+/** One-time secret reveal — mint-form confirm phase. Renders each value
+ *  monospaced (multiline splits it one line per entry, for recovery codes),
+ *  with a per-value copy control when `copyable`. */
+export type SecretRevealProps = {
+  readonly values: readonly SecretRevealValue[];
+  readonly copyLabel: string;
+  readonly copiedLabel: string;
+  readonly testId?: string;
+};
+
 // ---- Core-Registry (Kumiko-eigene Primitives) ----
 
 export type CorePrimitives = {
@@ -1229,6 +1263,10 @@ export type CorePrimitives = {
   /** Optional: without an implementation, callers with >2 header/row
    *  actions fall back to today's all-buttons-inline rendering (A7). */
   readonly ActionOverflowMenu?: ComponentType<ActionOverflowMenuProps>;
+  /** Optional (unlike the other Core-Primitives) so existing partial
+   *  CorePrimitives mocks in tests keep compiling — additive rollout of
+   *  a new primitive shouldn't force every test double to grow a stub. */
+  readonly SecretReveal?: ComponentType<SecretRevealProps>;
 };
 
 /** Offene Extension-Zone für App-eigene Primitives. Devs erweitern