@cosmicdrift/kumiko-renderer-web 0.189.0 → 0.191.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer-web",
-  "version": "0.189.0",
+  "version": "0.191.0",
   "description": "Web-platform bindings for @cosmicdrift/kumiko-renderer. HTML default-primitives, browser history-based navigation, EventSource-backed live events, and a one-call createKumikoApp that mounts the whole stack via react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -16,9 +16,9 @@
     "./styles.css": "./src/styles.css"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.189.0",
-    "@cosmicdrift/kumiko-headless": "0.189.0",
-    "@cosmicdrift/kumiko-renderer": "0.189.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.191.0",
+    "@cosmicdrift/kumiko-headless": "0.191.0",
+    "@cosmicdrift/kumiko-renderer": "0.191.0",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-label": "^2.1.8",

package/src/__tests__/wizard-form-validation.test.tsx

@@ -71,3 +71,66 @@ describe("entityEdit wizard — presence validation on Next (fw#1910)", () => {
     expect(screen.queryByTestId("field-fullName-errors")).toBeNull();
   });
 });
+
+// fw#1966: the wizard chrome used to only show a "Step X of Y" counter —
+// no way to see what the remaining steps are called. The step bar renders
+// every section title up front and marks the current one.
+describe("entityEdit wizard — step bar (fw#1966)", () => {
+  test("shows every section title as a step entry", () => {
+    renderWizard();
+
+    expect(screen.getByTestId("render-edit-wizard-steps-step-0").textContent).toContain("Step 1");
+    expect(screen.getByTestId("render-edit-wizard-steps-step-1").textContent).toContain("Step 2");
+  });
+
+  test("marks the active step and moves the marker forward on Next", async () => {
+    const { container } = renderWizard();
+
+    expect(screen.getByTestId("render-edit-wizard-steps-step-0").getAttribute("aria-current")).toBe(
+      "step",
+    );
+    expect(
+      screen.getByTestId("render-edit-wizard-steps-step-1").getAttribute("aria-current"),
+    ).toBeNull();
+
+    const fullNameInput = container.querySelector("#kumiko-edit-fullName");
+    await userEvent.type(fullNameInput as Element, "Ada Lovelace");
+    await userEvent.click(screen.getByTestId("render-edit-wizard-next"));
+
+    expect(
+      screen.getByTestId("render-edit-wizard-steps-step-0").getAttribute("aria-current"),
+    ).toBeNull();
+    expect(screen.getByTestId("render-edit-wizard-steps-step-1").getAttribute("aria-current")).toBe(
+      "step",
+    );
+  });
+
+  test("a wizard with N sections renders N step entries", () => {
+    const threeStepScreen: EntityEditScreenDefinition = {
+      id: "profile-edit-3",
+      type: "entityEdit",
+      entity: "profile",
+      layout: {
+        mode: "wizard",
+        sections: [
+          { title: "Basics", fields: ["fullName"] },
+          { title: "Contact", fields: ["email"] },
+          { title: "Review", fields: [] },
+        ],
+      },
+    };
+    const threeStepSchema: FeatureSchema = {
+      featureName: "demo",
+      entities: { profile: profileEntity },
+      screens: [threeStepScreen],
+    };
+    const { container } = render(
+      <DispatcherProvider dispatcher={createMockDispatcher()}>
+        <KumikoScreen schema={threeStepSchema} qn="demo:screen:profile-edit-3" />
+      </DispatcherProvider>,
+    );
+
+    const steps = container.querySelectorAll('[data-testid^="render-edit-wizard-steps-step-"]');
+    expect(steps.length).toBe(3);
+  });
+});

package/src/index.ts

@@ -224,6 +224,7 @@ export {
   StatCard,
   StatusBadge,
   StatusBarChart,
+  StepBar,
   smoothPath,
   TextareaField,
   TextField,

package/src/primitives/index.tsx

@@ -33,6 +33,7 @@ import {
   type LinkProps,
   type ProgressProps,
   type SectionProps,
+  type StepBarProps,
   type TextProps,
   useColumnRenderer,
   useTranslation,
@@ -82,6 +83,7 @@ import { Label as UiLabel } from "../ui/label";
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "../ui/table";
 import { Textarea } from "../ui/textarea";
 import { ProgressBar } from "../widgets/progress-bar";
+import { StepBar } from "../widgets/step-bar";
 import { ComboboxInput } from "./combobox";
 import { DateInput } from "./date-input";
 import { DefaultDialog } from "./dialog";
@@ -1899,6 +1901,24 @@ function DefaultProgress({ value, testId }: ProgressProps): ReactNode {
   return <ProgressBar value={value} testId={testId} />;
 }
 
+function DefaultStepBar({
+  steps,
+  currentIndex,
+  compactLabel,
+  testId,
+  compactTestId,
+}: StepBarProps): ReactNode {
+  return (
+    <StepBar
+      steps={steps}
+      currentIndex={currentIndex}
+      compactLabel={compactLabel}
+      testId={testId}
+      compactTestId={compactTestId}
+    />
+  );
+}
+
 function DefaultHeading({ variant = "page", children, testId }: HeadingProps): ReactNode {
   // Page-Heading = h1, sehr selten in einer App (max 1 pro Screen).
   // Section-Heading = h2 mit uppercase + muted-foreground — derselbe
@@ -1993,4 +2013,5 @@ export const defaultPrimitives: CorePrimitives = {
   ConfigCascadeView: DefaultConfigCascadeView,
   Link: DefaultLink,
   Progress: DefaultProgress,
+  StepBar: DefaultStepBar,
 };

package/src/ui/sheet.tsx

@@ -47,6 +47,7 @@ function SheetOverlay({
 
 function SheetContent({
   className,
+  overlayClassName,
   children,
   side = "right",
   showCloseButton = true,
@@ -54,10 +55,11 @@ function SheetContent({
 }: React.ComponentProps<typeof SheetPrimitive.Content> & {
   side?: "top" | "right" | "bottom" | "left"
   showCloseButton?: boolean
+  overlayClassName?: string
 }) {
   return (
     <SheetPortal>
-      <SheetOverlay />
+      <SheetOverlay className={overlayClassName} />
       <SheetPrimitive.Content
         data-slot="sheet-content"
         className={cn(
@@ -100,7 +102,13 @@ function SheetFooter({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="sheet-footer"
-      className={cn("mt-auto flex flex-col gap-2 p-4", className)}
+      // Matches the card footer convention (primitives/index.tsx cardFooter
+      // + cardFooterBorder) — same padding/border/button-row shape as
+      // SectionCard/DefaultCard so a drawer footer reads like a card footer.
+      className={cn(
+        "mt-auto flex items-center justify-end gap-2 border-t bg-muted/30 px-[var(--card-padding)] py-4",
+        className,
+      )}
       {...props}
     />
   )

package/src/widgets/__tests__/widgets.test.tsx

@@ -9,6 +9,7 @@ import { SectionCard } from "../section-card";
 import { MiniStat, StatCard } from "../stat";
 import { EmptyState } from "../states";
 import { StatusBadge } from "../status-badge";
+import { StepBar } from "../step-bar";
 
 describe("StatusBadge", () => {
   test("rendert Label mit Tone-Klassen", () => {
@@ -42,6 +43,93 @@ describe("ProgressBar", () => {
     render(<ProgressBar value={-3} testId="bar" />);
     expect(screen.getByTestId("bar").getAttribute("aria-valuenow")).toBe("0");
   });
+
+  test("Füll-Element bildet den Wert über Breite ab und erbt die Höhe nicht vom Elternteil", () => {
+    render(<ProgressBar value={0.5} testId="bar" />);
+    const bar = screen.getByTestId("bar");
+    const fill = bar.firstElementChild as HTMLElement;
+    expect(fill.style.width).toBe("50%");
+    expect(fill.className).not.toContain("h-full");
+    expect(fill.className).toContain("absolute");
+    expect(fill.className).toContain("inset-y-0");
+    expect(bar.className).toContain("relative");
+  });
+});
+
+describe("StepBar", () => {
+  test("rendert einen Step-Eintrag pro Label mit sichtbarem Titel", () => {
+    render(
+      <StepBar
+        steps={["Basics", "Industry", "Review"]}
+        currentIndex={0}
+        compactLabel="Step 1 of 3 · Basics"
+        testId="steps"
+      />,
+    );
+    expect(screen.getByTestId("steps-step-0").textContent).toContain("Basics");
+    expect(screen.getByTestId("steps-step-1").textContent).toContain("Industry");
+    expect(screen.getByTestId("steps-step-2").textContent).toContain("Review");
+  });
+
+  test("markiert nur den aktiven Schritt via aria-current", () => {
+    render(
+      <StepBar
+        steps={["Basics", "Industry", "Review"]}
+        currentIndex={1}
+        compactLabel="Step 2 of 3 · Industry"
+        testId="steps"
+      />,
+    );
+    expect(screen.getByTestId("steps-step-0").getAttribute("aria-current")).toBeNull();
+    expect(screen.getByTestId("steps-step-1").getAttribute("aria-current")).toBe("step");
+    expect(screen.getByTestId("steps-step-2").getAttribute("aria-current")).toBeNull();
+  });
+
+  test("erledigte Schritte zeigen ein Häkchen statt der Nummer, kommende ihre Nummer", () => {
+    render(
+      <StepBar
+        steps={["Basics", "Industry", "Review"]}
+        currentIndex={1}
+        compactLabel="Step 2 of 3 · Industry"
+        testId="steps"
+      />,
+    );
+    const done = screen.getByTestId("steps-step-0");
+    expect(done.querySelector("svg")).not.toBeNull();
+    expect(done.textContent).not.toContain("1");
+
+    const current = screen.getByTestId("steps-step-1");
+    expect(current.querySelector("svg")).toBeNull();
+    expect(current.textContent).toContain("2");
+
+    const upcoming = screen.getByTestId("steps-step-2");
+    expect(upcoming.querySelector("svg")).toBeNull();
+    expect(upcoming.textContent).toContain("3");
+  });
+
+  test("erledigte Schritte bleiben für Screenreader als erledigt erkennbar", () => {
+    render(
+      <StepBar
+        steps={["Basics", "Industry"]}
+        currentIndex={1}
+        compactLabel="Step 2 of 2 · Industry"
+        testId="steps"
+      />,
+    );
+    expect(screen.getByTestId("steps-step-0").textContent).toContain("Done");
+  });
+
+  test("rendert den compactLabel-Fallback für schmale Viewports", () => {
+    render(
+      <StepBar
+        steps={["Basics", "Industry"]}
+        currentIndex={0}
+        compactLabel="Step 1 of 2 · Basics"
+        compactTestId="steps-compact"
+      />,
+    );
+    expect(screen.getByTestId("steps-compact").textContent).toBe("Step 1 of 2 · Basics");
+  });
 });
 
 describe("ModeSwitch", () => {

package/src/widgets/drawer.tsx

@@ -1,4 +1,6 @@
-import type { ReactNode } from "react";
+import { Maximize2Icon, Minimize2Icon } from "lucide-react";
+import { type ReactNode, useRef, useState } from "react";
+import { cn } from "../lib/cn";
 import {
   Sheet,
   SheetContent,
@@ -17,8 +19,40 @@ export type DrawerProps = {
   readonly footer?: ReactNode;
   readonly children: ReactNode;
   readonly testId?: string;
+  /** Opt-in drag-to-resize + maximize toggle (left/right sides only). */
+  readonly resizable?: boolean;
+  readonly defaultWidthPx?: number;
+  readonly minWidthPx?: number;
+  readonly maxWidthPx?: number;
 };
 
+const DEFAULT_WIDTH_PX = 420;
+const MIN_WIDTH_PX = 320;
+const MAX_WIDTH_PX = 800;
+
+// Floating panel with a clearly visible margin on every edge, rounded on
+// all four corners — replaces the sheet primitive's flush-to-viewport-edge
+// per-side classes. twMerge resolves each utility group against the base
+// (inset/width/height/border/rounding), so this fully overrides rather than
+// stacking with it. 32px margin + 32px radius so the detachment from the
+// viewport edge reads clearly at a glance, not just on close 1:1 inspection.
+function floatingSideClass(side: "left" | "right" | "top" | "bottom"): string {
+  switch (side) {
+    case "left":
+      return "inset-y-8 left-8 h-auto w-[420px] max-w-[85vw] sm:max-w-[420px] rounded-[2rem] border shadow-2xl";
+    case "top":
+      return "inset-x-8 top-8 h-auto max-h-[80vh] rounded-[2rem] border shadow-2xl";
+    case "bottom":
+      return "inset-x-8 bottom-8 h-auto max-h-[80vh] rounded-[2rem] border shadow-2xl";
+    default:
+      return "inset-y-8 right-8 h-auto w-[420px] max-w-[85vw] sm:max-w-[420px] rounded-[2rem] border shadow-2xl";
+  }
+}
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max);
+}
+
 /** Slide-in panel beside a list (e.g. mail reader next to the inbox) —
  *  thin wrapper over the Sheet primitive with header/body/footer slots
  *  so screens skip per-route Radix boilerplate. */
@@ -31,10 +65,72 @@ export function Drawer({
   footer,
   children,
   testId,
+  resizable = false,
+  defaultWidthPx = DEFAULT_WIDTH_PX,
+  minWidthPx = MIN_WIDTH_PX,
+  maxWidthPx = MAX_WIDTH_PX,
 }: DrawerProps): ReactNode {
+  const canResize = resizable && (side === "left" || side === "right");
+  const [width, setWidth] = useState(defaultWidthPx);
+  const [maximized, setMaximized] = useState(false);
+  const dragRef = useRef<{ startX: number; startWidth: number } | null>(null);
+
+  const effectiveMaxWidthPx = () =>
+    typeof window === "undefined"
+      ? maxWidthPx
+      : Math.min(maxWidthPx, Math.round(window.innerWidth * 0.9));
+  const effectiveWidthPx = maximized ? effectiveMaxWidthPx() : width;
+
+  const onHandlePointerDown = (event: React.PointerEvent<HTMLDivElement>): void => {
+    event.currentTarget.setPointerCapture(event.pointerId);
+    dragRef.current = { startX: event.clientX, startWidth: effectiveWidthPx };
+    setMaximized(false);
+  };
+  const onHandlePointerMove = (event: React.PointerEvent<HTMLDivElement>): void => {
+    if (dragRef.current === null) return;
+    const deltaX = event.clientX - dragRef.current.startX;
+    const signedDelta = side === "right" ? -deltaX : deltaX;
+    setWidth(clamp(dragRef.current.startWidth + signedDelta, minWidthPx, effectiveMaxWidthPx()));
+  };
+  const onHandlePointerUp = (event: React.PointerEvent<HTMLDivElement>): void => {
+    event.currentTarget.releasePointerCapture(event.pointerId);
+    dragRef.current = null;
+  };
+  const onHandleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>): void => {
+    const step = event.shiftKey ? 40 : 16;
+    const grow = side === "right" ? "ArrowLeft" : "ArrowRight";
+    const shrink = side === "right" ? "ArrowRight" : "ArrowLeft";
+    if (event.key !== grow && event.key !== shrink) return;
+    event.preventDefault();
+    setMaximized(false);
+    const delta = event.key === grow ? step : -step;
+    setWidth((current) => clamp(current + delta, minWidthPx, effectiveMaxWidthPx()));
+  };
+
   return (
     <Sheet open={open} onOpenChange={onOpenChange}>
-      <SheetContent side={side} data-testid={testId}>
+      <SheetContent
+        side={side}
+        data-testid={testId}
+        overlayClassName="bg-black/20 backdrop-blur-[2px]"
+        className={floatingSideClass(side)}
+        style={canResize ? { width: effectiveWidthPx, maxWidth: "none" } : undefined}
+      >
+        {canResize && (
+          <button
+            type="button"
+            onClick={() => setMaximized((m) => !m)}
+            aria-pressed={maximized}
+            aria-label={maximized ? "Restore drawer width" : "Maximize drawer width"}
+            className="absolute top-4 right-14 z-10 rounded-xs p-1 text-muted-foreground opacity-70 transition-opacity hover:opacity-100 hover:bg-secondary focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-hidden"
+          >
+            {maximized ? (
+              <Minimize2Icon className="size-4" />
+            ) : (
+              <Maximize2Icon className="size-4" />
+            )}
+          </button>
+        )}
         {(title !== undefined || description !== undefined) && (
           <SheetHeader>
             {title !== undefined && <SheetTitle>{title}</SheetTitle>}
@@ -43,6 +139,26 @@ export function Drawer({
         )}
         <div className="flex-1 overflow-y-auto px-4">{children}</div>
         {footer !== undefined && <SheetFooter>{footer}</SheetFooter>}
+        {canResize && (
+          // biome-ignore lint/a11y/useSemanticElements: <hr> can't carry pointer/keyboard drag interaction or a live width value — a draggable separator needs a div with the ARIA role.
+          <div
+            role="separator"
+            aria-orientation="vertical"
+            aria-label="Resize drawer"
+            aria-valuenow={effectiveWidthPx}
+            aria-valuemin={minWidthPx}
+            aria-valuemax={effectiveMaxWidthPx()}
+            tabIndex={0}
+            onPointerDown={onHandlePointerDown}
+            onPointerMove={onHandlePointerMove}
+            onPointerUp={onHandlePointerUp}
+            onKeyDown={onHandleKeyDown}
+            className={cn(
+              "absolute inset-y-0 z-10 w-1 cursor-col-resize touch-none after:absolute after:inset-y-0 after:left-1/2 after:w-3 after:-translate-x-1/2 hover:bg-border",
+              side === "right" ? "left-0 -translate-x-1/2" : "right-0 translate-x-1/2",
+            )}
+          />
+        )}
       </SheetContent>
     </Sheet>
   );

package/src/widgets/index.ts

@@ -56,5 +56,6 @@ export { SectionCard } from "./section-card";
 export { MiniStat, Sparkline, StatCard, type StatDelta, type StatTone } from "./stat";
 export { EmptyState, ErrorState, LoadingState } from "./states";
 export { STATUS_TONE_TEXT, StatusBadge, type StatusTone } from "./status-badge";
+export { StepBar } from "./step-bar";
 export { UploadZone, type UploadZoneProps } from "./upload-zone";
 export { useDraft } from "./use-draft";

package/src/widgets/progress-bar.tsx

@@ -19,9 +19,12 @@ export function ProgressBar({
       aria-valuenow={Math.round(pct * 100)}
       aria-valuemin={0}
       aria-valuemax={100}
-      className={cn("h-2 w-full overflow-hidden rounded-full bg-muted", className)}
+      className={cn("relative h-2 w-full overflow-hidden rounded-full bg-muted", className)}
     >
-      <div className="h-full rounded-full bg-primary" style={{ width: `${pct * 100}%` }} />
+      <div
+        className="absolute inset-y-0 left-0 rounded-full bg-primary"
+        style={{ width: `${pct * 100}%` }}
+      />
     </div>
   );
 }

package/src/widgets/step-bar.tsx

@@ -0,0 +1,68 @@
+import { useTranslation } from "@cosmicdrift/kumiko-renderer";
+import { Check } from "lucide-react";
+import type { ReactNode } from "react";
+import { cn } from "../lib/cn";
+
+/** Wizard step overview — numbered chips with a connector line between
+ *  them, not clickable. Three visual states, none conveyed by color alone:
+ *  done (checkmark replaces the number, `aria-current` absent, a sr-only
+ *  label says so since the number itself is gone), current (`aria-current
+ *  ="step"`, own background), upcoming (dimmed, number visible). Below
+ *  `sm` the chip row hides in favor of `compactLabel` (seven step names
+ *  don't fit on a phone) — both live in the DOM, Tailwind's
+ *  `hidden`/`sm:hidden` pair picks the visible one per viewport (same
+ *  pattern as embedded-list-input.tsx's desktop/mobile split). */
+export function StepBar({
+  steps,
+  currentIndex,
+  compactLabel,
+  testId,
+  compactTestId,
+}: {
+  readonly steps: readonly string[];
+  readonly currentIndex: number;
+  readonly compactLabel: string;
+  readonly testId?: string;
+  readonly compactTestId?: string;
+}): ReactNode {
+  const t = useTranslation();
+  return (
+    <>
+      <ol data-testid={testId} className="hidden items-center gap-2 sm:flex sm:flex-wrap">
+        {steps.map((label, i) => {
+          const isDone = i < currentIndex;
+          const isCurrent = i === currentIndex;
+          return (
+            // biome-ignore lint/suspicious/noArrayIndexKey: steps is a static, positional list — index is stable identity, no reorder/DnD.
+            <li key={`${i}-${label}`} className="flex items-center gap-2">
+              {i > 0 && <span aria-hidden="true" className="h-px w-4 bg-border" />}
+              <span
+                aria-current={isCurrent ? "step" : undefined}
+                data-testid={testId !== undefined ? `${testId}-step-${i}` : undefined}
+                className={cn(
+                  "flex items-center gap-1.5 rounded-full px-3 py-1 text-sm transition-colors",
+                  isCurrent && "bg-primary font-semibold text-primary-foreground",
+                  isDone && "text-primary",
+                  !isCurrent && !isDone && "text-muted-foreground",
+                )}
+              >
+                {isDone ? (
+                  <>
+                    <Check aria-hidden="true" className="size-3.5" />
+                    <span className="sr-only">{t("kumiko.widget.stepBar.done")}</span>
+                  </>
+                ) : (
+                  <span className="text-xs font-semibold">{i + 1}</span>
+                )}
+                {label}
+              </span>
+            </li>
+          );
+        })}
+      </ol>
+      <p data-testid={compactTestId} className="text-sm text-muted-foreground sm:hidden">
+        {compactLabel}
+      </p>
+    </>
+  );
+}