@morscherlab/mint-sdk 1.1.4 → 1.1.6

package/src/styles/components/modal.css

@@ -217,6 +217,293 @@
   gap: 0.5rem;
 }
 
+/* ========================================================================
+   Tab strip (layout="tabs")
+   ========================================================================
+   A shell region, not body content: full-bleed, flush with both edges,
+   never scrolls with the fields.
+   ======================================================================== */
+
+.mint-modal__tabs {
+  flex-shrink: 0;
+  display: flex;
+  gap: 2px;
+  padding: 0 0.75rem;
+  background-color: var(--bg-card);
+  border-bottom: 1px solid var(--border-color);
+  overflow-x: auto;
+  scrollbar-width: none;
+}
+
+.mint-modal__tabs::-webkit-scrollbar {
+  display: none;
+}
+
+.mint-modal__tab {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4375rem;
+  height: 2.375rem;              /* 38px */
+  padding: 0 0.75rem;
+  border: none;
+  background: transparent;
+  font-family: inherit;
+  font-size: 0.8125rem;          /* 13px */
+  font-weight: 500;
+  color: var(--text-secondary);
+  cursor: pointer;
+  /* Underline drawn INSIDE the box — no margin-bottom:-1px overlap hack. */
+  transition: color var(--mint-transition), box-shadow var(--mint-transition);
+}
+
+.mint-modal__tab:hover:not(.mint-modal__tab--disabled) {
+  color: var(--text-primary);
+}
+
+.mint-modal__tab--active {
+  color: var(--color-primary);
+  font-weight: 600;
+  box-shadow: inset 0 -2px 0 var(--color-primary);
+}
+
+.mint-modal__tab--disabled {
+  color: var(--text-muted);
+  cursor: not-allowed;
+}
+
+.mint-modal__tab:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-soft), inset 0 -2px 0 var(--color-primary);
+}
+
+.mint-modal__tab-meta {
+  font-family: 'Fira Code', monospace;
+  font-size: 0.6875rem;
+  font-weight: 400;
+  color: var(--text-muted);
+}
+
+/* Fixed body height: switching tabs must not resize the card. */
+.mint-modal__body--tabbed {
+  height: clamp(14rem, 45vh, 26rem);
+  overflow-y: auto;
+}
+
+/* Header rule is redundant once a strip or rail follows it. */
+.mint-modal__container--tabs .mint-modal__header,
+.mint-modal__container--rail .mint-modal__header {
+  border-bottom: none;
+}
+
+/* ========================================================================
+   Rail (layout="rail") — sidebar sections + pane as the shell's middle row
+   ======================================================================== */
+
+.mint-modal__split {
+  flex: 1;
+  min-height: 0;
+  display: grid;
+  grid-template-columns: 13.5rem minmax(0, 1fr);
+  height: clamp(20rem, 62vh, 34rem);
+}
+
+.mint-modal__rail {
+  display: flex;
+  flex-direction: column;
+  gap: 0.625rem;
+  padding: 0.625rem 0.5rem;
+  background-color: var(--bg-primary);
+  border-right: 1px solid var(--border-light);
+  overflow-y: auto;            /* rail scrolls independently of the pane */
+  scrollbar-width: thin;
+}
+
+.mint-modal__rail-items {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.mint-modal__rail-item {
+  display: flex;
+  align-items: center;
+  gap: 0.5625rem;
+  width: 100%;
+  min-height: 2.25rem;
+  padding: 0.4375rem 0.625rem;
+  border: none;
+  border-radius: 0.4375rem;
+  background: transparent;
+  font-family: inherit;
+  font-size: 0.8125rem;
+  font-weight: 500;
+  color: var(--text-secondary);
+  text-align: left;
+  cursor: pointer;
+  transition: background-color var(--mint-transition), color var(--mint-transition);
+}
+
+.mint-modal__rail-item:hover:not(.mint-modal__rail-item--disabled) {
+  background-color: var(--bg-tertiary);
+}
+
+.mint-modal__rail-item:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-soft);
+}
+
+/* Active = raised card, matching the 1.1 card language (not a primary fill). */
+.mint-modal__rail-item--active {
+  background-color: var(--bg-card);
+  color: var(--text-primary);
+  font-weight: 600;
+  box-shadow: 0 1px 2px rgba(15, 23, 42, 0.08);
+}
+
+.mint-modal__rail-item--disabled {
+  color: var(--text-muted);
+  cursor: not-allowed;
+}
+
+.mint-modal__rail-item-icon {
+  flex-shrink: 0;
+  width: 0.9375rem;
+  height: 0.9375rem;
+  color: var(--text-muted);
+}
+
+.mint-modal__rail-item-icon svg {
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+
+/* v-html markup icons arrive wrapped in a span — size it like the svg. */
+.mint-modal__rail-item-icon > span {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+.mint-modal__rail-item--active .mint-modal__rail-item-icon {
+  color: var(--color-primary);
+}
+
+.mint-modal__rail-item-text {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.0625rem;
+}
+
+.mint-modal__rail-item-label {
+  line-height: 1.3;
+  overflow-wrap: anywhere;
+}
+
+.mint-modal__rail-item-description {
+  font-size: 0.6875rem;
+  font-weight: 400;
+  color: var(--text-muted);
+  line-height: 1.35;
+}
+
+.mint-modal__rail-item-meta {
+  flex-shrink: 0;
+  font-family: 'Fira Code', monospace;
+  font-size: 0.6875rem;
+  font-weight: 400;
+  color: var(--text-muted);
+}
+
+/* ---------- Pane ---------- */
+
+.mint-modal__pane {
+  min-width: 0;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+
+.mint-modal__pane:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-soft);
+}
+
+.mint-modal__pane-header {
+  flex-shrink: 0;
+  padding: 0.875rem 1.25rem 0.75rem;
+  border-bottom: 1px solid var(--border-light);
+}
+
+.mint-modal__pane-title {
+  margin: 0 !important;
+  padding: 0 !important;
+  font-size: 0.875rem;
+  font-weight: 600;
+  letter-spacing: -0.005em;
+  color: var(--text-primary);
+  line-height: 1.3;
+}
+
+.mint-modal__pane-subtitle {
+  margin: 0.1875rem 0 0 !important;
+  padding: 0 !important;
+  font-size: 0.75rem;
+  color: var(--text-secondary);
+  line-height: 1.45;
+}
+
+.mint-modal__pane-body {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  padding: 0.875rem 1.25rem 1.125rem;
+  font-size: 0.8125rem;
+  color: var(--text-primary);
+  line-height: 1.55;
+}
+
+/* Rail collapses to the tab-strip pattern on narrow screens — one behaviour. */
+@media (max-width: 640px) {
+  .mint-modal__split {
+    grid-template-columns: minmax(0, 1fr);
+    height: auto;
+  }
+
+  .mint-modal__rail {
+    flex-direction: row;
+    align-items: center;
+    gap: 0.25rem;
+    padding: 0 0.5rem;
+    border-right: none;
+    border-bottom: 1px solid var(--border-color);
+    overflow-x: auto;
+    overflow-y: hidden;
+  }
+
+  .mint-modal__rail-items {
+    flex-direction: row;
+  }
+
+  .mint-modal__rail-item {
+    width: auto;
+    min-height: 2.375rem;
+  }
+
+  /* Strip stays compact */
+  .mint-modal__rail-item-description {
+    display: none;
+  }
+
+  .mint-modal__pane-body {
+    max-height: 60vh;
+  }
+}
+
 /* ========================================================================
    Per-variant transitions
    ========================================================================
@@ -350,4 +637,10 @@
   .modal-drawer-leave-to .mint-modal__container {
     transform: translateY(100%);
   }
+
+  /* Sheets keep their natural height; the strip already scrolls horizontally */
+  .mint-modal__body--tabbed {
+    height: auto;
+    max-height: 60vh;
+  }
 }

package/src/styles/components/settings-modal.css

@@ -1,4 +1,6 @@
-/* SettingsModal Component Styles */
+/* SettingsModal Component Styles
+   Tab strip / rail / pane / footer chrome lives in BaseModal (modal.css);
+   only pane content styles remain here. */
 
 .mint-settings-modal {
   display: flex;
@@ -7,40 +9,6 @@
   min-height: 0;
 }
 
-.mint-settings-modal__tabs {
-  display: flex;
-  gap: 0.25rem;
-  border-bottom: 1px solid var(--border-color);
-  padding-bottom: 0;
-  margin-bottom: 0.5rem;
-}
-
-.mint-settings-modal__tab {
-  padding: 0.5rem 1rem;
-  font-size: 0.875rem;
-  font-weight: 500;
-  color: var(--text-muted);
-  background: none;
-  border: none;
-  border-bottom: 2px solid transparent;
-  cursor: pointer;
-  transition: color 0.15s ease, border-color 0.15s ease;
-  margin-bottom: -1px;
-}
-
-.mint-settings-modal__tab:hover {
-  color: var(--text-primary);
-}
-
-.mint-settings-modal__tab--active {
-  color: var(--color-primary);
-  border-bottom-color: var(--color-primary);
-}
-
-.mint-settings-modal__content {
-  min-height: 12rem;
-}
-
 .mint-settings-modal__section {
   margin-bottom: 1.5rem;
 }
@@ -95,15 +63,6 @@ html.dark .mint-settings-modal__option-btn--active {
   padding: 0 !important;
 }
 
-.mint-settings-modal__footer {
-  display: flex;
-  flex-direction: column;
-  gap: 0.75rem;
-  margin-top: 1rem;
-  padding-top: 1rem;
-  border-top: 1px solid var(--border-light);
-}
-
 /* ─────────────────────────────────────────────────────────────────────
  * Schema-driven content grid (used by both layouts)
  * Cols come from `--mint-settings-cols` set inline by the component;
@@ -115,232 +74,3 @@ html.dark .mint-settings-modal__option-btn--active {
   gap: 1rem;
   grid-template-columns: repeat(var(--mint-settings-cols, 1), minmax(0, 1fr));
 }
-
-/* ─────────────────────────────────────────────────────────────────────
- * Vertical layout — sidebar rail + content pane (opt-in via layout="vertical")
- * Designed for complex plugins with 5+ setting groups. Existing horizontal
- * classes above are deliberately untouched.
- * ───────────────────────────────────────────────────────────────────── */
-
-.mint-settings-modal--vertical {
-  flex-direction: row;
-  gap: 1.25rem;
-  align-items: stretch;
-  height: clamp(22rem, calc(100vh - 9rem), 42rem);
-  min-height: 22rem;
-  overflow: hidden;
-}
-
-.mint-settings-modal__rail {
-  flex-shrink: 0;
-  width: 12.5rem;
-  display: flex;
-  flex-direction: column;
-  gap: 0.125rem;
-  padding: 0.125rem 0.75rem 0.125rem 0;
-  border-right: 1px solid var(--border-light);
-  overflow: hidden;
-}
-
-.mint-settings-modal__rail-item {
-  position: relative;
-  display: flex;
-  align-items: flex-start;
-  gap: 0.625rem;
-  width: 100%;
-  min-height: 2.5rem;
-  padding: 0.5rem 0.75rem 0.5rem 0.875rem;
-  font-size: 0.8125rem;
-  font-weight: 500;
-  color: var(--text-secondary);
-  background: none;
-  border: none;
-  border-radius: var(--radius-md);
-  cursor: pointer;
-  text-align: left;
-  transition:
-    color var(--mint-transition),
-    background-color var(--mint-transition);
-}
-
-.mint-settings-modal__rail-item:hover {
-  background-color: var(--bg-hover);
-  color: var(--text-primary);
-}
-
-.mint-settings-modal__rail-item:focus-visible {
-  outline: none;
-  box-shadow: var(--focus-ring);
-}
-
-.mint-settings-modal__rail-item--active {
-  color: var(--color-primary);
-  background-color: color-mix(in srgb, var(--color-primary) 10%, transparent);
-}
-
-.mint-settings-modal__rail-item--active::before {
-  content: "";
-  position: absolute;
-  left: 0.375rem;
-  top: 0.625rem;
-  bottom: 0.625rem;
-  width: 2px;
-  border-radius: 9999px;
-  background-color: var(--color-primary);
-}
-
-html.dark .mint-settings-modal__rail-item--active {
-  background-color: color-mix(in srgb, var(--color-primary) 18%, transparent);
-}
-
-/* Reserved icon column keeps labels aligned whether or not icons are present */
-.mint-settings-modal__rail-item-icon {
-  flex-shrink: 0;
-  width: 1rem;
-  height: 1rem;
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  margin-top: 0.0625rem;
-  color: currentColor;
-}
-
-.mint-settings-modal__rail-item-icon svg {
-  width: 100%;
-  height: 100%;
-  display: block;
-}
-
-.mint-settings-modal__rail-item-text {
-  display: flex;
-  flex-direction: column;
-  gap: 0.125rem;
-  min-width: 0;
-  flex: 1;
-}
-
-.mint-settings-modal__rail-item-label {
-  line-height: 1.3;
-  overflow-wrap: anywhere;
-}
-
-.mint-settings-modal__rail-item-description {
-  font-size: 0.6875rem;
-  font-weight: 400;
-  color: var(--text-muted);
-  line-height: 1.35;
-  overflow-wrap: anywhere;
-}
-
-.mint-settings-modal__rail-item--active .mint-settings-modal__rail-item-description {
-  color: color-mix(in srgb, var(--color-primary) 65%, var(--text-secondary));
-}
-
-.mint-settings-modal__pane {
-  flex: 1;
-  min-width: 0;
-  min-height: 0;
-  display: flex;
-  flex-direction: column;
-  overflow: hidden;
-}
-
-.mint-settings-modal__pane:focus-visible {
-  outline: none;
-  box-shadow: var(--focus-ring);
-  border-radius: var(--radius-md);
-}
-
-.mint-settings-modal__pane-header {
-  flex-shrink: 0;
-  margin-bottom: 1rem;
-  padding-bottom: 0.75rem;
-  border-bottom: 1px solid var(--border-light);
-}
-
-.mint-settings-modal__pane-title {
-  font-size: 0.875rem;
-  font-weight: 600;
-  color: var(--text-primary);
-  letter-spacing: -0.005em;
-  margin: 0 !important;
-  padding: 0 !important;
-  line-height: 1.3;
-}
-
-.mint-settings-modal__pane-subtitle {
-  font-size: 0.75rem;
-  color: var(--text-secondary);
-  line-height: 1.45;
-  margin: 0.25rem 0 0 !important;
-  padding: 0 !important;
-}
-
-.mint-settings-modal__pane-body {
-  flex: 1;
-  min-height: 0;
-  overflow-y: auto;
-  scrollbar-width: thin;
-  /* Trailing breathing room so the last field doesn't hug the modal border */
-  padding: 0 0.5rem 0.25rem 0;
-  margin-right: -0.25rem;
-  overscroll-behavior: contain;
-}
-
-.mint-settings-modal__pane-body::-webkit-scrollbar {
-  width: 0.5rem;
-}
-
-.mint-settings-modal__pane-body::-webkit-scrollbar-track {
-  background: transparent;
-}
-
-.mint-settings-modal__pane-body::-webkit-scrollbar-thumb {
-  background-color: color-mix(in srgb, var(--text-muted) 30%, transparent);
-  border: 2px solid transparent;
-  border-radius: 9999px;
-  background-clip: content-box;
-}
-
-.mint-settings-modal__pane-body::-webkit-scrollbar-thumb:hover {
-  background-color: color-mix(in srgb, var(--text-muted) 45%, transparent);
-}
-
-/* Mobile — collapse the rail into a horizontal scroll-strip so the modal stays usable.
- * Touch targets stay ≥40px tall via 0.5rem vertical padding + 1rem text line-height. */
-@media (max-width: 640px) {
-  .mint-settings-modal--vertical {
-    flex-direction: column;
-    gap: 0.875rem;
-    height: auto;
-    max-height: none;
-    min-height: 0;
-    overflow: visible;
-  }
-
-  .mint-settings-modal__rail {
-    width: 100%;
-    flex-direction: row;
-    overflow-x: auto;
-    padding: 0 0 0.625rem;
-    border-right: none;
-    border-bottom: 1px solid var(--border-light);
-    gap: 0.25rem;
-    scrollbar-width: thin;
-  }
-
-  .mint-settings-modal__rail-item {
-    flex-shrink: 0;
-    width: auto;
-    padding: 0.5rem 0.75rem;
-  }
-
-  .mint-settings-modal__rail-item--active::before {
-    display: none;
-  }
-
-  /* Two-line description hides on mobile so the rail strip stays compact */
-  .mint-settings-modal__rail-item-description {
-    display: none;
-  }
-}

package/src/styles/index.css

@@ -6,6 +6,7 @@
 @import './variables.css';
 
 /* Component styles - alphabetically ordered */
+@import './components/action-menu.css';
 @import './components/alert-box.css';
 @import './components/app-container.css';
 @import './components/app-layout.css';

package/src/types/components.ts

@@ -7,12 +7,48 @@ export type ContainerDirection = 'row' | 'column'
 export type ButtonVariant = 'primary' | 'secondary' | 'cta' | 'danger' | 'success' | 'ghost'
 export type ButtonSize = 'sm' | 'md' | 'lg'
 
+// Action menu types
+interface ActionMenuItemBase {
+  id: string
+  label: string
+  disabled?: boolean
+  danger?: boolean
+}
+
+export type ActionMenuItem =
+  | (ActionMenuItemBase & {
+      href?: never
+      target?: never
+    })
+  | (ActionMenuItemBase & {
+      href: string
+      target?: '_self' | '_blank' | '_parent' | '_top'
+    })
+
 // Input types
 export type InputType = 'text' | 'password' | 'email' | 'number' | 'search' | 'tel' | 'url'
 
 // Modal types
 export type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full'
 export type ModalVariant = 'centered' | 'drawer' | 'sheet'
+export type ModalLayout = 'plain' | 'tabs' | 'rail'
+
+/** Section descriptor for BaseModal's shell-level tab strip (layout="tabs") or rail (layout="rail"). */
+export interface ModalTab {
+  id: string
+  label: string
+  /** Monospace meta on the right of the label — a count, "2 unsaved", etc. No colored badge pill. */
+  meta?: string
+  /**
+   * Rail only — 1rem stroke icon. Accepts SVG path data (string or string[])
+   * or trusted inline SVG markup rendered with `v-html`. Markup must be
+   * plugin-author-controlled — never user-supplied data.
+   */
+  icon?: string | string[]
+  /** Rail only — second line under the label; also shown as the pane subtitle. */
+  description?: string
+  disabled?: boolean
+}
 
 // Alert types
 export type AlertType = 'success' | 'error' | 'warning' | 'info'
@@ -416,6 +452,8 @@ export interface SettingsTab extends AccessControlled {
   icon?: string
   /** Optional one-line hint shown under the label (vertical layout) and as a section subtitle in the right pane. */
   description?: string
+  /** Optional monospace meta shown right of the tab label — a count, "2 unsaved", etc. */
+  meta?: string
 }
 
 export type SettingsTabInput = SettingsTab | string

package/src/types/index.ts

@@ -3,9 +3,12 @@ export type {
   ContainerDirection,
   ButtonVariant,
   ButtonSize,
+  ActionMenuItem,
   InputType,
   ModalSize,
   ModalVariant,
+  ModalLayout,
+  ModalTab,
   AlertType,
   Toast,
   TabItem,