@streamscloud/kit 0.9.3 → 0.9.5

package/dist/ui/avatar/cmp.avatar.svelte

@@ -1,30 +1,48 @@
 <script lang="ts">import { Image } from '../image';
-let { src = null, name = '', size = 'md', status = null } = $props();
-const initials = $derived(name
+let { src = null, name = '', size = 'md', status = null, badge = null } = $props();
+const deriveInitials = (value) => value
     .split(/\s+/)
     .filter(Boolean)
     .slice(0, 2)
     .map((p) => p[0])
     .join('')
-    .toUpperCase());
+    .toUpperCase();
+const initials = $derived(deriveInitials(name));
+const badgeInitials = $derived(deriveInitials(badge?.name ?? ''));
 </script>
 
+{#snippet personIcon()}
+  <span class="avatar__fallback" aria-hidden="true">
+    <svg class="avatar__fallback-icon" viewBox="0 0 24 24">
+      <circle cx="12" cy="9" r="4" fill="currentColor" opacity="0.6"></circle>
+      <path d="M4 21c0-4 4-7 8-7s8 3 8 7" fill="currentColor" opacity="0.6"></path>
+    </svg>
+  </span>
+{/snippet}
+
 {#snippet fallback()}
   {#if name && initials}
     <span class="avatar__initials">{initials}</span>
   {:else}
-    <span class="avatar__fallback" aria-hidden="true">
-      <svg class="avatar__fallback-icon" viewBox="0 0 24 24">
-        <circle cx="12" cy="9" r="4" fill="currentColor" opacity="0.6"></circle>
-        <path d="M4 21c0-4 4-7 8-7s8 3 8 7" fill="currentColor" opacity="0.6"></path>
-      </svg>
-    </span>
+    {@render personIcon()}
   {/if}
 {/snippet}
 
-<span class="avatar avatar--{size}" class:avatar--with-status={!!status} role="img" aria-label={name || 'Avatar'}>
+{#snippet badgeFallback()}
+  {#if badge?.name && badgeInitials}
+    <span class="avatar__initials avatar__initials--badge">{badgeInitials}</span>
+  {:else}
+    {@render personIcon()}
+  {/if}
+{/snippet}
+
+<span class="avatar avatar--{size}" class:avatar--with-status={!!status && !badge} role="img" aria-label={name || 'Avatar'}>
   <Image src={src} alt={name} showStubOnError stub={fallback} />
-  {#if status}
+  {#if badge}
+    <span class="avatar__badge" role={badge.name ? 'img' : undefined} aria-label={badge.name || undefined} aria-hidden={badge.name ? undefined : true}>
+      <Image src={badge.src ?? null} alt={badge.name ?? ''} showStubOnError stub={badgeFallback} />
+    </span>
+  {:else if status}
     <span class="avatar__dot avatar__dot--{status}" aria-hidden="true"></span>
   {/if}
 </span>
@@ -33,13 +51,16 @@ const initials = $derived(name
 @component
 A circular avatar with three render modes (priority order): image → initials (derived from `name`)
 → generic person icon. If `src` fails to load, automatically falls back to initials/icon. Optional
-status dot in the bottom-right corner. Built on top of the kit `Image` component, which handles
-the load / error / stub state machine.
+status dot in the bottom-right corner, or a square `badge` mini-avatar in the same corner (the
+workspace/org-with-user pattern, same fallback chain at badge scale) — `badge` and `status` are
+mutually exclusive, `badge` wins. Built on top of the kit `Image` component, which handles the
+load / error / stub state machine.
 
 ### CSS Custom Properties
 | Property | Description | Default |
 |---|---|---|
 | `--sc-kit--avatar--size` | Diameter (overrides size preset) | per `size` preset (20 / 24 / 32 / 40 / 56 px) |
+| `--sc-kit--avatar--border-radius` | Avatar shape (set e.g. `--sc-kit--radius--sm` for a rounded square) | `50%` |
 | `--sc-kit--avatar--background` | Fallback container background (initials / icon mode) | `--sc-kit--color--bg--active` |
 | `--sc-kit--avatar--color` | Fallback foreground (generic icon tint) | `--sc-kit--color--text--muted` |
 | `--sc-kit--avatar--initials--background` | Initials chip background | `--sc-kit--color--accent--soft` |
@@ -48,6 +69,9 @@ the load / error / stub state machine.
 | `--sc-kit--avatar--dot--color-online` | Online dot color | `--sc-kit--color--success` |
 | `--sc-kit--avatar--dot--color-busy` | Busy dot color | `--sc-kit--color--danger` |
 | `--sc-kit--avatar--dot--color-offline` | Offline dot color | `--sc-kit--color--text--muted` |
+| `--sc-kit--avatar--badge--size` | Badge mini-avatar box | 45% of the avatar diameter |
+| `--sc-kit--avatar--badge--ring-color` | Badge separation ring (override on active/hover row backgrounds to blend) | `--sc-kit--color--bg--panel` |
+| `--sc-kit--avatar--badge--ring-width` | Badge separation ring thickness | `1.5px` |
 -->
 
 <style>.avatar {
@@ -59,7 +83,11 @@ the load / error / stub state machine.
   --_avatar--dot-online: var(--sc-kit--avatar--dot--color-online, var(--sc-kit--color--success));
   --_avatar--dot-busy: var(--sc-kit--avatar--dot--color-busy, var(--sc-kit--color--danger));
   --_avatar--dot-offline: var(--sc-kit--avatar--dot--color-offline, var(--sc-kit--color--text--muted));
-  --sc-kit--image--border-radius: 50%;
+  --_avatar--badge-size: var(--sc-kit--avatar--badge--size, calc(var(--_avatar--size) * 0.45));
+  --_avatar--badge-ring-color: var(--sc-kit--avatar--badge--ring-color, var(--sc-kit--color--bg--panel));
+  --_avatar--badge-ring-width: var(--sc-kit--avatar--badge--ring-width, 1.5px);
+  --_avatar--border-radius: var(--sc-kit--avatar--border-radius, 50%);
+  --sc-kit--image--border-radius: var(--_avatar--border-radius);
   --sc-kit--image--background: var(--_avatar--background);
   position: relative;
   display: flex;
@@ -67,7 +95,7 @@ the load / error / stub state machine.
   justify-content: center;
   width: var(--_avatar--size);
   height: var(--_avatar--size);
-  border-radius: 50%;
+  border-radius: var(--_avatar--border-radius);
   flex-shrink: 0;
   background: var(--_avatar--background);
   color: var(--_avatar--color);
@@ -91,7 +119,7 @@ the load / error / stub state machine.
 .avatar__initials {
   width: 100%;
   height: 100%;
-  border-radius: 50%;
+  border-radius: var(--_avatar--border-radius);
   display: flex;
   align-items: center;
   justify-content: center;
@@ -102,6 +130,25 @@ the load / error / stub state machine.
   line-height: var(--sc-kit--leading--tight);
   user-select: none;
 }
+.avatar__initials--badge {
+  border-radius: var(--sc-kit--radius--sm);
+  font-size: calc(var(--_avatar--badge-size) * 0.5);
+}
+.avatar__badge {
+  position: absolute;
+  right: -0.125rem;
+  bottom: -0.125rem;
+  width: var(--_avatar--badge-size);
+  height: var(--_avatar--badge-size);
+  border-radius: var(--sc-kit--radius--sm);
+  box-shadow: 0 0 0 var(--_avatar--badge-ring-width) var(--_avatar--badge-ring-color);
+  overflow: hidden;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--_avatar--background);
+  --sc-kit--image--border-radius: var(--sc-kit--radius--sm);
+}
 .avatar__fallback {
   width: 100%;
   height: 100%;

package/dist/ui/avatar/cmp.avatar.svelte.d.ts

@@ -1,5 +1,4 @@
-type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-type AvatarStatus = 'online' | 'busy' | 'offline';
+import type { AvatarData, AvatarSize, AvatarStatus } from './types';
 type Props = {
     /** Image URL. If omitted or fails to load, falls back to initials, then to a generic icon. */
     src?: string | null;
@@ -7,19 +6,24 @@ type Props = {
     name?: string;
     /** Size preset. @default 'md' */
     size?: AvatarSize;
-    /** Optional status dot rendered in the bottom-right corner. */
+    /** Optional status dot rendered in the bottom-right corner. Ignored while `badge` is set — both occupy the same corner. */
     status?: AvatarStatus | null;
+    /** Secondary mini-avatar layered on the bottom-right corner — the workspace/org-with-user pattern. Reuses the image → initials → icon fallback chain at badge scale. Takes the corner over `status`. */
+    badge?: AvatarData | null;
 };
 /**
  * A circular avatar with three render modes (priority order): image → initials (derived from `name`)
  * → generic person icon. If `src` fails to load, automatically falls back to initials/icon. Optional
- * status dot in the bottom-right corner. Built on top of the kit `Image` component, which handles
- * the load / error / stub state machine.
+ * status dot in the bottom-right corner, or a square `badge` mini-avatar in the same corner (the
+ * workspace/org-with-user pattern, same fallback chain at badge scale) — `badge` and `status` are
+ * mutually exclusive, `badge` wins. Built on top of the kit `Image` component, which handles the
+ * load / error / stub state machine.
  *
  * ### CSS Custom Properties
  * | Property | Description | Default |
  * |---|---|---|
  * | `--sc-kit--avatar--size` | Diameter (overrides size preset) | per `size` preset (20 / 24 / 32 / 40 / 56 px) |
+ * | `--sc-kit--avatar--border-radius` | Avatar shape (set e.g. `--sc-kit--radius--sm` for a rounded square) | `50%` |
  * | `--sc-kit--avatar--background` | Fallback container background (initials / icon mode) | `--sc-kit--color--bg--active` |
  * | `--sc-kit--avatar--color` | Fallback foreground (generic icon tint) | `--sc-kit--color--text--muted` |
  * | `--sc-kit--avatar--initials--background` | Initials chip background | `--sc-kit--color--accent--soft` |
@@ -28,6 +32,9 @@ type Props = {
  * | `--sc-kit--avatar--dot--color-online` | Online dot color | `--sc-kit--color--success` |
  * | `--sc-kit--avatar--dot--color-busy` | Busy dot color | `--sc-kit--color--danger` |
  * | `--sc-kit--avatar--dot--color-offline` | Offline dot color | `--sc-kit--color--text--muted` |
+ * | `--sc-kit--avatar--badge--size` | Badge mini-avatar box | 45% of the avatar diameter |
+ * | `--sc-kit--avatar--badge--ring-color` | Badge separation ring (override on active/hover row backgrounds to blend) | `--sc-kit--color--bg--panel` |
+ * | `--sc-kit--avatar--badge--ring-width` | Badge separation ring thickness | `1.5px` |
  */
 declare const Cmp: import("svelte").Component<Props, {}, "">;
 type Cmp = ReturnType<typeof Cmp>;

package/dist/ui/avatar/index.d.ts

@@ -1 +1,2 @@
 export { default as Avatar } from './cmp.avatar.svelte';
+export type { AvatarData, AvatarSize, AvatarStatus } from './types';

package/dist/ui/avatar/types.d.ts

@@ -0,0 +1,8 @@
+export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type AvatarStatus = 'online' | 'busy' | 'offline';
+export type AvatarData = {
+    /** Image URL. `null` / `undefined` skips to the initials → icon fallback chain. */
+    src?: string | null;
+    /** Display name — drives the initials fallback and the accessible label. */
+    name?: string;
+};

package/dist/ui/navigation/cmp.nav-menu-account-row.svelte

@@ -1,18 +1,12 @@
-<script lang="ts">import { Icon } from '../icon';
+<script lang="ts">import { Avatar } from '../avatar';
+import { Icon } from '../icon';
 import IconChevronDown from '@fluentui/svg-icons/icons/chevron_down_20_regular.svg?raw';
-const { name, subtitle, avatar, secondaryAvatar, position = 'top' } = $props();
+const { name, subtitle, avatar, badge = null, position = 'top' } = $props();
 </script>
 
-<div class="nav-menu-account-row" class:nav-menu-account-row--dual={secondaryAvatar} class:nav-menu-account-row--top={position === 'top'}>
-  <span class="nav-menu-account-row__avatar-stack">
-    <span class="nav-menu-account-row__avatar nav-menu-account-row__avatar--primary">
-      {@render avatar()}
-    </span>
-    {#if secondaryAvatar}
-      <span class="nav-menu-account-row__avatar nav-menu-account-row__avatar--secondary">
-        {@render secondaryAvatar()}
-      </span>
-    {/if}
+<div class="nav-menu-account-row" class:nav-menu-account-row--top={position === 'top'}>
+  <span class="nav-menu-account-row__avatar" class:nav-menu-account-row__avatar--dual={!!badge}>
+    <Avatar src={avatar.src} name={avatar.name} badge={badge} />
   </span>
   <span class="nav-menu-account-row__info">
     <span class="nav-menu-account-row__name">{name}</span>
@@ -29,18 +23,13 @@ const { name, subtitle, avatar, secondaryAvatar, position = 'top' } = $props();
 @component
 NavMenuAccountRow — workspace / account trigger row for the top of a `NavMenu` panel. Purely
 presentational: render it inside a `Popover` `trigger` snippet to make it a real switcher. Layout:
-32px avatar on the left, 2-line text (name + subtitle), chevron-down on the right. It owns its own
-padding + hover; for a full-width trigger set `--sc-kit--popover--width: 100%` on the `Popover`.
-
-### CSS Custom Properties
-| Property | Description | Default |
-|---|---|---|
-| `--sc-kit--nav-menu-account-row--avatar-size` | Primary avatar box | `32px` |
-| `--sc-kit--nav-menu-account-row--secondary-avatar-size` | Secondary badge box | `14px` |
+kit `Avatar` on the left at the `md` preset (rounded square; circle + corner badge in
+org-with-user mode when `badge` is set), 2-line text (name + subtitle), chevron-down on the
+right. No public CSS vars of its own — avatar sizing/colors are tuned via the
+`--sc-kit--avatar--*` vars directly. It owns its own padding + hover; for a full-width trigger
+set `--sc-kit--popover--width: 100%` on the `Popover`.
 -->
 <style>.nav-menu-account-row {
-  --_avatar-size: var(--sc-kit--nav-menu-account-row--avatar-size, 2rem);
-  --_secondary-size: var(--sc-kit--nav-menu-account-row--secondary-avatar-size, 0.875rem);
   display: flex;
   align-items: center;
   gap: var(--sc-kit--space--2);
@@ -53,56 +42,17 @@ padding + hover; for a full-width trigger set `--sc-kit--popover--width: 100%` o
 .nav-menu-account-row:hover {
   background: var(--sc-kit--color--bg--hover);
 }
-
 .nav-menu-account-row--top {
   margin-top: var(--sc-kit--space--4);
 }
-
-.nav-menu-account-row__avatar-stack {
-  position: relative;
-  display: inline-flex;
-  width: var(--_avatar-size);
-  height: var(--_avatar-size);
-  flex-shrink: 0;
-}
-
 .nav-menu-account-row__avatar {
+  --sc-kit--avatar--border-radius: var(--sc-kit--radius--sm);
   display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  overflow: hidden;
-  background: var(--sc-kit--color--bg--field-alt);
-  color: var(--sc-kit--color--text--on-accent);
-  font-size: var(--sc-kit--font-size--sm);
-  font-weight: var(--sc-kit--font-weight--semibold);
-}
-.nav-menu-account-row__avatar :global(img) {
-  width: 100%;
-  height: 100%;
-  object-fit: cover;
-}
-
-.nav-menu-account-row__avatar--primary {
-  width: 100%;
-  height: 100%;
-  border-radius: var(--sc-kit--radius--sm);
-}
-
-.nav-menu-account-row--dual .nav-menu-account-row__avatar--primary {
-  border-radius: var(--sc-kit--radius--circle);
+  flex-shrink: 0;
 }
-
-.nav-menu-account-row__avatar--secondary {
-  position: absolute;
-  right: -2px;
-  bottom: -2px;
-  width: var(--_secondary-size);
-  height: var(--_secondary-size);
-  border-radius: var(--sc-kit--radius--sm);
-  box-shadow: 0 0 0 1.5px var(--sc-kit--color--bg--panel);
-  font-size: 0.5rem;
+.nav-menu-account-row__avatar--dual {
+  --sc-kit--avatar--border-radius: 50%;
 }
-
 .nav-menu-account-row__info {
   display: flex;
   flex-direction: column;
@@ -110,7 +60,6 @@ padding + hover; for a full-width trigger set `--sc-kit--popover--width: 100%` o
   min-width: 0;
   gap: 0.125rem;
 }
-
 .nav-menu-account-row__name {
   font-size: var(--sc-kit--font-size--md);
   font-weight: var(--sc-kit--font-weight--semibold);
@@ -121,7 +70,6 @@ padding + hover; for a full-width trigger set `--sc-kit--popover--width: 100%` o
   white-space: nowrap;
   overflow: hidden;
 }
-
 .nav-menu-account-row__subtitle {
   font-size: 0.625rem;
   color: var(--sc-kit--color--text--secondary);
@@ -131,16 +79,11 @@ padding + hover; for a full-width trigger set `--sc-kit--popover--width: 100%` o
   white-space: nowrap;
   overflow: hidden;
 }
-
 .nav-menu-account-row__chevron {
+  --sc-kit--icon--size: 0.75rem;
   flex-shrink: 0;
   display: inline-flex;
   align-items: center;
   justify-content: center;
   color: var(--sc-kit--color--text--secondary);
-}
-.nav-menu-account-row__chevron :global(svg) {
-  width: 0.75rem;
-  height: 0.75rem;
-  fill: currentColor;
 }</style>

package/dist/ui/navigation/cmp.nav-menu-account-row.svelte.d.ts

@@ -1,27 +1,24 @@
-import type { Snippet } from 'svelte';
+import { type AvatarData } from '../avatar';
 type Props = {
     /** Primary line — workspace / account name. Truncates with ellipsis. */
     name: string;
     /** Secondary line — workspace type, role, email, etc. Truncates. */
     subtitle?: string;
-    /** Primary avatar slot (32 × 32px). Renders as a rounded square by default; becomes a circle when `secondaryAvatar` is also provided (org-with-user pattern). */
-    avatar: Snippet;
+    /** Primary avatar data (image → initials → icon fallback). Renders as a rounded square by default; becomes a circle when `badge` is also provided (org-with-user pattern). */
+    avatar: AvatarData;
     /** Optional secondary avatar — square badge layered on the bottom-right of the primary. Use it to show the active user when the primary is the workspace / organization. */
-    secondaryAvatar?: Snippet;
+    badge?: AvatarData | null;
     /** Placement within the menu — `top` adds spacing above so the row clears the panel's top edge; `bottom` leaves it flush (footer use). @default 'top' */
     position?: 'top' | 'bottom';
 };
 /**
  * NavMenuAccountRow — workspace / account trigger row for the top of a `NavMenu` panel. Purely
  * presentational: render it inside a `Popover` `trigger` snippet to make it a real switcher. Layout:
- * 32px avatar on the left, 2-line text (name + subtitle), chevron-down on the right. It owns its own
- * padding + hover; for a full-width trigger set `--sc-kit--popover--width: 100%` on the `Popover`.
- *
- * ### CSS Custom Properties
- * | Property | Description | Default |
- * |---|---|---|
- * | `--sc-kit--nav-menu-account-row--avatar-size` | Primary avatar box | `32px` |
- * | `--sc-kit--nav-menu-account-row--secondary-avatar-size` | Secondary badge box | `14px` |
+ * kit `Avatar` on the left at the `md` preset (rounded square; circle + corner badge in
+ * org-with-user mode when `badge` is set), 2-line text (name + subtitle), chevron-down on the
+ * right. No public CSS vars of its own — avatar sizing/colors are tuned via the
+ * `--sc-kit--avatar--*` vars directly. It owns its own padding + hover; for a full-width trigger
+ * set `--sc-kit--popover--width: 100%` on the `Popover`.
  */
 declare const Cmp: import("svelte").Component<Props, {}, "">;
 type Cmp = ReturnType<typeof Cmp>;

package/dist/ui/stepper-dialog-layout/cmp.stepper-dialog-layout.svelte

@@ -0,0 +1,197 @@
+<script lang="ts" generics="TResult = void, TCancelResult = void">import { Button } from '../button';
+import { Dialog, DialogCloseButton } from '../dialog';
+import { IconSlot } from '../icon';
+import { Stepper } from '../stepper';
+import { StepperDialogLayoutLocalization } from './stepper-dialog-layout-localization';
+let { controller, icon, title, subtitle, steps, canAdvance = () => true, labels, children, on } = $props();
+const localization = new StepperDialogLayoutLocalization();
+let step = $state(0);
+let submitting = $state(false);
+const isFirstStep = $derived(step === 0);
+const isLastStep = $derived(step === steps.length - 1);
+const stepAllowed = $derived(canAdvance(step));
+const showCloseButton = $derived(!controller.settings.nonCancelable);
+const setStep = (next) => {
+    step = next;
+    on.stepChange?.(next);
+};
+const handleNext = async () => {
+    if (!stepAllowed) {
+        return;
+    }
+    if (on.beforeNext && (await on.beforeNext(step)) === false) {
+        return;
+    }
+    setStep(step + 1);
+};
+const handleBack = () => {
+    if (step > 0) {
+        setStep(step - 1);
+    }
+};
+const handleFinish = async () => {
+    if (!stepAllowed || submitting) {
+        return;
+    }
+    submitting = true;
+    try {
+        await on.finish();
+    }
+    catch (error) {
+        console.error('StepperDialogLayout: on.finish threw — surface errors inside the handler', error);
+    }
+    finally {
+        submitting = false;
+    }
+};
+const handleStepClick = (clicked) => {
+    if (clicked < step) {
+        setStep(clicked);
+    }
+};
+</script>
+
+<div class="stepper-dialog-layout">
+  <Dialog controller={controller}>
+    {#snippet headerSection()}
+      <div class="stepper-dialog-layout__header">
+        {#if icon}
+          <span class="stepper-dialog-layout__icon" aria-hidden="true"><IconSlot icon={icon} /></span>
+        {/if}
+        <div class="stepper-dialog-layout__title-block">
+          <div class="stepper-dialog-layout__title">{title}</div>
+          {#if subtitle}
+            <div class="stepper-dialog-layout__subtitle">{subtitle}</div>
+          {/if}
+        </div>
+        {#if showCloseButton}
+          <DialogCloseButton controller={controller} />
+        {/if}
+      </div>
+    {/snippet}
+
+    {#snippet bodySection()}
+      <div class="stepper-dialog-layout__layout">
+        <div class="stepper-dialog-layout__sidebar">
+          <Stepper orientation="vertical" completed="checkmark" current={step} steps={steps} on={{ stepClick: handleStepClick }} />
+        </div>
+        <div class="stepper-dialog-layout__main">
+          <div class="stepper-dialog-layout__body">{@render children(step)}</div>
+        </div>
+      </div>
+    {/snippet}
+
+    {#snippet footer()}
+      <Button type="button" variant="secondary" on={{ click: () => controller.cancel() }}>{labels?.cancel ?? localization.cancel}</Button>
+      {#if !isFirstStep}
+        <Button type="button" variant="ghost" on={{ click: handleBack }}>{labels?.back ?? localization.back}</Button>
+      {/if}
+      {#if isLastStep}
+        <Button type="button" variant="primary" loading={submitting} disabled={!stepAllowed || submitting} on={{ click: () => void handleFinish() }}
+          >{labels?.finish ?? localization.finish}</Button>
+      {:else}
+        <Button type="button" variant="primary" disabled={!stepAllowed} on={{ click: () => void handleNext() }}>{labels?.next ?? localization.next}</Button>
+      {/if}
+    {/snippet}
+  </Dialog>
+</div>
+
+<!--
+@component
+StepperDialogLayout — layout scaffold for multi-step wizard dialog views: header (icon / title /
+subtitle / close), vertical Stepper sidebar, scrollable body, and a Cancel / Back / Next / Finish
+footer. Render it inside your own dialog view opened via `Dialogs.open()` — the layout owns step
+navigation and the submitting state; your `on.finish` owns closing (`controller.ok(...)`).
+Completed sidebar steps are clickable to go back; `canAdvance(step)` gates Next / Finish.
+
+### CSS Custom Properties
+| Property | Description | Default |
+|---|---|---|
+| `--sc-kit--stepper-dialog-layout--sidebar--width` | Stepper sidebar width | `20rem` (320px) |
+| `--sc-kit--stepper-dialog-layout--sidebar--background` | Sidebar background | `--sc-kit--color--bg--field-alt` |
+| `--sc-kit--stepper-dialog-layout--height` | Dialog height (forwarded to `--sc-kit--dialog--height`) | `auto` |
+-->
+
+<style>.stepper-dialog-layout {
+  --_sdl--sidebar-width: var(--sc-kit--stepper-dialog-layout--sidebar--width, functions.to-rem(320));
+  --_sdl--sidebar-background: var(--sc-kit--stepper-dialog-layout--sidebar--background, var(--sc-kit--color--bg--field-alt));
+  --sc-kit--dialog--height: var(--sc-kit--stepper-dialog-layout--height, auto);
+  --sc-kit--dialog--body--overflow-y: auto;
+  display: contents;
+}
+.stepper-dialog-layout__header {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--sc-kit--space--3);
+  padding: var(--sc-kit--space--5) var(--sc-kit--space--6);
+  border-block-end: 1px solid var(--sc-kit--color--border);
+}
+.stepper-dialog-layout__icon {
+  --sc-kit--icon--size: 1.5rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  inline-size: 2.5rem;
+  block-size: 2.5rem;
+  background: var(--sc-kit--color--bg--field-alt);
+  color: var(--sc-kit--color--text--primary);
+  border-radius: var(--sc-kit--radius--md);
+}
+.stepper-dialog-layout__title-block {
+  flex: 1;
+  min-inline-size: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+}
+.stepper-dialog-layout__title {
+  font-size: var(--sc-kit--font-size--lg);
+  font-weight: var(--sc-kit--font-weight--semibold);
+  line-height: var(--sc-kit--leading--tight);
+  color: var(--sc-kit--color--text--primary);
+}
+.stepper-dialog-layout__subtitle {
+  font-size: var(--sc-kit--font-size--sm);
+  color: var(--sc-kit--color--text--muted);
+  line-height: var(--sc-kit--leading--normal);
+}
+.stepper-dialog-layout__layout {
+  display: flex;
+  flex: 1;
+  min-block-size: 0;
+  block-size: 100%;
+}
+@media screen and (max-width: 768px) {
+  .stepper-dialog-layout__layout {
+    flex-direction: column;
+  }
+}
+.stepper-dialog-layout__sidebar {
+  flex: 0 0 var(--_sdl--sidebar-width);
+  padding: var(--sc-kit--space--5) var(--sc-kit--space--4);
+  background: var(--_sdl--sidebar-background);
+  border-inline-end: 1px solid var(--sc-kit--color--border);
+  overflow-y: auto;
+  min-block-size: 0;
+}
+@media screen and (max-width: 768px) {
+  .stepper-dialog-layout__sidebar {
+    flex: 0 0 auto;
+    border-inline-end: none;
+    border-block-end: 1px solid var(--sc-kit--color--border);
+  }
+}
+.stepper-dialog-layout__main {
+  flex: 1 1 auto;
+  display: flex;
+  flex-direction: column;
+  min-inline-size: 0;
+  min-block-size: 0;
+}
+.stepper-dialog-layout__body {
+  flex: 1;
+  min-block-size: 0;
+  overflow-y: auto;
+  padding: var(--sc-kit--space--5) var(--sc-kit--space--6);
+}</style>

package/dist/ui/stepper-dialog-layout/cmp.stepper-dialog-layout.svelte.d.ts

@@ -0,0 +1,66 @@
+import { type DialogController } from '../dialog';
+import { type IconProp } from '../icon';
+import { type Step } from '../stepper';
+import type { Snippet } from 'svelte';
+declare function $$render<TResult = void, TCancelResult = void>(): {
+    props: {
+        controller: DialogController<TResult, TCancelResult>;
+        /** Leading header icon — string SVG source, `{ src, color?, size? }` object, or custom snippet. */
+        icon?: IconProp;
+        title: string;
+        subtitle?: string;
+        steps: Step[];
+        /** Reactive gate for Next / Finish per step index. @default () => true */
+        canAdvance?: (step: number) => boolean;
+        /** Per-button overrides of the localized footer labels. */
+        labels?: {
+            cancel?: string;
+            back?: string;
+            next?: string;
+            finish?: string;
+        };
+        /** Body content; receives the current step index. */
+        children: Snippet<[number]>;
+        on: {
+            /** Owns closing: call `controller.ok(...)` on success; return without closing to keep the dialog open. Surface errors inside the handler — rejections are absorbed (logged), not rethrown. */
+            finish: () => void | Promise<void>;
+            beforeNext?: (step: number) => boolean | void | Promise<boolean | void>;
+            stepChange?: (step: number) => void;
+        };
+    };
+    exports: {};
+    bindings: "";
+    slots: {};
+    events: {};
+};
+declare class __sveltets_Render<TResult = void, TCancelResult = void> {
+    props(): ReturnType<typeof $$render<TResult, TCancelResult>>['props'];
+    events(): ReturnType<typeof $$render<TResult, TCancelResult>>['events'];
+    slots(): ReturnType<typeof $$render<TResult, TCancelResult>>['slots'];
+    bindings(): "";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TResult = void, TCancelResult = void>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TResult, TCancelResult>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TResult, TCancelResult>['props']>, ReturnType<__sveltets_Render<TResult, TCancelResult>['events']>, ReturnType<__sveltets_Render<TResult, TCancelResult>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TResult, TCancelResult>['bindings']>;
+    } & ReturnType<__sveltets_Render<TResult, TCancelResult>['exports']>;
+    <TResult = void, TCancelResult = void>(internal: unknown, props: ReturnType<__sveltets_Render<TResult, TCancelResult>['props']> & {}): ReturnType<__sveltets_Render<TResult, TCancelResult>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any, any>['bindings']>;
+}
+/**
+ * StepperDialogLayout — layout scaffold for multi-step wizard dialog views: header (icon / title /
+ * subtitle / close), vertical Stepper sidebar, scrollable body, and a Cancel / Back / Next / Finish
+ * footer. Render it inside your own dialog view opened via `Dialogs.open()` — the layout owns step
+ * navigation and the submitting state; your `on.finish` owns closing (`controller.ok(...)`).
+ * Completed sidebar steps are clickable to go back; `canAdvance(step)` gates Next / Finish.
+ *
+ * ### CSS Custom Properties
+ * | Property | Description | Default |
+ * |---|---|---|
+ * | `--sc-kit--stepper-dialog-layout--sidebar--width` | Stepper sidebar width | `20rem` (320px) |
+ * | `--sc-kit--stepper-dialog-layout--sidebar--background` | Sidebar background | `--sc-kit--color--bg--field-alt` |
+ * | `--sc-kit--stepper-dialog-layout--height` | Dialog height (forwarded to `--sc-kit--dialog--height`) | `auto` |
+ */
+declare const Cmp: $$IsomorphicComponent;
+type Cmp<TResult = void, TCancelResult = void> = InstanceType<typeof Cmp<TResult, TCancelResult>>;
+export default Cmp;

package/dist/ui/stepper-dialog-layout/index.d.ts

@@ -0,0 +1 @@
+export { default as StepperDialogLayout } from './cmp.stepper-dialog-layout.svelte';

package/dist/ui/stepper-dialog-layout/index.js

@@ -0,0 +1 @@
+export { default as StepperDialogLayout } from './cmp.stepper-dialog-layout.svelte';

package/dist/ui/{stepper-dialog/stepper-dialog-localization.d.ts → stepper-dialog-layout/stepper-dialog-layout-localization.d.ts}

@@ -1,4 +1,4 @@
-export declare class StepperDialogLocalization {
+export declare class StepperDialogLayoutLocalization {
     get cancel(): string;
     get back(): string;
     get next(): string;

package/dist/ui/{stepper-dialog/stepper-dialog-localization.js → stepper-dialog-layout/stepper-dialog-layout-localization.js}

@@ -1,18 +1,4 @@
 import { AppLocale } from '../../core/locale';
-export class StepperDialogLocalization {
-    get cancel() {
-        return loc.cancel[AppLocale.current];
-    }
-    get back() {
-        return loc.back[AppLocale.current];
-    }
-    get next() {
-        return loc.next[AppLocale.current];
-    }
-    get finish() {
-        return loc.finish[AppLocale.current];
-    }
-}
 const loc = {
     cancel: {
         en: 'Cancel',
@@ -31,3 +17,17 @@ const loc = {
         no: 'Fullfør'
     }
 };
+export class StepperDialogLayoutLocalization {
+    get cancel() {
+        return loc.cancel[AppLocale.current];
+    }
+    get back() {
+        return loc.back[AppLocale.current];
+    }
+    get next() {
+        return loc.next[AppLocale.current];
+    }
+    get finish() {
+        return loc.finish[AppLocale.current];
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamscloud/kit",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "author": "StreamsCloud",
   "repository": {
     "type": "git",
@@ -359,9 +359,9 @@
       "types": "./dist/ui/stepper/index.d.ts",
       "svelte": "./dist/ui/stepper/index.js"
     },
-    "./ui/stepper-dialog": {
-      "types": "./dist/ui/stepper-dialog/index.d.ts",
-      "svelte": "./dist/ui/stepper-dialog/index.js"
+    "./ui/stepper-dialog-layout": {
+      "types": "./dist/ui/stepper-dialog-layout/index.d.ts",
+      "svelte": "./dist/ui/stepper-dialog-layout/index.js"
     },
     "./ui/swipe-indicator": {
       "types": "./dist/ui/swipe-indicator/index.d.ts",

package/dist/ui/stepper-dialog/cmp.stepper-dialog.svelte

@@ -1,221 +0,0 @@
-<script lang="ts">import { Button } from '../button';
-import { Dialog, DialogCloseButton } from '../dialog';
-import { Icon } from '../icon';
-import { Stepper } from '../stepper';
-import { StepperDialogLocalization } from './stepper-dialog-localization';
-let { controller, data } = $props();
-const localization = new StepperDialogLocalization();
-let step = $state(0);
-let submitting = $state(false);
-const isFirstStep = $derived(step === 0);
-const isLastStep = $derived(step === data.steps.length - 1);
-const canAdvance = $derived(data.canAdvance(step));
-const showCloseButton = $derived(!controller.settings.nonCancelable);
-const setStep = (i) => {
-    step = i;
-    data.on.stepChange?.(i);
-};
-const handleNext = async () => {
-    if (!canAdvance) {
-        return;
-    }
-    if (data.on.beforeNext) {
-        const result = await data.on.beforeNext(step);
-        if (result === false) {
-            return;
-        }
-    }
-    setStep(step + 1);
-};
-const handleBack = () => {
-    if (step > 0) {
-        setStep(step - 1);
-    }
-};
-const handleFinish = async () => {
-    if (!canAdvance || submitting) {
-        return;
-    }
-    submitting = true;
-    try {
-        await data.on.finish();
-        controller.ok();
-    }
-    finally {
-        submitting = false;
-    }
-};
-const handleStepClick = (i) => {
-    if (i < step) {
-        setStep(i);
-    }
-};
-</script>
-
-{#snippet footerButtons()}
-  <Button type="button" variant="secondary" on={{ click: () => controller.cancel() }}>{data.cancelLabel ?? localization.cancel}</Button>
-  {#if !isFirstStep}
-    <Button type="button" variant="ghost" on={{ click: handleBack }}>{data.backLabel ?? localization.back}</Button>
-  {/if}
-  {#if isLastStep}
-    <Button type="button" variant="primary" loading={submitting} disabled={!canAdvance || submitting} on={{ click: handleFinish }}
-      >{data.finishLabel ?? localization.finish}</Button>
-  {:else}
-    <Button type="button" variant="primary" disabled={!canAdvance} on={{ click: handleNext }}>{data.nextLabel ?? localization.next}</Button>
-  {/if}
-{/snippet}
-
-{#snippet titleRow()}
-  <div class="stepper-dialog__title-row">
-    {#if data.icon}<span class="stepper-dialog__icon" aria-hidden="true"><Icon src={data.icon} /></span>{/if}
-    <div class="stepper-dialog__title-block">
-      <div class="stepper-dialog__title">{data.title}</div>
-      {#if data.subtitle}<div class="stepper-dialog__subtitle">{data.subtitle}</div>{/if}
-    </div>
-    {#if showCloseButton}<DialogCloseButton controller={controller} />{/if}
-  </div>
-{/snippet}
-
-<div
-  class="stepper-dialog stepper-dialog--{data.layout}"
-  style:--sc-kit--dialog--height={data.height}
-  style:--sc-kit--dialog--body--overflow-y={data.height ? 'auto' : null}
-  style:--_stepper-dialog--sidebar-background={data.sidebarBackground}>
-  {#if data.layout === 'side'}
-    <Dialog controller={controller}>
-      {#snippet headerSection()}
-        <div class="stepper-dialog__header stepper-dialog__header--side">
-          {@render titleRow()}
-        </div>
-      {/snippet}
-      {#snippet bodySection()}
-        <div class="stepper-dialog__layout">
-          <div class="stepper-dialog__sidebar">
-            <Stepper orientation="vertical" completed="checkmark" current={step} steps={data.steps} on={{ stepClick: handleStepClick }} />
-          </div>
-          <div class="stepper-dialog__main">
-            <div class="stepper-dialog__body">{@render data.content(step)}</div>
-          </div>
-        </div>
-      {/snippet}
-      {#snippet footer()}{@render footerButtons()}{/snippet}
-    </Dialog>
-  {:else}
-    <Dialog controller={controller}>
-      {#snippet headerSection()}
-        <div class="stepper-dialog__header stepper-dialog__header--top">
-          {@render titleRow()}
-          <div class="stepper-dialog__stepper">
-            <Stepper orientation="horizontal-inline" size="sm" completed="checkmark" current={step} steps={data.steps} on={{ stepClick: handleStepClick }} />
-          </div>
-        </div>
-      {/snippet}
-      {#snippet body()}{@render data.content(step)}{/snippet}
-      {#snippet footer()}{@render footerButtons()}{/snippet}
-    </Dialog>
-  {/if}
-</div>
-
-<!--
-@component
-Internal view for `openStepperDialog`. Renders a multi-step dialog: header (icon + title + subtitle + close),
-a stepper band (top layout) or vertical sidebar (side layout), the current step's body, and a Cancel / Back /
-Next / Finish footer. The dialog owns step navigation and the submitting spinner; the consumer owns step
-content (via `content` snippet) and the finish handler.
-
-Never render this view directly — use the imperative `openStepperDialog(...)` from the module barrel.
--->
-
-<style>.stepper-dialog {
-  --_stepper-dialog--sidebar-width: 20rem;
-  --_stepper-dialog--sidebar-background: var(--sc-kit--color--bg--field-alt);
-  --_stepper-dialog--header-background: var(--sc-kit--color--bg--field-alt);
-  --_stepper-dialog--header-border-color: var(--sc-kit--color--border);
-  display: contents;
-}
-.stepper-dialog__header {
-  display: flex;
-  flex-direction: column;
-}
-.stepper-dialog__header--side {
-  border-bottom: 1px solid var(--_stepper-dialog--header-border-color);
-}
-.stepper-dialog__title-row {
-  display: flex;
-  align-items: flex-start;
-  gap: var(--sc-kit--space--3);
-  padding: var(--sc-kit--space--5) var(--sc-kit--space--6);
-}
-.stepper-dialog__icon {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  flex-shrink: 0;
-  width: 2.5rem;
-  height: 2.5rem;
-  background: var(--sc-kit--color--bg--field-alt);
-  color: var(--sc-kit--color--text--primary);
-  border-radius: var(--sc-kit--radius--md);
-  --sc-kit--icon--size: 1.5rem;
-}
-.stepper-dialog__title-block {
-  flex: 1;
-  min-width: 0;
-  display: flex;
-  flex-direction: column;
-  gap: 0.125rem;
-}
-.stepper-dialog__title {
-  font-size: var(--sc-kit--font-size--lg);
-  font-weight: var(--sc-kit--font-weight--semibold);
-  line-height: var(--sc-kit--leading--tight);
-  color: var(--sc-kit--color--text--primary);
-}
-.stepper-dialog__subtitle {
-  font-size: var(--sc-kit--font-size--sm);
-  color: var(--sc-kit--color--text--muted);
-  line-height: var(--sc-kit--leading--snug);
-}
-.stepper-dialog__stepper {
-  padding: var(--sc-kit--space--2) var(--sc-kit--space--6);
-  background: var(--_stepper-dialog--header-background);
-}
-.stepper-dialog__layout {
-  display: flex;
-  flex: 1;
-  min-height: 0;
-  height: 100%;
-}
-@media screen and (max-width: 768px) {
-  .stepper-dialog__layout {
-    flex-direction: column;
-  }
-}
-.stepper-dialog__sidebar {
-  flex: 0 0 var(--_stepper-dialog--sidebar-width);
-  padding: var(--sc-kit--space--5) var(--sc-kit--space--4);
-  background: var(--_stepper-dialog--sidebar-background);
-  border-right: 1px solid var(--sc-kit--color--border);
-  overflow-y: auto;
-  min-height: 0;
-}
-@media screen and (max-width: 768px) {
-  .stepper-dialog__sidebar {
-    flex: 0 0 auto;
-    border-right: none;
-    border-bottom: 1px solid var(--sc-kit--color--border);
-  }
-}
-.stepper-dialog__main {
-  flex: 1 1 auto;
-  display: flex;
-  flex-direction: column;
-  min-width: 0;
-  min-height: 0;
-}
-.stepper-dialog__body {
-  flex: 1;
-  min-height: 0;
-  overflow-y: auto;
-  padding: var(--sc-kit--space--5) var(--sc-kit--space--6);
-}</style>

package/dist/ui/stepper-dialog/cmp.stepper-dialog.svelte.d.ts

@@ -1,17 +0,0 @@
-import { type DialogController } from '../dialog';
-import type { StepperDialogData } from './types';
-type Props = {
-    controller: DialogController;
-    data: StepperDialogData;
-};
-/**
- * Internal view for `openStepperDialog`. Renders a multi-step dialog: header (icon + title + subtitle + close),
- * a stepper band (top layout) or vertical sidebar (side layout), the current step's body, and a Cancel / Back /
- * Next / Finish footer. The dialog owns step navigation and the submitting spinner; the consumer owns step
- * content (via `content` snippet) and the finish handler.
- *
- * Never render this view directly — use the imperative `openStepperDialog(...)` from the module barrel.
- */
-declare const Cmp: import("svelte").Component<Props, {}, "">;
-type Cmp = ReturnType<typeof Cmp>;
-export default Cmp;

package/dist/ui/stepper-dialog/index.d.ts

@@ -1,2 +0,0 @@
-export { openStepperDialog } from './stepper-dialog';
-export type { StepperDialogData, StepperDialogLayout } from './types';

package/dist/ui/stepper-dialog/index.js

@@ -1 +0,0 @@
-export { openStepperDialog } from './stepper-dialog';

package/dist/ui/stepper-dialog/stepper-dialog.d.ts

@@ -1,22 +0,0 @@
-import { type DialogResult } from '../dialog';
-import type { Step } from '../stepper';
-import type { StepperDialogData, StepperDialogLayout } from './types';
-import type { Snippet } from 'svelte';
-type StepperDialogInit = {
-    icon?: string;
-    title: string;
-    subtitle?: string;
-    steps: Step[];
-    layout?: StepperDialogLayout;
-    sidebarBackground?: string;
-    canAdvance?: (step: number) => boolean;
-    cancelLabel?: string;
-    backLabel?: string;
-    nextLabel?: string;
-    finishLabel?: string;
-    height?: string;
-    content: Snippet<[number]>;
-    on: StepperDialogData['on'];
-};
-export declare const openStepperDialog: (init: StepperDialogInit) => Promise<DialogResult<void>>;
-export {};

package/dist/ui/stepper-dialog/stepper-dialog.js

@@ -1,26 +0,0 @@
-import { Dialogs } from '../dialog';
-import StepperDialogView from './cmp.stepper-dialog.svelte';
-export const openStepperDialog = (init) => {
-    const data = {
-        icon: init.icon,
-        title: init.title,
-        subtitle: init.subtitle,
-        steps: init.steps,
-        layout: init.layout ?? 'top',
-        sidebarBackground: init.sidebarBackground,
-        canAdvance: init.canAdvance ?? (() => true),
-        cancelLabel: init.cancelLabel,
-        backLabel: init.backLabel,
-        nextLabel: init.nextLabel,
-        finishLabel: init.finishLabel,
-        height: init.height,
-        content: init.content,
-        on: init.on
-    };
-    return Dialogs.open({
-        view: StepperDialogView,
-        data,
-        explicitSettings: { closeOnEsc: true, closeOnClickOutside: false },
-        containerSettings: { size: data.layout === 'side' ? 'large' : 'medium' }
-    });
-};

package/dist/ui/stepper-dialog/types.d.ts

@@ -1,34 +0,0 @@
-import type { Step } from '../stepper';
-import type { Snippet } from 'svelte';
-export type StepperDialogLayout = 'top' | 'side';
-export type StepperDialogData = {
-    icon?: string;
-    title: string;
-    subtitle?: string;
-    steps: Step[];
-    layout: StepperDialogLayout;
-    /** Side-layout sidebar background — any valid CSS `background` shorthand. No-op in `'top'` layout. */
-    sidebarBackground?: string;
-    /** Reactive: close over reactive state to enable/disable Next / Finish per step. @default () => true */
-    canAdvance: (step: number) => boolean;
-    /** Override the localized Cancel label. */
-    cancelLabel?: string;
-    /** Override the localized Back label. */
-    backLabel?: string;
-    /** Override the localized Next label. */
-    nextLabel?: string;
-    /** Override the localized Finish label. */
-    finishLabel?: string;
-    /** Fixed dialog height (any CSS length). When set, body scrolls inside the fixed frame. */
-    height?: string;
-    /** Body content — receives the current step index. */
-    content: Snippet<[number]>;
-    on: {
-        /** Called when the user clicks Finish from the last step. Dialog auto-closes with `controller.ok()` after this resolves; throw to keep it open. */
-        finish: () => void | Promise<void>;
-        /** Pre-advance hook. Return `false` to block Next. */
-        beforeNext?: (step: number) => boolean | void | Promise<boolean | void>;
-        /** Fires whenever the internal step index changes. */
-        stepChange?: (step: number) => void;
-    };
-};