@mohasinac/appkit 4.54.0 → 4.55.0-next.0

package/dist/styles.css

@@ -650,6 +650,161 @@
   --appkit-shadow-glow-pink:       0 0 0 1px rgba(244,63,94,0.18), 0 4px 20px -4px rgba(244,63,94,0.30);
 }
 
+/* --- Theme — Technical Dark ([data-theme="technical-dark"]) --------------- */
+/* Developer-tool identity: graphite surfaces, hairline borders, a mono-forward
+   type stack, and accents from a syntax palette (keyword violet, string green,
+   number amber, error red) reused semantically for difficulty badges,
+   submission verdicts and status chips.
+
+   Mirrors src/tokens/themes/technical-dark.ts — values must stay identical or
+   the first paint disagrees with the hydrated theme.
+
+   Contrast on --appkit-color-bg (#0b0d10), measured: text 15.82:1,
+   muted 7.72:1, faint 4.68:1, primary 6.53:1, lowest status 7.01:1. */
+[data-theme="technical-dark"] {
+  --appkit-color-primary:          #7c8cff;
+  --appkit-color-primary-50:       #eef0ff;
+  --appkit-color-primary-100:      #e0e4ff;
+  --appkit-color-primary-200:      #c7cdff;
+  --appkit-color-primary-300:      #a5aeff;
+  --appkit-color-primary-400:      #8e99ff;
+  --appkit-color-primary-500:      #7c8cff;
+  --appkit-color-primary-600:      #5a68e8;
+  --appkit-color-primary-700:      #4650c4;
+  --appkit-color-primary-800:      #373f9c;
+  --appkit-color-primary-900:      #2b317a;
+  --appkit-color-primary-950:      #171a45;
+
+  --appkit-color-secondary:        #56d39a;
+  --appkit-color-secondary-50:     #ecfdf5;
+  --appkit-color-secondary-100:    #d1fae5;
+  --appkit-color-secondary-200:    #a7f3d0;
+  --appkit-color-secondary-300:    #7ee7b8;
+  --appkit-color-secondary-400:    #56d39a;
+  --appkit-color-secondary-500:    #34b87d;
+  --appkit-color-secondary-600:    #1f9664;
+  --appkit-color-secondary-700:    #187752;
+  --appkit-color-secondary-800:    #155e42;
+  --appkit-color-secondary-900:    #124b36;
+  --appkit-color-secondary-950:    #062a1d;
+
+  --appkit-color-bg:               #0b0d10;
+  --appkit-color-surface:          #13161b;
+  --appkit-color-surface-elevated: rgba(19, 22, 27, 0.92);
+  --appkit-color-surface-input:    rgba(27, 31, 38, 0.7);
+
+  --appkit-color-surface-hover:    rgba(148, 163, 184, 0.1);
+  --appkit-color-surface-raised:   rgba(27, 31, 38, 0.8);
+  --appkit-color-primary-surface:  rgba(124, 140, 255, 0.16);
+
+  --appkit-color-border:           #242a33;
+  --appkit-color-border-subtle:    rgba(36, 42, 51, 0.6);
+
+  --appkit-color-text:             #e4e8ee;
+  --appkit-color-text-muted:       #9aa4b2;
+  --appkit-color-text-faint:       #747d8c;
+  /* Dark ink on the violet fill: 6.53:1, where white measures 2.98:1 and
+     fails. Declared here AND in the TS record or first paint disagrees. */
+  --appkit-color-text-on-primary:  #0b0d10;
+
+  --appkit-color-success:          #4ade80;
+  --appkit-color-success-surface:  rgba(22, 101, 68, 0.22);
+  --appkit-color-warning:          #f2b544;
+  --appkit-color-warning-surface:  rgba(120, 78, 10, 0.22);
+  --appkit-color-error:            #ff6b6b;
+  --appkit-color-error-surface:    rgba(140, 30, 30, 0.22);
+  --appkit-color-info:             #58b4ff;
+  --appkit-color-info-surface:     rgba(12, 74, 110, 0.22);
+
+  /* Amber, deliberately not a status or brand hue — a focus ring that doubles
+     as an error colour is unreadable on an invalid field. */
+  --appkit-color-focus-ring:       #ffb86b;
+  --appkit-shadow-glow:            0 0 0 1px rgba(124,140,255,0.14), 0 4px 16px -6px rgba(124,140,255,0.2);
+  --appkit-shadow-glow-pink:       0 0 0 1px rgba(86,211,154,0.14), 0 4px 18px -6px rgba(86,211,154,0.22);
+
+  /* Mono-forward: display/sans are monospace for headings, labels, IDs and
+     tables; editorial carries the reading face for long lesson prose. */
+  --appkit-font-display:           var(--font-mono), "JetBrains Mono", "IBM Plex Mono", ui-monospace, "SFMono-Regular", Consolas, monospace;
+  --appkit-font-sans:              var(--font-mono), "JetBrains Mono", "IBM Plex Mono", ui-monospace, "SFMono-Regular", Consolas, monospace;
+  --appkit-font-editorial:         var(--font-body), ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  --appkit-font-mono:              var(--font-mono), "JetBrains Mono", "IBM Plex Mono", ui-monospace, "SFMono-Regular", Consolas, monospace;
+}
+
+/* --- Theme — Technical Light ([data-theme="technical-light"]) ------------- */
+/* The matched light counterpart. Every accent is RE-DARKENED rather than
+   reused: the dark preset's #7c8cff measures 2.88:1 on this ground and fails
+   AA, and its #ffb86b focus ring measures 1.65:1 — an invisible focus ring is
+   a keyboard trap.
+
+   Mirrors src/tokens/themes/technical-light.ts.
+
+   Contrast on --appkit-color-bg (#fbfbfa), measured: text 17.15:1,
+   muted 5.84:1, faint 4.67:1, primary 5.38:1, lowest status 4.80:1. */
+[data-theme="technical-light"] {
+  --appkit-color-primary:          #4b5bd6;
+  --appkit-color-primary-50:       #eef0ff;
+  --appkit-color-primary-100:      #e0e4ff;
+  --appkit-color-primary-200:      #c7cdff;
+  --appkit-color-primary-300:      #a5aeff;
+  --appkit-color-primary-400:      #7c8cff;
+  --appkit-color-primary-500:      #5a68e8;
+  --appkit-color-primary-600:      #4b5bd6;
+  --appkit-color-primary-700:      #3b45ad;
+  --appkit-color-primary-800:      #2f3789;
+  --appkit-color-primary-900:      #262c6d;
+  --appkit-color-primary-950:      #151840;
+
+  --appkit-color-secondary:        #0f8f5f;
+  --appkit-color-secondary-50:     #ecfdf5;
+  --appkit-color-secondary-100:    #d1fae5;
+  --appkit-color-secondary-200:    #a7f3d0;
+  --appkit-color-secondary-300:    #6ee7b7;
+  --appkit-color-secondary-400:    #34b87d;
+  --appkit-color-secondary-500:    #0f8f5f;
+  --appkit-color-secondary-600:    #0c744d;
+  --appkit-color-secondary-700:    #0a5c3d;
+  --appkit-color-secondary-800:    #084830;
+  --appkit-color-secondary-900:    #063a27;
+  --appkit-color-secondary-950:    #032016;
+
+  --appkit-color-bg:               #fbfbfa;
+  --appkit-color-surface:          #ffffff;
+  --appkit-color-surface-elevated: rgba(255, 255, 255, 0.96);
+  --appkit-color-surface-input:    rgba(244, 244, 242, 0.8);
+
+  --appkit-color-surface-hover:    rgba(22, 24, 29, 0.05);
+  --appkit-color-surface-raised:   rgba(244, 244, 242, 0.9);
+  --appkit-color-primary-surface:  rgba(75, 91, 214, 0.1);
+
+  --appkit-color-border:           #e2e2df;
+  --appkit-color-border-subtle:    rgba(226, 226, 223, 0.7);
+
+  --appkit-color-text:             #16181d;
+  --appkit-color-text-muted:       #5c6370;
+  /* #767d89 measured 4.00:1 — AA for large text only. Darkened to clear AA
+     at body size. */
+  --appkit-color-text-faint:       #6b7280;
+  --appkit-color-text-on-primary:  #ffffff;
+
+  --appkit-color-success:          #13804f;
+  --appkit-color-success-surface:  rgba(19, 128, 79, 0.1);
+  --appkit-color-warning:          #9a6400;
+  --appkit-color-warning-surface:  rgba(154, 100, 0, 0.1);
+  --appkit-color-error:            #c62828;
+  --appkit-color-error-surface:    rgba(198, 40, 40, 0.1);
+  --appkit-color-info:             #0a69b5;
+  --appkit-color-info-surface:     rgba(10, 105, 181, 0.1);
+
+  --appkit-color-focus-ring:       #b45a00;
+  --appkit-shadow-glow:            0 0 0 1px rgba(75,91,214,0.14), 0 4px 16px -6px rgba(75,91,214,0.18);
+  --appkit-shadow-glow-pink:       0 0 0 1px rgba(15,143,95,0.14), 0 4px 18px -6px rgba(15,143,95,0.2);
+
+  --appkit-font-display:           var(--font-mono), "JetBrains Mono", "IBM Plex Mono", ui-monospace, "SFMono-Regular", Consolas, monospace;
+  --appkit-font-sans:              var(--font-mono), "JetBrains Mono", "IBM Plex Mono", ui-monospace, "SFMono-Regular", Consolas, monospace;
+  --appkit-font-editorial:         var(--font-body), ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  --appkit-font-mono:              var(--font-mono), "JetBrains Mono", "IBM Plex Mono", ui-monospace, "SFMono-Regular", Consolas, monospace;
+}
+
 /* --- Typography ----------------------------------------------------------- */
 :root {
   --appkit-font-sans:      var(--font-body), ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
@@ -3481,49 +3636,49 @@
   color: var(--appkit-color-emerald-300);
 }
 
-/**
- * Sign-in gate for money amounts on public listing surfaces.
- *
- * The pending state must occupy the SAME vertical space as a rendered price, or
- * every card in a grid reflows once the session resolves. It is deliberately a
- * silent placeholder rather than a shimmer: the wait is short, and an animated
- * skeleton on 24 cards reads as a page that failed to load.
- */
-.appkit-gated-price__pending {
-  display: inline-block;
-  min-width: 5rem;
-  height: 1.25rem;
-  border-radius: 0.25rem;
-  /* 🛑 `--appkit-color-surface-muted` is NOT a token — 15 uses, 0 definitions,
-     and `audit-undefined-css-vars` ratchets it down. An undefined custom
-     property with no fallback makes the whole declaration invalid, so this
-     placeholder had no background at all and the grid still reflowed on
-     resolve, which is the one job it has. */
-  background: var(--appkit-color-surface-input);
-}
-
-.appkit-gated-price__prompt {
-  display: inline-flex;
-  align-items: center;
-  /*
-   * The eye is a 2rem IconButton while `__pending` above is a 1.25rem price
-   * line, so a GUEST's row grows by 0.75rem once the session resolves. That is
-   * deliberate and is the lesser of the two: the alternative is making
-   * `__pending` 2rem, which shifts the row for SIGNED-IN users — the ones who
-   * end up looking at real content. The guest shift happens once per load and
-   * applies to every card identically, so the grid moves as one rather than
-   * going ragged.
-   */
-  line-height: 1.25rem;
-}
-
-/*
- * 🛑 The eye itself has NO rules here, on purpose. It is an `<IconButton
- * size="sm" variant="outline">`, so its box, ink, hover and focus ring all
- * come from the design system — a second, private set of button styles for
- * one control is exactly how a UI ends up with two kinds of icon button that
- * drift apart. This wrapper only has to keep the row's height stable.
- */
+/**
+ * Sign-in gate for money amounts on public listing surfaces.
+ *
+ * The pending state must occupy the SAME vertical space as a rendered price, or
+ * every card in a grid reflows once the session resolves. It is deliberately a
+ * silent placeholder rather than a shimmer: the wait is short, and an animated
+ * skeleton on 24 cards reads as a page that failed to load.
+ */
+.appkit-gated-price__pending {
+  display: inline-block;
+  min-width: 5rem;
+  height: 1.25rem;
+  border-radius: 0.25rem;
+  /* 🛑 `--appkit-color-surface-muted` is NOT a token — 15 uses, 0 definitions,
+     and `audit-undefined-css-vars` ratchets it down. An undefined custom
+     property with no fallback makes the whole declaration invalid, so this
+     placeholder had no background at all and the grid still reflowed on
+     resolve, which is the one job it has. */
+  background: var(--appkit-color-surface-input);
+}
+
+.appkit-gated-price__prompt {
+  display: inline-flex;
+  align-items: center;
+  /*
+   * The eye is a 2rem IconButton while `__pending` above is a 1.25rem price
+   * line, so a GUEST's row grows by 0.75rem once the session resolves. That is
+   * deliberate and is the lesser of the two: the alternative is making
+   * `__pending` 2rem, which shifts the row for SIGNED-IN users — the ones who
+   * end up looking at real content. The guest shift happens once per load and
+   * applies to every card identically, so the grid moves as one rather than
+   * going ragged.
+   */
+  line-height: 1.25rem;
+}
+
+/*
+ * 🛑 The eye itself has NO rules here, on purpose. It is an `<IconButton
+ * size="sm" variant="outline">`, so its box, ink, hover and focus ring all
+ * come from the design system — a second, private set of button styles for
+ * one control is exactly how a UI ends up with two kinds of icon button that
+ * drift apart. This wrapper only has to keep the row's height stable.
+ */
 
 .appkit-item-row {
   display: flex;
@@ -10180,84 +10335,84 @@
 /* Was ORPHANED — @imported from nowhere, so `.appkit-quick-create-modal` (used
    by QuickCreateModal.tsx) shipped to no one. Found by audit-css-shipped.mjs,
    which exists because FormShell.style.css had the same defect. */
-.appkit-quick-create-modal {
-  position: fixed;
-  inset: 0;
-  z-index: var(--appkit-z-modal, 1000);
-  display: flex;
-  align-items: stretch;
-  justify-content: center;
-}
-
-.appkit-quick-create-modal__backdrop {
-  position: absolute;
-  inset: 0;
-  background: rgb(0 0 0 / 0.45);
-}
-
-.appkit-quick-create-modal__panel {
-  position: relative;
-  display: flex;
-  flex-direction: column;
-  background: var(--appkit-color-surface, #ffffff);
-  color: var(--appkit-color-foreground, inherit);
-  width: 100%;
-  max-width: 560px;
-  margin: auto;
-  max-height: 92vh;
-  border-radius: 0.75rem;
-  box-shadow: var(--appkit-shadow-lg, 0 20px 40px rgb(0 0 0 / 0.25));
-  outline: none;
-}
-
-.appkit-quick-create-modal__header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 1rem 1.25rem;
-  border-bottom: 1px solid var(--appkit-color-border, rgb(0 0 0 / 0.1));
-}
-
-.appkit-quick-create-modal__title {
-  margin: 0;
-  font-size: 1.125rem;
-  font-weight: 600;
-}
-
-.appkit-quick-create-modal__body {
-  flex: 1 1 auto;
-  overflow-y: auto;
-  padding: 1.25rem;
-}
-
-/* Chrome only — layout comes from ActionRow. Re-adding `display: flex` or
-   `justify-content` here would fight the row this class now decorates. */
-.appkit-quick-create-modal__footer {
-  padding: 1rem 1.25rem;
-  border-top: 1px solid var(--appkit-color-border, rgb(0 0 0 / 0.1));
-}
-
-.appkit-quick-create-modal__full-link {
-  font-size: 0.875rem;
-  color: var(--appkit-color-primary, #6366f1);
-  text-decoration: underline;
-}
-
-@media (max-width: 640px) {
-  .appkit-quick-create-modal {
-    align-items: flex-end;
-  }
-  .appkit-quick-create-modal__panel {
-    max-width: 100%;
-    margin: 0;
-    border-radius: 0.75rem 0.75rem 0 0;
-    max-height: 92vh;
-  }
-}
-
-[data-theme="default-dark"] .appkit-quick-create-modal__panel {
-  background: var(--appkit-color-surface-dark, #1e293b);
-}
+.appkit-quick-create-modal {
+  position: fixed;
+  inset: 0;
+  z-index: var(--appkit-z-modal, 1000);
+  display: flex;
+  align-items: stretch;
+  justify-content: center;
+}
+
+.appkit-quick-create-modal__backdrop {
+  position: absolute;
+  inset: 0;
+  background: rgb(0 0 0 / 0.45);
+}
+
+.appkit-quick-create-modal__panel {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  background: var(--appkit-color-surface, #ffffff);
+  color: var(--appkit-color-foreground, inherit);
+  width: 100%;
+  max-width: 560px;
+  margin: auto;
+  max-height: 92vh;
+  border-radius: 0.75rem;
+  box-shadow: var(--appkit-shadow-lg, 0 20px 40px rgb(0 0 0 / 0.25));
+  outline: none;
+}
+
+.appkit-quick-create-modal__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1rem 1.25rem;
+  border-bottom: 1px solid var(--appkit-color-border, rgb(0 0 0 / 0.1));
+}
+
+.appkit-quick-create-modal__title {
+  margin: 0;
+  font-size: 1.125rem;
+  font-weight: 600;
+}
+
+.appkit-quick-create-modal__body {
+  flex: 1 1 auto;
+  overflow-y: auto;
+  padding: 1.25rem;
+}
+
+/* Chrome only — layout comes from ActionRow. Re-adding `display: flex` or
+   `justify-content` here would fight the row this class now decorates. */
+.appkit-quick-create-modal__footer {
+  padding: 1rem 1.25rem;
+  border-top: 1px solid var(--appkit-color-border, rgb(0 0 0 / 0.1));
+}
+
+.appkit-quick-create-modal__full-link {
+  font-size: 0.875rem;
+  color: var(--appkit-color-primary, #6366f1);
+  text-decoration: underline;
+}
+
+@media (max-width: 640px) {
+  .appkit-quick-create-modal {
+    align-items: flex-end;
+  }
+  .appkit-quick-create-modal__panel {
+    max-width: 100%;
+    margin: 0;
+    border-radius: 0.75rem 0.75rem 0 0;
+    max-height: 92vh;
+  }
+}
+
+[data-theme="default-dark"] .appkit-quick-create-modal__panel {
+  background: var(--appkit-color-surface-dark, #1e293b);
+}
 
 /* Last on purpose: hand-mode rules are cross-cutting overrides keyed on
    `[data-hand]`, not a component's own base styles. */
@@ -10321,266 +10476,266 @@
  * bundle-css.mjs flattens only the @import chain rooted here, which is why a
  * stylesheet reachable just from JS never made it in.
  */
-/* ─── FormShell ─────────────────────────────────────────────────────────────── */
-
-.appkit-formshell {
-  display: flex;
-  flex-direction: column;
-  gap: var(--appkit-spacing-6, 1.5rem);
-}
-
-/* Header */
-.appkit-formshell__header {
-  display: flex;
-  flex-direction: column;
-  gap: var(--appkit-spacing-4, 1rem);
-}
-
-.appkit-formshell__title {
-  font-size: var(--appkit-font-size-lg, 1.125rem);
-  font-weight: 600;
-  color: var(--appkit-color-text-primary);
-}
-
-/* ─── Step Indicator ──────────────────────────────────────────────────────── */
-
-.appkit-formshell__step-indicator {
-  display: flex;
-  flex-wrap: wrap;
-  gap: var(--appkit-spacing-1, 0.25rem);
-  border-bottom: 1px solid var(--appkit-color-border);
-  padding-bottom: var(--appkit-spacing-3, 0.75rem);
-}
-
-.appkit-formshell__step-btn {
-  display: flex;
-  align-items: center;
-  gap: var(--appkit-spacing-2, 0.5rem);
-  padding: var(--appkit-spacing-1-5, 0.375rem) var(--appkit-spacing-3, 0.75rem);
-  border-radius: var(--appkit-radius-md, 0.375rem);
-  background: transparent;
-  border: 1px solid transparent;
-  color: var(--appkit-color-text-secondary);
-  cursor: pointer;
-  font-size: var(--appkit-font-size-sm, 0.875rem);
-  transition: background 0.15s, border-color 0.15s, color 0.15s;
-}
-
-.appkit-formshell__step-btn:hover {
-  background: var(--appkit-color-surface-hover);
-  border-color: var(--appkit-color-border);
-}
-
-.appkit-formshell__step-btn--active {
-  background: var(--appkit-color-primary-subtle, rgb(from var(--appkit-color-primary) r g b / 0.1));
-  border-color: var(--appkit-color-primary);
-  color: var(--appkit-color-primary);
-  font-weight: 500;
-}
-
-.appkit-formshell__step-btn--error {
-  color: var(--appkit-color-error, #dc2626);
-  border-color: var(--appkit-color-error, #dc2626);
-}
-
-.appkit-formshell__step-dot {
-  position: relative;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  width: 1.5rem;
-  height: 1.5rem;
-  border-radius: 9999px;
-  background: var(--appkit-color-surface-secondary);
-  font-size: var(--appkit-font-size-xs, 0.75rem);
-  font-weight: 600;
-  flex-shrink: 0;
-}
-
-.appkit-formshell__step-btn--active .appkit-formshell__step-dot {
-  background: var(--appkit-color-primary);
-  color: #fff;
-}
-
-.appkit-formshell__step-btn--error .appkit-formshell__step-dot {
-  background: var(--appkit-color-error, #dc2626);
-  color: #fff;
-}
-
-/* Red dot badge on step dot */
-.appkit-formshell__step-error-badge {
-  position: absolute;
-  top: -3px;
-  right: -3px;
-  width: 8px;
-  height: 8px;
-  border-radius: 9999px;
-  background: var(--appkit-color-error, #dc2626);
-  border: 2px solid var(--appkit-color-surface);
-}
-
-/* Inline error count badge (accordion header) */
-.appkit-formshell__step-error-badge--inline {
-  position: static;
-  width: auto;
-  height: auto;
-  border-radius: var(--appkit-radius-full, 9999px);
-  padding: 0 0.375rem;
-  font-size: var(--appkit-font-size-xs, 0.75rem);
-  font-weight: 600;
-  color: #fff;
-  line-height: 1.4;
-  border: none;
-}
-
-.appkit-formshell__step-label {
-  display: none;
-}
-
-@media (min-width: 640px) {
-  .appkit-formshell__step-label {
-    display: inline;
-  }
-}
-
-/* ─── Error Summary ───────────────────────────────────────────────────────── */
-
-.appkit-formshell__error-summary {
-  border: 1px solid var(--appkit-color-error, #dc2626);
-  border-radius: var(--appkit-radius-md, 0.375rem);
-  padding: var(--appkit-spacing-3, 0.75rem);
-  background: rgb(from var(--appkit-color-error, #dc2626) r g b / 0.05);
-}
-
-.appkit-formshell__error-summary__title {
-  font-weight: 600;
-  margin-bottom: var(--appkit-spacing-2, 0.5rem);
-}
-
-.appkit-formshell__error-summary__list {
-  list-style: disc;
-  padding-left: 1.25rem;
-  display: flex;
-  flex-direction: column;
-  gap: var(--appkit-spacing-1, 0.25rem);
-}
-
-.appkit-formshell__error-summary__step-link {
-  background: none;
-  border: none;
-  padding: 0;
-  margin: 0;
-  font: inherit;
-  color: inherit;
-  text-align: left;
-  cursor: pointer;
-  text-decoration: underline;
-  text-underline-offset: 2px;
-}
-
-.appkit-formshell__error-summary__step-link:hover {
-  color: var(--appkit-color-error, #dc2626);
-}
-
-/* ─── Body + Steps ───────────────────────────────────────────────────────── */
-
-.appkit-formshell__body {
-  flex: 1;
-  /* Ensure body content is not hidden under the sticky footer. The footer is
-     ~56px tall; add generous padding so the last field is always reachable. */
-  padding-bottom: 5rem;
-}
-
-.appkit-formshell__steps {
-  display: flex;
-  flex-direction: column;
-  gap: var(--appkit-spacing-1, 0.25rem);
-}
-
-.appkit-formshell__step {
-  border: 1px solid var(--appkit-color-border);
-  border-radius: var(--appkit-radius-md, 0.375rem);
-  overflow: hidden;
-}
-
-.appkit-formshell__step--active {
-  border-color: var(--appkit-color-primary);
-}
-
-.appkit-formshell__step--error {
-  border-color: var(--appkit-color-error, #dc2626);
-}
-
-/* Mobile accordion button — hidden on lg+ (step indicator handles navigation) */
-.appkit-formshell__step-accordion-btn {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  width: 100%;
-  padding: var(--appkit-spacing-3, 0.75rem) var(--appkit-spacing-4, 1rem);
-  background: var(--appkit-color-surface-secondary);
-  border: none;
-  cursor: pointer;
-  font-size: var(--appkit-font-size-sm, 0.875rem);
-  font-weight: 500;
-  color: var(--appkit-color-text-primary);
-  text-align: left;
-}
-
-.appkit-formshell__step-accordion-label {
-  flex: 1;
-}
-
-/* On lg+ the accordion controls are purely decorative; the step indicator drives navigation */
-@media (min-width: 1024px) {
-  .appkit-formshell--accordion-mobile .appkit-formshell__step-accordion-btn {
-    display: none;
-  }
-
-  .appkit-formshell--accordion-mobile .appkit-formshell__step [hidden] {
-    display: block !important;
-  }
-
-  .appkit-formshell--accordion-mobile .appkit-formshell__step-content {
-    display: block !important;
-  }
-}
-
-.appkit-formshell__step-content {
-  padding: 0.75rem 1.25rem;
-}
-
-@media (max-width: 639px) {
-  .appkit-formshell__step-content {
-    padding: 0.5rem 0.875rem;
-  }
-}
-/* --- Footer --------------------------------------------------------------- */
-
-/*
- * `.appkit-formshell__footer`, `__step-nav` and `__actions` were deleted here:
- * `ui/forms/FormShell.tsx` is context/state only and renders no footer JSX, so
- * nothing had referenced them for a long time. The real form footer lives in
- * `features/shell/FormShell.tsx` and is an ActionRow now.
- *
- * Worth recording: this dead block held the ONLY `flex-wrap: wrap` on any
- * action row in the codebase. Every live footer had lost it.
- */
-
-/* ─── Dark mode ──────────────────────────────────────────────────────────── */
-
-.dark .appkit-formshell__title {
-  color: var(--appkit-color-text-primary-dark, inherit);
-}
-
-.dark .appkit-formshell__step-accordion-btn {
-  background: var(--appkit-color-surface-secondary-dark, var(--appkit-color-surface-secondary));
-  color: var(--appkit-color-text-primary-dark, inherit);
-}
-
-.dark .appkit-formshell__error-summary {
-  background: rgb(from var(--appkit-color-error, #dc2626) r g b / 0.1);
-}
+/* ─── FormShell ─────────────────────────────────────────────────────────────── */
+
+.appkit-formshell {
+  display: flex;
+  flex-direction: column;
+  gap: var(--appkit-spacing-6, 1.5rem);
+}
+
+/* Header */
+.appkit-formshell__header {
+  display: flex;
+  flex-direction: column;
+  gap: var(--appkit-spacing-4, 1rem);
+}
+
+.appkit-formshell__title {
+  font-size: var(--appkit-font-size-lg, 1.125rem);
+  font-weight: 600;
+  color: var(--appkit-color-text-primary);
+}
+
+/* ─── Step Indicator ──────────────────────────────────────────────────────── */
+
+.appkit-formshell__step-indicator {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--appkit-spacing-1, 0.25rem);
+  border-bottom: 1px solid var(--appkit-color-border);
+  padding-bottom: var(--appkit-spacing-3, 0.75rem);
+}
+
+.appkit-formshell__step-btn {
+  display: flex;
+  align-items: center;
+  gap: var(--appkit-spacing-2, 0.5rem);
+  padding: var(--appkit-spacing-1-5, 0.375rem) var(--appkit-spacing-3, 0.75rem);
+  border-radius: var(--appkit-radius-md, 0.375rem);
+  background: transparent;
+  border: 1px solid transparent;
+  color: var(--appkit-color-text-secondary);
+  cursor: pointer;
+  font-size: var(--appkit-font-size-sm, 0.875rem);
+  transition: background 0.15s, border-color 0.15s, color 0.15s;
+}
+
+.appkit-formshell__step-btn:hover {
+  background: var(--appkit-color-surface-hover);
+  border-color: var(--appkit-color-border);
+}
+
+.appkit-formshell__step-btn--active {
+  background: var(--appkit-color-primary-subtle, rgb(from var(--appkit-color-primary) r g b / 0.1));
+  border-color: var(--appkit-color-primary);
+  color: var(--appkit-color-primary);
+  font-weight: 500;
+}
+
+.appkit-formshell__step-btn--error {
+  color: var(--appkit-color-error, #dc2626);
+  border-color: var(--appkit-color-error, #dc2626);
+}
+
+.appkit-formshell__step-dot {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.5rem;
+  height: 1.5rem;
+  border-radius: 9999px;
+  background: var(--appkit-color-surface-secondary);
+  font-size: var(--appkit-font-size-xs, 0.75rem);
+  font-weight: 600;
+  flex-shrink: 0;
+}
+
+.appkit-formshell__step-btn--active .appkit-formshell__step-dot {
+  background: var(--appkit-color-primary);
+  color: #fff;
+}
+
+.appkit-formshell__step-btn--error .appkit-formshell__step-dot {
+  background: var(--appkit-color-error, #dc2626);
+  color: #fff;
+}
+
+/* Red dot badge on step dot */
+.appkit-formshell__step-error-badge {
+  position: absolute;
+  top: -3px;
+  right: -3px;
+  width: 8px;
+  height: 8px;
+  border-radius: 9999px;
+  background: var(--appkit-color-error, #dc2626);
+  border: 2px solid var(--appkit-color-surface);
+}
+
+/* Inline error count badge (accordion header) */
+.appkit-formshell__step-error-badge--inline {
+  position: static;
+  width: auto;
+  height: auto;
+  border-radius: var(--appkit-radius-full, 9999px);
+  padding: 0 0.375rem;
+  font-size: var(--appkit-font-size-xs, 0.75rem);
+  font-weight: 600;
+  color: #fff;
+  line-height: 1.4;
+  border: none;
+}
+
+.appkit-formshell__step-label {
+  display: none;
+}
+
+@media (min-width: 640px) {
+  .appkit-formshell__step-label {
+    display: inline;
+  }
+}
+
+/* ─── Error Summary ───────────────────────────────────────────────────────── */
+
+.appkit-formshell__error-summary {
+  border: 1px solid var(--appkit-color-error, #dc2626);
+  border-radius: var(--appkit-radius-md, 0.375rem);
+  padding: var(--appkit-spacing-3, 0.75rem);
+  background: rgb(from var(--appkit-color-error, #dc2626) r g b / 0.05);
+}
+
+.appkit-formshell__error-summary__title {
+  font-weight: 600;
+  margin-bottom: var(--appkit-spacing-2, 0.5rem);
+}
+
+.appkit-formshell__error-summary__list {
+  list-style: disc;
+  padding-left: 1.25rem;
+  display: flex;
+  flex-direction: column;
+  gap: var(--appkit-spacing-1, 0.25rem);
+}
+
+.appkit-formshell__error-summary__step-link {
+  background: none;
+  border: none;
+  padding: 0;
+  margin: 0;
+  font: inherit;
+  color: inherit;
+  text-align: left;
+  cursor: pointer;
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+.appkit-formshell__error-summary__step-link:hover {
+  color: var(--appkit-color-error, #dc2626);
+}
+
+/* ─── Body + Steps ───────────────────────────────────────────────────────── */
+
+.appkit-formshell__body {
+  flex: 1;
+  /* Ensure body content is not hidden under the sticky footer. The footer is
+     ~56px tall; add generous padding so the last field is always reachable. */
+  padding-bottom: 5rem;
+}
+
+.appkit-formshell__steps {
+  display: flex;
+  flex-direction: column;
+  gap: var(--appkit-spacing-1, 0.25rem);
+}
+
+.appkit-formshell__step {
+  border: 1px solid var(--appkit-color-border);
+  border-radius: var(--appkit-radius-md, 0.375rem);
+  overflow: hidden;
+}
+
+.appkit-formshell__step--active {
+  border-color: var(--appkit-color-primary);
+}
+
+.appkit-formshell__step--error {
+  border-color: var(--appkit-color-error, #dc2626);
+}
+
+/* Mobile accordion button — hidden on lg+ (step indicator handles navigation) */
+.appkit-formshell__step-accordion-btn {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  padding: var(--appkit-spacing-3, 0.75rem) var(--appkit-spacing-4, 1rem);
+  background: var(--appkit-color-surface-secondary);
+  border: none;
+  cursor: pointer;
+  font-size: var(--appkit-font-size-sm, 0.875rem);
+  font-weight: 500;
+  color: var(--appkit-color-text-primary);
+  text-align: left;
+}
+
+.appkit-formshell__step-accordion-label {
+  flex: 1;
+}
+
+/* On lg+ the accordion controls are purely decorative; the step indicator drives navigation */
+@media (min-width: 1024px) {
+  .appkit-formshell--accordion-mobile .appkit-formshell__step-accordion-btn {
+    display: none;
+  }
+
+  .appkit-formshell--accordion-mobile .appkit-formshell__step [hidden] {
+    display: block !important;
+  }
+
+  .appkit-formshell--accordion-mobile .appkit-formshell__step-content {
+    display: block !important;
+  }
+}
+
+.appkit-formshell__step-content {
+  padding: 0.75rem 1.25rem;
+}
+
+@media (max-width: 639px) {
+  .appkit-formshell__step-content {
+    padding: 0.5rem 0.875rem;
+  }
+}
+/* --- Footer --------------------------------------------------------------- */
+
+/*
+ * `.appkit-formshell__footer`, `__step-nav` and `__actions` were deleted here:
+ * `ui/forms/FormShell.tsx` is context/state only and renders no footer JSX, so
+ * nothing had referenced them for a long time. The real form footer lives in
+ * `features/shell/FormShell.tsx` and is an ActionRow now.
+ *
+ * Worth recording: this dead block held the ONLY `flex-wrap: wrap` on any
+ * action row in the codebase. Every live footer had lost it.
+ */
+
+/* ─── Dark mode ──────────────────────────────────────────────────────────── */
+
+.dark .appkit-formshell__title {
+  color: var(--appkit-color-text-primary-dark, inherit);
+}
+
+.dark .appkit-formshell__step-accordion-btn {
+  background: var(--appkit-color-surface-secondary-dark, var(--appkit-color-surface-secondary));
+  color: var(--appkit-color-text-primary-dark, inherit);
+}
+
+.dark .appkit-formshell__error-summary {
+  background: rgb(from var(--appkit-color-error, #dc2626) r g b / 0.1);
+}
 
 /*
  * Third-party stylesheet, vendored into dist/vendor by copy-assets.mjs.