@morscherlab/mint-sdk 1.0.0-alpha.2

package/src/index.ts

@@ -0,0 +1,367 @@
+// Styles (import to ensure bundling)
+import './styles/index.css'
+
+// Vue Plugin for global component registration
+export { MINTSdk, default } from './install'
+
+// Components
+export {
+  BaseButton,
+  BaseInput,
+  BaseTextarea,
+  BaseSelect,
+  BaseCheckbox,
+  BaseToggle,
+  BaseRadioGroup,
+  BaseSlider,
+  ColorSlider,
+  BaseTabs,
+  BaseModal,
+  FormField,
+  DatePicker,
+  TimePicker,
+  TagsInput,
+  NumberInput,
+  FileUploader,
+  AlertBox,
+  ToastNotification,
+  AppToastContainer,
+  IconButton,
+  ThemeToggle,
+  SettingsButton,
+  CollapsibleCard,
+  AppTopBar,
+  AppPageSelector,
+  AppPillNav,
+  AppAvatarMenu,
+  AppPluginSwitcher,
+  AppSidebar,
+  AppLayout,
+  AppContainer,
+  Skeleton,
+  // Biological experiment components
+  WellPlate,
+  RackEditor,
+  SampleLegend,
+  PlateMapEditor,
+  ExperimentTimeline,
+  // Sample management components
+  SampleSelector,
+  GroupingModal,
+  AutoGroupModal,
+  GroupAssigner,
+  // Lab/Experiment components
+  MoleculeInput,
+  ConcentrationInput,
+  DoseCalculator,
+  ReagentList,
+  SampleHierarchyTree,
+  ProtocolStepEditor,
+  // Selection components
+  SegmentedControl,
+  MultiSelect,
+  // Pill / Dropdown components
+  BasePill,
+  DropdownButton,
+  Calendar,
+  DataFrame,
+  // Utility / UI primitives
+  LoadingSpinner,
+  Divider,
+  StatusIndicator,
+  ProgressBar,
+  Avatar,
+  EmptyState,
+  Breadcrumb,
+  Tooltip,
+  ConfirmDialog,
+  ChartContainer,
+  SettingsModal,
+  // Scientific display components
+  ScientificNumber,
+  ChemicalFormula,
+  // Scientific input components
+  FormulaInput,
+  SequenceInput,
+  UnitInput,
+  // Workflow components
+  StepWizard,
+  AuditTrail,
+  BatchProgressList,
+  // Experiment data display components
+  ExperimentDataViewer,
+  ExperimentCodeBadge,
+  // Scheduling / booking components
+  DateTimePicker,
+  TimeRangeInput,
+  ScheduleCalendar,
+  ResourceCard,
+  // Experiment / analysis components
+  ExperimentSelectorModal,
+  ExperimentPopover,
+  FitPanel,
+} from './components'
+
+// Composables
+export {
+  useApi,
+  useAuth,
+  usePasskey,
+  useTheme,
+  useToast,
+  usePlatformContext,
+  useWellPlateEditor,
+  useConcentrationUnits,
+  useDoseCalculator,
+  useProtocolTemplates,
+  useRackEditor,
+  useChemicalFormula,
+  ATOMIC_WEIGHTS,
+  useSequenceUtils,
+  type ApiClientOptions,
+  type UseWellPlateEditorOptions,
+  type UseWellPlateEditorReturn,
+  type UseRackEditorOptions,
+  type UseRackEditorReturn,
+  type ConcentrationValue,
+  type ConcentrationUnit,
+  type VolumeValue,
+  type VolumeUnit,
+  type StepTemplate,
+  type FormulaParseResult,
+  type FormulaPart,
+  type SequenceType,
+  type SequenceStats,
+  // Time utilities
+  parseTime,
+  formatTime,
+  generateTimeSlots,
+  rangesOverlap,
+  durationMinutes,
+  formatDuration,
+  isTimeInRange,
+  findAvailableSlots,
+  snapToSlot,
+  addMinutes,
+  compareTime,
+  // Schedule drag
+  useScheduleDrag,
+  // Plugin config
+  usePluginConfig,
+  type UsePluginConfigReturn,
+  // Auto-group
+  useAutoGroup,
+  DEFAULT_COLORS,
+  // Experiment selector
+  useExperimentSelector,
+  type UseExperimentSelectorOptions,
+  type UseExperimentSelectorReturn,
+  // Experiment utilities
+  formatExperimentDate,
+  datePresetToISO,
+  EXPERIMENT_STATUS_OPTIONS,
+  EXPERIMENT_STATUS_VARIANT_MAP,
+  EXPERIMENT_STATUS_LABELS,
+  DATE_PRESET_OPTIONS,
+  SORT_OPTIONS,
+  // Experiment data
+  useExperimentData,
+  type UseExperimentDataOptions,
+  type UseExperimentDataReturn,
+  // App experiment (provide/inject for AppTopBar)
+  useAppExperiment,
+  APP_EXPERIMENT_KEY,
+  type UseAppExperimentOptions,
+  type UseAppExperimentReturn,
+  // Experiment save (unified save/load for plugins)
+  useExperimentSave,
+  type UseExperimentSaveOptions,
+  type UseExperimentSaveReturn,
+  // Plugin API (auto base URL detection)
+  usePluginApi,
+  type UsePluginApiOptions,
+} from './composables'
+
+// Stores
+export {
+  useAuthStore,
+  useSettingsStore,
+  colorPalettes,
+  type SettingsState,
+} from './stores'
+
+// Utils
+export {
+  hexToHsl,
+  hslToHex,
+  deriveShade,
+  type Hsl,
+} from './utils/color'
+
+// Types
+export type {
+  // Component types
+  ContainerDirection,
+  ButtonVariant,
+  ButtonSize,
+  InputType,
+  ModalSize,
+  AlertType,
+  Toast,
+  TabItem,
+  SelectOption,
+  RadioOption,
+  FormFieldProps,
+  SidebarToolSection,
+  CollapsibleState,
+  TopBarVariant,
+  TopBarPage,
+  TopBarTab,
+  TopBarTabOption,
+  TopBarSettingsConfig,
+  PillNavItem,
+  PageSelectorItem,
+  PluginSwitcherPlugin,
+  PluginSwitcherInfo,
+  AccountMenuItem,
+  // Well Plate types
+  WellPlateFormat,
+  WellState,
+  WellPlateSelectionMode,
+  Well,
+  HeatmapColorScale,
+  HeatmapConfig,
+  // Well Plate editing types
+  SlotPosition,
+  WellExtendedData,
+  WellEditData,
+  WellEditField,
+  WellLegendItem,
+  Rack,
+  // Sample Legend types
+  SampleType,
+  // Plate Map Editor types
+  PlateMap,
+  PlateMapEditorState,
+  // Experiment Timeline types
+  ProtocolStepType,
+  ProtocolStepStatus,
+  ProtocolStep,
+  // Sample management types
+  SampleGroup,
+  GroupItem,
+  // Auto-group types
+  OutlierAction,
+  InputMode,
+  OutlierInfo,
+  ColumnInfo,
+  MetadataRow,
+  AutoGroupResult,
+  ParsedCsvData,
+  FileUploaderMode,
+  // SegmentedControl types
+  SegmentedOption,
+  SegmentedControlVariant,
+  SegmentedControlSize,
+  // MultiSelect types
+  MultiSelectOption,
+  MultiSelectSize,
+  // Pill types
+  PillVariant,
+  PillSize,
+  // Calendar types
+  CalendarSelectionMode,
+  CalendarMarker,
+  CalendarDayContext,
+  // DataFrame types
+  SortDirection,
+  SortState,
+  DataFrameColumn,
+  PaginationState,
+  // LoadingSpinner types
+  SpinnerSize,
+  SpinnerVariant,
+  // Divider types
+  DividerSpacing,
+  // StatusIndicator types
+  StatusType,
+  // ProgressBar types
+  ProgressVariant,
+  ProgressSize,
+  // Avatar types
+  AvatarSize,
+  // EmptyState types
+  EmptyStateColor,
+  EmptyStateSize,
+  // Breadcrumb types
+  BreadcrumbItem,
+  // Tooltip types
+  TooltipPosition,
+  // ConfirmDialog types
+  ConfirmVariant,
+  // SettingsModal types
+  SettingsTab,
+  // ScientificNumber types
+  NumberNotation,
+  // TimePicker types
+  TimePickerFormat,
+  TimeRange,
+  // Schedule types
+  ScheduleView,
+  ScheduleEventStatus,
+  ScheduleEvent,
+  ScheduleBlockedSlot,
+  ScheduleSlotContext,
+  ScheduleEventCreateContext,
+  ScheduleEventUpdateContext,
+  // Resource types
+  ResourceStatus,
+  ResourceSpec,
+  // Experiment selector types
+  ExperimentStatus,
+  ExperimentSummary,
+  ExperimentListResponse,
+  ExperimentFilters,
+  // FitPanel types
+  FitState,
+  FitResultSummary,
+  // UnitInput types
+  UnitOption,
+  // StepWizard types
+  WizardStep,
+  WizardStepState,
+  // AuditTrail types
+  AuditEntryType,
+  AuditEntry,
+  // BatchProgressList types
+  BatchItemStatus,
+  BatchItem,
+  BatchSummary,
+  // Auth types
+  AuthConfig,
+  UserInfo,
+  LoginResponse,
+  TokenVerifyResponse,
+  RegisterRequest,
+  UpdateProfileRequest,
+  CredentialInfo,
+  // Summary types
+  SummaryData,
+  SummarySection,
+  SummarySectionItem,
+  // Tree types
+  TreeNode,
+  TreeNodeType,
+  // Platform types
+  PluginInfo,
+  PluginNavItem,
+  PluginSettings,
+  PluginSettingField,
+  PlatformContext,
+  PlatformEventType,
+  PlatformEvent,
+  ThemeMode,
+  ColorPalette,
+  TableDensity,
+  UserSummary,
+} from './types'

package/src/install.ts

@@ -0,0 +1,32 @@
+import type { App, Plugin } from 'vue'
+import * as components from './components'
+
+/**
+ * Vue plugin that registers all MLD SDK components globally.
+ *
+ * @example
+ * ```typescript
+ * import { createApp } from 'vue'
+ * import { MINTSdk } from '@estrellaxd/mld-sdk'
+ * import '@estrellaxd/mld-sdk/styles'
+ *
+ * const app = createApp(App)
+ * app.use(MINTSdk)
+ * ```
+ */
+export const MINTSdk: Plugin = {
+  install(app: App) {
+    for (const [name, component] of Object.entries(components)) {
+      // Check if it's a valid Vue component (has setup, render, or template)
+      if (
+        component &&
+        typeof component === 'object' &&
+        ('setup' in component || 'render' in component || '__name' in component)
+      ) {
+        app.component(name, component as Parameters<typeof app.component>[1])
+      }
+    }
+  },
+}
+
+export default MINTSdk

package/src/stores/auth.ts

@@ -0,0 +1,152 @@
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+import type { AuthConfig, UserInfo } from '../types'
+
+const AUTH_TOKEN_KEY = 'mld-auth-token'
+const AUTH_EXPIRES_KEY = 'mld-auth-expires'
+
+const hasLocalStorage = typeof localStorage !== 'undefined' && typeof localStorage.getItem === 'function'
+
+export const useAuthStore = defineStore('mld-auth', () => {
+  // State
+  const token = ref<string | null>(null)
+  const tokenExpires = ref<Date | null>(null)
+  const username = ref<string | null>(null)
+  const userInfo = ref<UserInfo | null>(null)
+  const authConfig = ref<AuthConfig>({
+    authRequired: true,
+    passkeyEnabled: false,
+    passkeyRegistered: false,
+    registrationEnabled: false,
+    databaseMode: 'none',
+  })
+  const isInitialized = ref(false)
+  const isLoading = ref(false)
+  const error = ref<string | null>(null)
+
+  // Computed
+  const isAuthenticated = computed(() => {
+    if (!authConfig.value.authRequired) {
+      return true
+    }
+    if (!token.value) {
+      return false
+    }
+    if (tokenExpires.value && tokenExpires.value < new Date()) {
+      return false
+    }
+    return true
+  })
+
+  const needsAuth = computed(() => {
+    return authConfig.value.authRequired && !isAuthenticated.value
+  })
+
+  const isAdmin = computed(() => {
+    return userInfo.value?.role === 'admin'
+  })
+
+  const canRegister = computed(() => {
+    return authConfig.value.registrationEnabled
+  })
+
+  // Actions
+  function initialize() {
+    if (hasLocalStorage) {
+      const storedToken = localStorage.getItem(AUTH_TOKEN_KEY)
+      const storedExpires = localStorage.getItem(AUTH_EXPIRES_KEY)
+
+      if (storedToken) {
+        token.value = storedToken
+
+        if (storedExpires) {
+          const expires = new Date(storedExpires)
+          if (expires > new Date()) {
+            tokenExpires.value = expires
+          } else {
+            clearToken()
+          }
+        }
+      }
+    }
+
+    isInitialized.value = true
+  }
+
+  function setToken(accessToken: string, expiresIn: number) {
+    token.value = accessToken
+    const expires = new Date(Date.now() + expiresIn * 1000)
+    tokenExpires.value = expires
+
+    if (hasLocalStorage) {
+      localStorage.setItem(AUTH_TOKEN_KEY, accessToken)
+      localStorage.setItem(AUTH_EXPIRES_KEY, expires.toISOString())
+    }
+  }
+
+  function clearToken() {
+    token.value = null
+    tokenExpires.value = null
+    username.value = null
+    userInfo.value = null
+
+    if (hasLocalStorage) {
+      localStorage.removeItem(AUTH_TOKEN_KEY)
+      localStorage.removeItem(AUTH_EXPIRES_KEY)
+    }
+  }
+
+  function setUserInfo(info: UserInfo) {
+    userInfo.value = info
+    username.value = info.username
+  }
+
+  function setAuthConfig(config: AuthConfig) {
+    authConfig.value = config
+  }
+
+  function setUsername(name: string) {
+    username.value = name
+  }
+
+  function setError(message: string | null) {
+    error.value = message
+  }
+
+  function setLoading(loading: boolean) {
+    isLoading.value = loading
+  }
+
+  function logout() {
+    clearToken()
+  }
+
+  return {
+    // State
+    token,
+    tokenExpires,
+    username,
+    userInfo,
+    authConfig,
+    isInitialized,
+    isLoading,
+    error,
+
+    // Computed
+    isAuthenticated,
+    needsAuth,
+    isAdmin,
+    canRegister,
+
+    // Actions
+    initialize,
+    setToken,
+    clearToken,
+    setAuthConfig,
+    setUsername,
+    setUserInfo,
+    setError,
+    setLoading,
+    logout,
+  }
+})

package/src/stores/index.ts

@@ -0,0 +1,2 @@
+export { useAuthStore } from './auth'
+export { useSettingsStore, colorPalettes, type SettingsState } from './settings'