@morscherlab/mint-sdk 1.3.9 → 1.4.0-beta.2

package/src/runtime.ts

@@ -0,0 +1,145 @@
+// Generated-UI runtime components (`@morscherlab/mint-sdk/runtime`).
+
+// Layout components
+export { default as GeneratedPluginView } from './components/GeneratedPluginView.vue'
+export { default as GeneratedResultRenderer } from './components/GeneratedResultRenderer.vue'
+export { default as GeneratedPlotlyResult } from './components/GeneratedPlotlyResult.vue'
+export { default as ComponentBindingRenderer } from './components/ComponentBindingRenderer.vue'
+/** Modal picker over the read-only server mounts, recording paths rather than copying data. */
+export { default as GeneratedPathInput } from './components/GeneratedPathInput.vue'
+
+// Feedback components
+export { default as RuntimeUpdateNotice } from './components/RuntimeUpdateNotice.vue'
+
+// The realtime event stream (`GET /api/events`, behind the `realtime` feature flag).
+export {
+  useRealtime,
+  type RealtimeEvent,
+  type RealtimeHandler,
+  type UseRealtimeReturn,
+} from './composables/useRealtime'
+export {
+  usePresence,
+  type PresenceActivity,
+  type PresenceViewer,
+  type UsePresenceReturn,
+} from './composables/usePresence'
+/** Avatar stack of the other people on a presence topic, with a list of each person and activity. */
+export { default as PresenceAvatars } from './components/PresenceAvatars.vue'
+export type { PresencePerson } from './utils/presenceAvatars'
+
+// HTTP client and plugin endpoint helpers. Generated clients (`@/generated/mint-plugin`)
+// build on these; plugin code uses the generated `useClient`, `useSettings` and `useJobs`.
+export {
+  AuthenticationRequiredError,
+  useApi,
+  type ApiClientOptions,
+  type UseApiReturn,
+} from './composables/useApi'
+export {
+  buildEndpointUrl,
+  createClient,
+  downloadEndpoint,
+  pluginFormDataFromPayload,
+  resolvePluginBaseUrl,
+  uploadEndpoint,
+  useEventStream,
+  useSettingsEndpoint,
+  type BuildEndpointUrlOptions,
+  type CreateClientOptions,
+  type DownloadEndpointOptions,
+  type EventStreamMessage,
+  type PluginClientRequestOptions,
+  type PluginContract,
+  type PluginContractSettings,
+  type PluginEndpointContract,
+  type PluginEndpointDefinition,
+  type PluginEndpointRequestOptions,
+  type PluginFormDataPayload,
+  type PluginFormDataValue,
+  type PluginHttpMethod,
+  type PluginNavItemContract,
+  type StreamOptions,
+  type UseEventStreamReturn,
+  type UseSettingsEndpointOptions,
+  type UseSettingsEndpointReturn,
+} from './composables/createClient'
+export {
+  createGeneratedAnalysisTransport,
+  useJobsEndpoint,
+  type GeneratedAnalysisTransport,
+  type PluginJobRequestOptions,
+  type PluginJobWaitOptions,
+  type UseJobsEndpointOptions,
+  type UseJobsEndpointReturn,
+} from './composables/useJobsEndpoint'
+export {
+  combinePluginJobSources,
+  useJobCenter,
+  type CombinedPluginJobCenterSource,
+  type JobsStatusTrayTab,
+  type PluginJobCenterSource,
+  type UseJobCenterOptions,
+  type UseJobCenterReturn,
+} from './composables/useJobCenter'
+export { controlsTo, type ControlsTarget } from './composables/controlSchemaAdapters'
+export { controlBindings } from './composables/controlComponentBindings'
+
+// Forms, control schemas, job helpers and platform context helpers
+export {
+  useForm,
+  type ValidationRule,
+  type FieldRules,
+  type FieldState,
+  type UseFormReturn,
+} from './composables/useForm'
+export {
+  useFormBuilder,
+  evaluateCondition,
+} from './composables/useFormBuilder'
+export {
+  getFieldRegistryEntry,
+  getTypeDefault,
+  type RegistryEntry,
+} from './composables/formBuilderRegistry'
+export {
+  defineControlComponentBindings,
+  defineControls,
+  getDefaultControlView,
+  getControlDefaults,
+  useControlSchema,
+  useControlWorkspace,
+  type ControlFormSchema,
+  type ControlFormBinding,
+  type ControlSettingsBinding,
+  type ControlSidebarBinding,
+  type ControlTopBarSettingsBinding,
+  type ControlValues,
+  type UseControlSchemaReturn,
+  type ControlWorkspaceAppTopBarPillBinding,
+  type ControlWorkspaceComponentBindings,
+  type ControlWorkspaceFormBinding,
+  type ControlWorkspacePillNavBinding,
+  type ControlWorkspaceSidebarBinding,
+  type ControlWorkspaceTopBarBinding,
+  type ControlWorkspaceTopBarSettingsBinding,
+  type UseControlWorkspaceReturn,
+} from './composables/useControlSchema'
+export {
+  resolveCurrentPluginId,
+} from './composables/platformContextHelpers'
+export {
+  resolveJobCapabilities,
+  normalizeJobPercent,
+  normalizeJobState,
+  isActiveJobStatus,
+  isTerminalJobStatus,
+  jobStatusLabel,
+  type JobCapabilityInput,
+  type JobCapabilities,
+} from './jobs'
+export {
+  generatedJobFormSchema,
+  generatedJobDefaults,
+  normalizeGeneratedJobInput,
+} from './generated/schema'

package/src/shell.ts

@@ -0,0 +1,103 @@
+// Application shell components (`@morscherlab/mint-sdk/shell`).
+
+// Layout components
+export { default as AppTopBar } from './components/AppTopBar.vue'
+export { default as AppSidebar } from './components/AppSidebar.vue'
+export { default as AppLayout } from './components/AppLayout.vue'
+export { default as LayoutResizeHandle } from './components/LayoutResizeHandle.vue'
+
+// Headless interaction composables
+export {
+  useEventListener,
+  type EventListenerEnabled,
+  type EventFor,
+  type EventListenerStop,
+  type EventMapFor,
+  type EventTargetGetter,
+  type EventTargetLike,
+  type UseEventListenerObjectOptions,
+  type UseEventListenerOptions,
+} from './composables/useEventListener'
+export {
+  useDebouncedWatch,
+  type DebouncedWatchCallback,
+  type DebouncedWatchCleanup,
+  type DebouncedWatchSource,
+  type UseDebouncedWatchOptions,
+  type UseDebouncedWatchReturn,
+} from './composables/useDebouncedWatch'
+export {
+  useFocusTrap,
+  type UseFocusTrapOptions,
+  type UseFocusTrapReturn,
+} from './composables/useFocusTrap'
+export {
+  useRovingFocus,
+  type UseRovingFocusOptions,
+  type UseRovingFocusReturn,
+} from './composables/useRovingFocus'
+export {
+  reorderList,
+  useListReorder,
+  useReorderAnnouncer,
+  REORDER_ANNOUNCER_STYLE,
+  type ListReorderMove,
+  type UseListReorderOptions,
+  type UseListReorderReturn,
+  type UseReorderAnnouncerReturn,
+} from './composables/useListReorder'
+export {
+  useMenuKeyboard,
+  type UseMenuKeyboardOptions,
+  type UseMenuKeyboardReturn,
+} from './composables/useMenuKeyboard'
+
+// Layout, selection, expansion and sort primitives
+export {
+  resizedLeadingPanelWidth,
+  resizedTrailingPanelWidth,
+  resizedVerticalSplitPercent,
+  useManualLayoutResize,
+  type ManualLayoutResizeContext,
+  type ManualLayoutResizeTarget,
+  type ResizePanelWidthConstraints,
+  type ResizePercentConstraints,
+} from './composables/useManualLayoutResize'
+export {
+  useSelectionLimit,
+  type SelectionLimitSource,
+  type UseSelectionLimitOptions,
+  type UseSelectionLimitReturn,
+} from './composables/useSelectionLimit'
+export {
+  useListSelection,
+  type ListSelectionSource,
+  type ListSelectionValue,
+  type UseListSelectionOptions,
+  type UseListSelectionReturn,
+  type WidenListSelectionValue,
+} from './composables/useListSelection'
+export {
+  useExpansionSet,
+  type ExpansionSetSource,
+  type UseExpansionSetOptions,
+  type UseExpansionSetReturn,
+} from './composables/useExpansionSet'
+export {
+  compareSortValues,
+  useSortedItems,
+  type CompareSortValuesOptions,
+  type SortComparator,
+  type SortComparatorContext,
+  type SortDescriptor,
+  type SortedItemsSource,
+  type SortOrder,
+  type UseSortedItemsOptions,
+  type UseSortedItemsReturn,
+} from './composables/useSortedItems'
+export {
+  usePluginWorkspace,
+  type PluginWorkspaceSlotsLike,
+  type UsePluginWorkspaceOptions,
+  type UsePluginWorkspaceReturn,
+} from './composables/usePluginWorkspace'

package/src/stores/auth.ts

@@ -1,206 +1,70 @@
 import { defineStore } from 'pinia'
 import { ref, computed } from 'vue'
-import type { AuthConfig, UserInfo } from '../types'
-import {
-  canAccessAdmin as canUserAccessAdmin,
-  canAccessPlugin as canUserAccessPlugin,
-  getAccessAudience,
-  getUserPermissions,
-  hasAllPermissions,
-  hasAnyPermission,
-  isAdminUser,
-} from '../permissions'
+import type { UserInfo } from '../types'
 
-const AUTH_TOKEN_KEY = 'mint-auth-token'
-const AUTH_EXPIRES_KEY = 'mint-auth-expires'
-
-function getLocalStorage(): Storage | null {
-  try {
-    const storage = globalThis.localStorage
-    return typeof storage?.getItem === 'function' ? storage : null
-  } catch {
-    return null
-  }
-}
+/** localStorage key of the platform session token. The platform owns the stored value. */
+export const AUTH_TOKEN_STORAGE_KEY = 'mint-auth-token'
+/** localStorage key of the platform session token expiry (ISO 8601). */
+export const AUTH_EXPIRES_STORAGE_KEY = 'mint-auth-expires'
 
 function readStoredItem(key: string): string | null {
   try {
-    return getLocalStorage()?.getItem(key) ?? null
+    const storage = globalThis.localStorage
+    return typeof storage?.getItem === 'function' ? storage.getItem(key) : null
   } catch {
     return null
   }
 }
 
-function writeStoredItem(key: string, value: string): void {
-  try {
-    getLocalStorage()?.setItem(key, value)
-  } catch {
-    // Keep auth usable in-memory when browser storage is blocked.
-  }
-}
-
-function removeStoredItem(key: string): void {
-  try {
-    getLocalStorage()?.removeItem(key)
-  } catch {
-    // Keep auth cleanup usable in-memory when browser storage is blocked.
-  }
-}
-
+/**
+ * Read-only session bridge between the platform and SDK code.
+ *
+ * SDK clients read the session token from here. Only the platform writes the
+ * session, through `@morscherlab/mint-sdk/host`. The SDK never writes or removes
+ * the stored platform token.
+ */
 export const useAuthStore = defineStore('mint-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',
-    experimentVisibilityMode: 'open',
-  })
+  const authRequired = ref(true)
   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(() => isAdminUser(userInfo.value))
-  const userType = computed(() => getAccessAudience(userInfo.value))
-  const permissions = computed(() => getUserPermissions(userInfo.value))
-  const canAccessAdmin = computed(() => canUserAccessAdmin(userInfo.value))
-
-  const canRegister = computed(() => {
-    return authConfig.value.registrationEnabled
+    if (!authRequired.value) return true
+    if (!token.value) return false
+    return !(tokenExpires.value && tokenExpires.value < new Date())
   })
 
-  // Actions
+  /** Read the stored platform session token, once per page. */
   function initialize() {
-    const storedToken = readStoredItem(AUTH_TOKEN_KEY)
-    const storedExpires = readStoredItem(AUTH_EXPIRES_KEY)
+    const storedToken = readStoredItem(AUTH_TOKEN_STORAGE_KEY)
+    const storedExpires = readStoredItem(AUTH_EXPIRES_STORAGE_KEY)
+    const expires = storedExpires ? new Date(storedExpires) : null
 
-    if (storedToken) {
+    if (storedToken && !(expires && expires <= new Date())) {
       token.value = storedToken
-
-      if (storedExpires) {
-        const expires = new Date(storedExpires)
-        if (expires > new Date()) {
-          tokenExpires.value = expires
-        } else {
-          clearToken()
-        }
-      }
+      tokenExpires.value = expires
     }
 
     isInitialized.value = true
   }
 
-  function setToken(accessToken: string, expiresIn: number) {
-    token.value = accessToken
-    const expires = new Date(Date.now() + expiresIn * 1000)
-    tokenExpires.value = expires
-
-    writeStoredItem(AUTH_TOKEN_KEY, accessToken)
-    writeStoredItem(AUTH_EXPIRES_KEY, expires.toISOString())
-  }
-
+  /** Forget the session in memory after the server rejected its token. */
   function clearToken() {
     token.value = null
     tokenExpires.value = null
-    username.value = null
     userInfo.value = null
-
-    removeStoredItem(AUTH_TOKEN_KEY)
-    removeStoredItem(AUTH_EXPIRES_KEY)
-  }
-
-  function setUserInfo(info: UserInfo) {
-    userInfo.value = info
-    username.value = info.username
-  }
-
-  function hasPermission(...perms: string[]): boolean {
-    return hasAllPermissions(userInfo.value, perms)
-  }
-
-  function hasAnyPermissionForUser(...perms: string[]): boolean {
-    return hasAnyPermission(userInfo.value, perms)
-  }
-
-  function canAccessPlugin(pluginName: string): boolean {
-    return canUserAccessPlugin(userInfo.value, pluginName)
-  }
-
-  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,
+    authRequired,
     isInitialized,
-    isLoading,
-    error,
-
-    // Computed
     isAuthenticated,
-    needsAuth,
-    isAdmin,
-    userType,
-    permissions,
-    canAccessAdmin,
-    canRegister,
-
-    // Actions
     initialize,
-    setToken,
     clearToken,
-    setAuthConfig,
-    setUsername,
-    setUserInfo,
-    setError,
-    setLoading,
-    hasPermission,
-    hasAnyPermission: hasAnyPermissionForUser,
-    canAccessPlugin,
-    logout,
   }
 })

package/src/stores/experiment.ts

@@ -1,7 +1,8 @@
 import { defineStore } from 'pinia'
-import { ref } from 'vue'
+import { ref, watch } from 'vue'
 import { useApi } from '../composables/useApi'
 import { readErrorMessage } from '../utils/errors'
+import { integrationHost } from '../utils/integrationHost'
 import type { ExperimentSummary, PlatformContext } from '../types'
 
 function getPlatformApiUrl(): string | undefined {
@@ -17,6 +18,9 @@ function getPlatformApiUrl(): string | undefined {
  * record the platform already returned, and deep links call `selectById()` with
  * nothing but an id. Because a name can only ever arrive from the platform,
  * there is no code path in which a caller can invent one.
+ *
+ * In a platform-served plugin page the platform integration script keeps the
+ * store and the `experiment_id` URL parameter in step.
  */
 export const useExperimentStore = defineStore('mint-experiment', () => {
   const current = ref<ExperimentSummary | null>(null)
@@ -93,6 +97,21 @@ export const useExperimentStore = defineStore('mint-experiment', () => {
     }
   }
 
+  /** Read the selected experiment again. The selection and its record stay in place. */
+  async function refresh(): Promise<void> {
+    const id = currentId.value
+    if (id === null) return
+    const token = selectionToken
+    try {
+      const experiment = await fetchExperiment(id)
+      if (token !== selectionToken) return
+      current.value = experiment
+      error.value = null
+    } catch (err) {
+      if (token === selectionToken) error.value = readErrorMessage(err, 'Failed to load experiment')
+    }
+  }
+
   function clear(): void {
     // Supersede any in-flight resolve so a detached experiment cannot be
     // repopulated by a response that was already on its way.
@@ -103,6 +122,12 @@ export const useExperimentStore = defineStore('mint-experiment', () => {
     isResolving.value = false
   }
 
+  integrationHost()?.bindExperimentStore({
+    currentId: () => currentId.value,
+    selectById,
+    onChange: (listener) => { watch(currentId, listener) },
+  })
+
   return {
     current,
     currentId,
@@ -110,6 +135,7 @@ export const useExperimentStore = defineStore('mint-experiment', () => {
     error,
     select,
     selectById,
+    refresh,
     clear,
   }
 })

package/src/styles/components/action-menu.css

@@ -7,11 +7,6 @@
   flex-shrink: 0;
 }
 
-.mint-action-menu__trigger-icon {
-  width: 1rem;
-  height: 1rem;
-}
-
 .mint-action-menu__panel {
   position: fixed;
   z-index: 1000;

package/src/styles/components/alert-box.css

@@ -29,6 +29,21 @@
   border-color: var(--mint-info-border);
 }
 
+.mint-alert--neutral {
+  background-color: var(--bg-tertiary);
+  border-color: var(--border-color);
+}
+
+.mint-alert--primary {
+  background-color: color-mix(in srgb, var(--color-primary) 10%, transparent);
+  border-color: color-mix(in srgb, var(--color-primary) 30%, transparent);
+}
+
+.mint-alert--cta {
+  background-color: color-mix(in srgb, var(--color-cta) 10%, transparent);
+  border-color: color-mix(in srgb, var(--color-cta) 30%, transparent);
+}
+
 /* Semantic color stays in the surface and the icon only (1h, same rule as Toast). */
 .mint-alert__icon {
   width: 1rem;
@@ -41,6 +56,9 @@
 .mint-alert__icon--error   { color: var(--_ink-error); }
 .mint-alert__icon--warning { color: var(--mint-warning-text); }
 .mint-alert__icon--info    { color: var(--mint-info); }
+.mint-alert__icon--neutral { color: var(--text-secondary); }
+.mint-alert__icon--primary { color: var(--color-primary); }
+.mint-alert__icon--cta     { color: var(--color-cta-hover); }
 
 .mint-alert__content {
   flex: 1;

package/src/styles/components/app-top-bar.css

@@ -174,11 +174,9 @@
   line-height: 1.2;
 }
 
-/* Right-side buttons (notifications, settings, admin) share the IconButton
-   ghost look: 32px, --radius-md, 16px icons, neutral ink, offset focus ring. */
-.mint-topbar__icon-btn,
-.mint-topbar__settings-btn,
-.mint-topbar__admin-btn {
+/* The settings button has the IconButton ghost look: 32px, --radius-md,
+   16px icon, neutral ink, offset focus ring. */
+.mint-topbar__settings-btn {
   position: relative;
   display: inline-flex;
   align-items: center;
@@ -195,62 +193,23 @@
   transition: background-color var(--mint-transition), color var(--mint-transition);
 }
 
-.mint-topbar__icon-btn:hover,
-.mint-topbar__settings-btn:hover,
-.mint-topbar__admin-btn:hover {
+.mint-topbar__settings-btn:hover {
   background: var(--bg-hover);
   color: var(--text-primary);
 }
 
-.mint-topbar__icon-btn:focus-visible,
-.mint-topbar__settings-btn:focus-visible,
-.mint-topbar__admin-btn:focus-visible {
+.mint-topbar__settings-btn:focus-visible {
   outline: none;
   box-shadow: var(--focus-ring-offset);
 }
 
-.mint-topbar__icon-btn-icon,
-.mint-topbar__settings-icon,
-.mint-topbar__admin-icon {
+.mint-topbar__settings-icon {
   width: 1rem;
   height: 1rem;
 }
 
-/* The ring takes the bar color so the dot reads cut out of the icon. */
-.mint-topbar__icon-btn-dot {
-  position: absolute;
-  top: 0.4375rem;
-  right: 0.4375rem;
-  width: 0.4375rem;
-  height: 0.4375rem;
-  border-radius: 9999px;
-  background: var(--color-cta);
-  box-shadow: 0 0 0 2px var(--bg-secondary);
-  pointer-events: none;
-}
-
-.mint-topbar__icon-btn:hover .mint-topbar__icon-btn-dot {
-  box-shadow: 0 0 0 2px var(--bg-hover);
-}
-
-/* Divider before the account menu. */
-.mint-topbar__right > .mint-avatar-menu {
-  display: inline-flex;
-  align-items: center;
-}
-
-.mint-topbar__right > .mint-avatar-menu::before {
-  content: '';
-  width: 1px;
-  height: 1.25rem;
-  margin: 0 0.375rem;
-  background: var(--border-color);
-}
-
 @media (prefers-reduced-motion: reduce) {
-  .mint-topbar__icon-btn,
-  .mint-topbar__settings-btn,
-  .mint-topbar__admin-btn {
+  .mint-topbar__settings-btn {
     transition: none;
   }
 }

package/src/styles/components/button.css

@@ -159,6 +159,18 @@
   min-height: var(--form-height-lg);
 }
 
+/* `icon` prop before the label: 16px, 20px at lg. */
+.mint-button__icon {
+  flex-shrink: 0;
+  width: 1rem;
+  height: 1rem;
+}
+
+.mint-button--lg .mint-button__icon {
+  width: 1.25rem;
+  height: 1.25rem;
+}
+
 /* Spinner */
 .mint-button__spinner {
   animation: mint-button-spin 1s linear infinite;

package/src/styles/components/checkbox.css

@@ -8,7 +8,7 @@
   user-select: none;
 }
 
-.mint-checkbox--default {
+.mint-checkbox--inline {
   width: fit-content;
 }