@morscherlab/mint-sdk 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/types/components.d.ts

@@ -19,18 +19,22 @@ export interface TabItem {
     disabled?: boolean;
     badge?: string | number;
 }
+export type TabItemInput = TabItem | string;
+export type OptionPrimitive = string | number;
 export interface SelectOption<T = string> {
     value: T;
     label: string;
     disabled?: boolean;
     description?: string;
 }
+export type SelectOptionInput<T extends OptionPrimitive = OptionPrimitive> = SelectOption<T> | T;
 export interface RadioOption {
     value: string | number;
     label: string;
     disabled?: boolean;
     description?: string;
 }
+export type RadioOptionInput = RadioOption | OptionPrimitive;
 export interface FormFieldProps {
     label?: string;
     error?: string;
@@ -63,6 +67,7 @@ export interface TopBarPage {
     description?: string;
     disabled?: boolean;
 }
+export type TopBarPageInput = TopBarPage | string;
 export interface TopBarTab {
     id: string;
     label: string;
@@ -80,19 +85,38 @@ export interface TopBarTabOption {
     description?: string;
     disabled?: boolean;
 }
+export type TopBarTabOptionInput = TopBarTabOption | string;
+export type TopBarTabInput = (Omit<TopBarTab, 'children'> & {
+    children?: TopBarTabOptionInput[];
+}) | string;
 export interface TopBarSettingsConfig {
     title?: string;
-    tabs?: SettingsTab[];
+    tabs?: SettingsTabInput[];
     showAppearance?: boolean;
     size?: 'md' | 'lg' | 'xl';
+    layout?: SettingsModalLayout;
+    /** Schema-driven config — when set, fields auto-render via SDK form components. */
+    schema?: SettingsModalSchema;
+    /** Model returned by defineControlModel(), or a raw nested ControlModel for one-step settings generation. */
+    model?: import('../composables/useControlSchema').ControlModel | import('../composables/useControlSchema').ControlModelBinding;
+    /** Compact controls model — converted to `schema` when `schema` is not set. */
+    controls?: import('../composables/useControlSchema').ControlSchema;
+    /** Conversion options for `controls`, such as section labels and columns. */
+    controlOptions?: import('../composables/useControlSchema').ControlSchemaOptions;
+    /** Initial values when using `schema`, `model`, or `controls`. 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;
 }
 export interface PillNavItem {
     id: string;
     label: string;
+    icon?: string | string[];
     to?: string;
     href?: string;
     disabled?: boolean;
 }
+export type PillNavItemInput = PillNavItem | string;
 export interface PageSelectorItem {
     id: string;
     label: string;
@@ -102,6 +126,7 @@ export interface PageSelectorItem {
     href?: string;
     disabled?: boolean;
 }
+export type PageSelectorItemInput = PageSelectorItem | string;
 export interface PluginSwitcherPlugin {
     id: string;
     label: string;
@@ -270,6 +295,7 @@ export interface SegmentedOption {
     description?: string;
     disabled?: boolean;
 }
+export type SegmentedOptionInput = SegmentedOption | OptionPrimitive;
 export type SegmentedControlVariant = 'simple' | 'card';
 export type SegmentedControlSize = 'sm' | 'md' | 'lg';
 export interface MultiSelectOption {
@@ -277,6 +303,7 @@ export interface MultiSelectOption {
     label: string;
     disabled?: boolean;
 }
+export type MultiSelectOptionInput = MultiSelectOption | OptionPrimitive;
 export type MultiSelectSize = 'sm' | 'md' | 'lg';
 /** Visual style variant for pill/badge components */
 export type PillVariant = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info' | 'outline';
@@ -370,12 +397,46 @@ export interface BreadcrumbItem {
     to?: string;
     href?: string;
 }
+export type BreadcrumbItemInput = BreadcrumbItem | string;
 export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
 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 SettingsTabInput = SettingsTab | string;
+export type SettingsModalLayout = 'horizontal' | 'vertical';
+/**
+ * Declarative settings group — becomes both a tab and a generated form section.
+ * 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[];
 }
 export type NumberNotation = 'auto' | 'scientific' | 'engineering' | 'compact';
 export interface UnitOption {

package/dist/types/form-builder.d.ts

@@ -1,4 +1,5 @@
 import { FieldRules } from '../composables/useForm';
+import { OptionPrimitive, SelectOption } from './components';
 /** All supported field types that map to SDK components. */
 export type FormFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search' | 'textarea' | 'select' | 'multiselect' | 'checkbox' | 'toggle' | 'radio' | 'slider' | 'tags' | 'date' | 'time' | 'datetime' | 'file' | 'formula' | 'sequence' | 'molecule' | 'concentration' | 'unit';
 export type FieldCondition = {
@@ -83,6 +84,7 @@ export interface FormFieldSchema {
     /** Extra props passed directly to the underlying component. */
     props?: Record<string, unknown>;
 }
+export type FormOptionInput = SelectOption<unknown> | OptionPrimitive;
 export interface FormSectionSchema {
     id: string;
     title: string;
@@ -121,10 +123,7 @@ export interface FieldEnhancement<T extends Record<string, unknown> = Record<str
     /** Dynamic visibility (overrides schema condition if both present). */
     visible?: (data: T) => boolean;
     /** Dynamic options for select/multiselect/radio fields. */
-    options?: (data: T) => {
-        label: string;
-        value: unknown;
-    }[];
+    options?: (data: T) => FormOptionInput[];
     /** Dynamic extra props merged into the component. */
     props?: (data: T) => Record<string, unknown>;
 }
@@ -152,10 +151,7 @@ export interface UseFormBuilderReturn<T extends Record<string, unknown>> {
     /** Resolve final component props for a field. */
     getResolvedFieldProps: (field: FormFieldSchema) => Record<string, unknown>;
     /** Get options for a select/radio/multiselect field. */
-    getFieldOptions: (name: string) => {
-        label: string;
-        value: unknown;
-    }[] | undefined;
+    getFieldOptions: (name: string) => FormOptionInput[] | undefined;
     currentStep: import('vue').Ref<number>;
     isCurrentStepValid: import('vue').ComputedRef<boolean>;
     goNext: () => boolean;
@@ -164,4 +160,6 @@ export interface UseFormBuilderReturn<T extends Record<string, unknown>> {
     validate: () => boolean;
     reset: (values?: Partial<T>) => void;
     submit: () => Promise<void>;
+    /** Replace the active schema and rebuild field state for still-mounted forms. */
+    updateSchema: (schema: FormSchema, values?: Partial<T>) => void;
 }

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-export type { ContainerDirection, ButtonVariant, ButtonSize, InputType, ModalSize, ModalVariant, AlertType, Toast, TabItem, SelectOption, RadioOption, FormFieldProps, SidebarToolSection, CollapsibleState, TopBarVariant, TopBarPage, TopBarTab, TopBarTabOption, TopBarSettingsConfig, PillNavItem, PageSelectorItem, PluginSwitcherPlugin, PluginSwitcherInfo, AccountMenuItem, WellPlateFormat, WellState, WellPlateSelectionMode, WellPlateSize, WellShape, Well, HeatmapColorScale, HeatmapConfig, SlotPosition, WellExtendedData, WellEditData, WellEditField, WellLegendItem, PlateCondition, ColumnCondition, RowCondition, Rack, SampleType, PlateMap, PlateMapEditorState, ProtocolStepType, ProtocolStepStatus, ProtocolStep, SampleGroup, GroupItem, FileUploaderMode, SegmentedOption, SegmentedControlVariant, SegmentedControlSize, MultiSelectOption, MultiSelectSize, PillVariant, PillColor, PillSize, CalendarSelectionMode, CalendarMarker, CalendarDayContext, SortDirection, SortState, DataFrameColumn, PaginationState, SpinnerSize, SpinnerVariant, DividerSpacing, StatusType, ProgressVariant, ProgressSize, AvatarSize, EmptyStateColor, EmptyStateSize, BreadcrumbItem, TooltipPosition, ConfirmVariant, SettingsTab, NumberNotation, UnitOption, WizardStep, WizardStepState, AuditEntryType, AuditEntry, BatchItemStatus, BatchItem, BatchSummary, TimePickerFormat, TimeRange, ScheduleView, ScheduleEventStatus, ScheduleEvent, ScheduleBlockedSlot, ScheduleSlotContext, ScheduleEventCreateContext, ScheduleEventUpdateContext, SummarySectionItem, SummarySection, SummaryData, ResourceStatus, ResourceSpec, MoleculeData, ExperimentStatus, DatePreset, ExperimentSortField, ExperimentTypeOption, ExperimentSummary, ExperimentListResponse, ExperimentFilters, FitState, FitResultSummary, StorageCondition, ReagentColumn, Reagent, TreeNodeType, BadgeVariant, TreeNode, } from './components';
-export type { FormFieldType, FieldCondition, FieldValidation, FormFieldSchema, FormSectionSchema, FormStepSchema, FormSchema, FieldEnhancement, FormEnhancements, UseFormBuilderReturn, } from './form-builder';
+export type { ContainerDirection, ButtonVariant, ButtonSize, InputType, ModalSize, ModalVariant, AlertType, Toast, TabItem, TabItemInput, OptionPrimitive, SelectOption, SelectOptionInput, RadioOption, RadioOptionInput, FormFieldProps, SidebarToolSection, CollapsibleState, TopBarVariant, TopBarPage, TopBarPageInput, TopBarTab, TopBarTabInput, TopBarTabOption, TopBarTabOptionInput, TopBarSettingsConfig, PillNavItem, PillNavItemInput, PageSelectorItem, PageSelectorItemInput, PluginSwitcherPlugin, PluginSwitcherInfo, AccountMenuItem, WellPlateFormat, WellState, WellPlateSelectionMode, WellPlateSize, WellShape, Well, HeatmapColorScale, HeatmapConfig, SlotPosition, WellExtendedData, WellEditData, WellEditField, WellLegendItem, PlateCondition, ColumnCondition, RowCondition, Rack, SampleType, PlateMap, PlateMapEditorState, ProtocolStepType, ProtocolStepStatus, ProtocolStep, SampleGroup, GroupItem, FileUploaderMode, SegmentedOption, SegmentedOptionInput, SegmentedControlVariant, SegmentedControlSize, MultiSelectOption, MultiSelectOptionInput, MultiSelectSize, PillVariant, PillColor, PillSize, CalendarSelectionMode, CalendarMarker, CalendarDayContext, SortDirection, SortState, DataFrameColumn, PaginationState, SpinnerSize, SpinnerVariant, DividerSpacing, StatusType, ProgressVariant, ProgressSize, AvatarSize, EmptyStateColor, EmptyStateSize, BreadcrumbItem, BreadcrumbItemInput, TooltipPosition, ConfirmVariant, SettingsTab, SettingsTabInput, SettingsModalLayout, SettingsGroup, SettingsModalSchema, NumberNotation, UnitOption, WizardStep, WizardStepState, AuditEntryType, AuditEntry, BatchItemStatus, BatchItem, BatchSummary, TimePickerFormat, TimeRange, ScheduleView, ScheduleEventStatus, ScheduleEvent, ScheduleBlockedSlot, ScheduleSlotContext, ScheduleEventCreateContext, ScheduleEventUpdateContext, SummarySectionItem, SummarySection, SummaryData, ResourceStatus, ResourceSpec, MoleculeData, ExperimentStatus, DatePreset, ExperimentSortField, ExperimentTypeOption, ExperimentSummary, ExperimentListResponse, ExperimentFilters, FitState, FitResultSummary, StorageCondition, ReagentColumn, Reagent, TreeNodeType, BadgeVariant, TreeNode, } from './components';
+export type { FormFieldType, FieldCondition, FieldValidation, FormFieldSchema, FormOptionInput, FormSectionSchema, FormStepSchema, FormSchema, FieldEnhancement, FormEnhancements, UseFormBuilderReturn, } from './form-builder';
 export type { OutlierAction, InputMode, OutlierInfo, ColumnInfo, MetadataRow, AutoGroupResult, ParsedCsvData, } from './auto-group';
 export type { AuthConfig, UserInfo, LoginResponse, TokenVerifyResponse, RegisterRequest, UpdateProfileRequest, CredentialInfo, } from './auth';
 export type { PluginInfo, PluginNavItem, PluginSettings, PluginSettingField, PlatformContext, PlatformContextOptions, PlatformEventType, PlatformEvent, ThemeMode, ColorPalette, TableDensity, UserSummary, } from './platform';

package/dist/types/platform.d.ts

@@ -4,16 +4,21 @@ export interface PluginInfo {
     version: string;
     description?: string;
     icon?: string;
+    color?: string;
     route_prefix: string;
     api_prefix: string;
     nav_items?: PluginNavItem[];
     settings?: PluginSettings;
 }
 export interface PluginNavItem {
-    id: string;
+    id?: string;
     label: string;
     path: string;
     icon?: string;
+    description?: string;
+    requiresAuth?: boolean;
+    requiresAdmin?: boolean;
+    requiresFeature?: string;
     children?: PluginNavItem[];
 }
 export interface PluginSettings {
@@ -56,7 +61,9 @@ export interface PlatformContext {
     theme: 'light' | 'dark' | 'system';
     allowedExperimentTypes?: string[] | null;
     features?: {
+        admin?: boolean;
         experiments?: boolean;
+        samples?: boolean;
         passkey?: boolean;
         multiUser?: boolean;
     };