@morscherlab/mint-sdk 1.0.0-alpha.9 → 1.0.0-beta.2

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

@@ -93,3 +93,187 @@ html.dark .mint-settings-modal__option-btn--active {
   margin-bottom: 0 !important;
   padding: 0 !important;
 }
+
+/* ─────────────────────────────────────────────────────────────────────
+ * Schema-driven content grid (used by both layouts)
+ * Cols come from `--mint-settings-cols` set inline by the component;
+ * keeps the data binding minimal and the styling in one place.
+ * ───────────────────────────────────────────────────────────────────── */
+
+.mint-settings-modal__group-grid {
+  display: grid;
+  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;
+  min-height: 22rem;
+}
+
+.mint-settings-modal__rail {
+  flex-shrink: 0;
+  width: 12.5rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+  padding-right: 0.75rem;
+  border-right: 1px solid var(--border-light);
+}
+
+.mint-settings-modal__rail-item {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.625rem;
+  width: 100%;
+  padding: 0.5rem 0.75rem;
+  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);
+}
+
+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;
+}
+
+.mint-settings-modal__rail-item-description {
+  font-size: 0.6875rem;
+  font-weight: 400;
+  color: var(--text-muted);
+  line-height: 1.35;
+}
+
+.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;
+  display: flex;
+  flex-direction: column;
+}
+
+.mint-settings-modal__pane-header {
+  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;
+  /* Trailing breathing room so the last field doesn't hug the modal border */
+  padding-bottom: 0.25rem;
+}
+
+/* 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;
+    min-height: 0;
+  }
+
+  .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;
+  }
+
+  /* Two-line description hides on mobile so the rail strip stays compact */
+  .mint-settings-modal__rail-item-description {
+    display: none;
+  }
+}

package/src/styles/components/tabs.css

@@ -15,9 +15,8 @@
   border-radius: var(--radius-md);
 }
 
-/* 1px optical padding shift (0.16+). See CLAUDE.md § Optical Centering. */
 .mint-tab {
-  padding: 0.4375rem 1rem 0.5625rem;
+  padding: 0.5rem 1rem;
   font-size: 0.875rem;
   font-weight: 500;
   transition: color 0.15s ease, background-color 0.15s ease, border-color 0.15s ease;

package/src/styles/components/textarea.css

@@ -48,20 +48,19 @@
   resize: none;
 }
 
-/* Size variants — 1px optical padding shift (0.16+).
-   See CLAUDE.md § Optical Centering. */
+/* Size variants */
 .mint-textarea--sm {
-  padding: 0.3125rem 0.625rem 0.4375rem;
+  padding: 0.375rem 0.625rem;
   font-size: 0.8125rem;
 }
 
 .mint-textarea--md {
-  padding: 0.4375rem 0.75rem 0.5625rem;
+  padding: 0.5rem 0.75rem;
   font-size: 0.875rem;
 }
 
 .mint-textarea--lg {
-  padding: 0.6875rem 1rem 0.8125rem;
+  padding: 0.75rem 1rem;
   font-size: 1rem;
 }
 

package/src/styles/components/unit-input.css

@@ -70,9 +70,9 @@
 
 /* Horizontal padding matches BaseInput canonical scale (10/12/16) so FormField's
    12px label indent aligns with the value text across all input types. */
-.mint-unit-input__value--sm { padding: 0.3125rem 0.625rem 0.4375rem; font-size: 0.875rem; }
-.mint-unit-input__value--md { padding: 0.4375rem 0.75rem 0.5625rem;  font-size: 0.875rem; }
-.mint-unit-input__value--lg { padding: 0.6875rem 1rem 0.8125rem;     font-size: 1rem; }
+.mint-unit-input__value--sm { padding: 0.375rem 0.625rem; font-size: 0.875rem; }
+.mint-unit-input__value--md { padding: 0.5rem 0.75rem;    font-size: 0.875rem; }
+.mint-unit-input__value--lg { padding: 0.75rem 1rem;      font-size: 1rem; }
 
 /* ---------- Unit chip ---------- */
 

package/src/types/components.ts

@@ -118,6 +118,13 @@ export interface TopBarSettingsConfig {
   tabs?: SettingsTab[]
   showAppearance?: boolean
   size?: 'md' | 'lg' | 'xl'
+  layout?: SettingsModalLayout
+  /** Schema-driven config — when set, fields auto-render via FormFieldRenderer. */
+  schema?: SettingsModalSchema
+  /** Initial values when using `schema`. AppTopBar emits `settings-values-change` on change. */
+  values?: Record<string, unknown>
+  /** Dynamic enhancements (validators, dynamic options, callbacks). Forwarded to SettingsModal. */
+  enhancements?: import('./form-builder').FormEnhancements
 }
 
 // TopBar pill-nav items (centered top-level navigation)
@@ -517,7 +524,42 @@ export type ConfirmVariant = 'danger' | 'warning' | 'info'
 export interface SettingsTab {
   id: string
   label: string
+  /**
+   * Inline SVG markup rendered with `v-html` in the vertical layout's rail.
+   * Must be trusted, plugin-author-controlled markup — never user-supplied data.
+   */
   icon?: string
+  /** Optional one-line hint shown under the label (vertical layout) and as a section subtitle in the right pane. */
+  description?: string
+}
+
+export type SettingsModalLayout = 'horizontal' | 'vertical'
+
+/**
+ * Declarative settings group — becomes both a tab and a FormSection.
+ * Plugin authors describe their parameters once and the modal auto-renders
+ * SDK form components (BaseInput / BaseSelect / NumberInput / Toggle / …)
+ * via the same registry that powers FormBuilder.
+ */
+export interface SettingsGroup {
+  id: string
+  label: string
+  description?: string
+  /**
+   * Inline SVG markup rendered with `v-html` in the vertical layout's rail.
+   * Must be trusted, plugin-author-controlled markup — never user-supplied data.
+   */
+  icon?: string
+  /** SDK form-builder field schemas. */
+  fields: import('./form-builder').FormFieldSchema[]
+  /** Grid columns for the rendered fields (1-3). Defaults to 1. */
+  columns?: 1 | 2 | 3
+  /** Hide the entire group (rail item + content) when this evaluates false against the form data. */
+  condition?: import('./form-builder').FieldCondition
+}
+
+export interface SettingsModalSchema {
+  groups: SettingsGroup[]
 }
 
 // ScientificNumber types

package/src/types/index.ts

@@ -99,6 +99,9 @@ export type {
   ConfirmVariant,
   // SettingsModal types
   SettingsTab,
+  SettingsModalLayout,
+  SettingsGroup,
+  SettingsModalSchema,
   // ScientificNumber types
   NumberNotation,
   // UnitInput types

package/src/types/platform.ts

@@ -5,6 +5,7 @@ export interface PluginInfo {
   version: string
   description?: string
   icon?: string
+  color?: string
   route_prefix: string
   api_prefix: string
   nav_items?: PluginNavItem[]