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

package/src/composables/useControlSchema.ts

@@ -5,7 +5,6 @@ import type {
   SelectOption,
   SettingsModalSchema,
   TopBarSettingsConfig,
-  TopBarTab,
 } from '../types'
 import type {
   FieldCondition,
@@ -45,7 +44,7 @@ export interface ControlViewConfig {
   to?: string
   href?: string
   disabled?: boolean
-  children?: TopBarTab['children']
+  children?: PillNavItem['children']
 }
 
 export interface ControlSidebarConfig extends Omit<ControlSectionConfig, 'id' | 'title' | 'description' | 'columns'> {
@@ -120,6 +119,10 @@ export interface ControlModel extends Omit<ControlWorkspaceOptions, 'sections' |
   controls?: ControlSchema
   sections?: Record<string, ControlModelSectionConfig>
   views?: Record<string, ControlModelViewConfig>
+  /** Optional SDK component bindings returned with generated component props for custom workspace slots. */
+  componentBindings?: ControlComponentBindingsConfig
+  /** Alias for componentBindings in raw control models. */
+  components?: ControlComponentBindingsConfig
   /** Optional ControlWorkspaceView componentProps mapping returned with the generated controls/options. */
   componentProps?: ControlComponentPropsMap
   /** Optional named componentProps mappings returned for multiple SDK components. */
@@ -129,6 +132,7 @@ export interface ControlModel extends Omit<ControlWorkspaceOptions, 'sections' |
 export interface ControlModelBinding {
   controls: ControlSchema
   controlOptions: ControlWorkspaceOptions
+  componentBindings?: ControlComponentBindingsConfig
   componentProps?: ControlComponentPropsMap
   componentPropsById?: ControlComponentPropsByIdMap
 }
@@ -171,37 +175,28 @@ export interface ControlWorkspaceTopBarSettingsBinding extends ControlTopBarSett
   onSettingsValuesChange: (values: Record<string, unknown>) => void
 }
 
-export interface ControlWorkspaceTopBarBinding {
-  tabs: TopBarTab[]
-  currentTabId: string
-  onTabSelect: (tab: TopBarTab) => void
-}
-
 export interface ControlWorkspacePillNavBinding {
   items: PillNavItem[]
   currentItemId: string
   onSelect: (item: PillNavItem) => void
 }
 
-export interface ControlWorkspaceAppTopBarPillBinding extends ControlWorkspaceTopBarSettingsBinding {
+export interface ControlWorkspaceTopBarBinding extends ControlWorkspaceTopBarSettingsBinding {
   pillNav: PillNavItem[]
   currentPillId: string
   onPillSelect: (item: PillNavItem) => void
 }
 
-export interface ControlWorkspaceAppTopBarTabsBinding extends ControlWorkspaceTopBarSettingsBinding {
-  tabs: TopBarTab[]
-  currentTabId: string
-  onTabSelect: (tab: TopBarTab) => void
-}
+export type ControlWorkspaceAppTopBarPillBinding = ControlWorkspaceTopBarBinding
 
 export interface ControlWorkspaceComponentBindings {
   form: ControlWorkspaceFormBinding
   sidebar: ControlWorkspaceSidebarBinding
-  topBar: ComputedRef<ControlWorkspaceAppTopBarPillBinding>
-  topBarTabs: ComputedRef<ControlWorkspaceAppTopBarTabsBinding>
+  topBar: ComputedRef<ControlWorkspaceTopBarBinding>
   topBarSettings: ControlWorkspaceTopBarSettingsBinding
   pillNav: ControlWorkspacePillNavBinding
+  componentBindings: ComputedRef<ControlComponentBinding[]>
+  componentBindingsById: ComputedRef<ControlComponentBindingsById>
   componentProps: ComputedRef<Record<string, unknown>>
   componentPropsById: ComputedRef<Record<string, Record<string, unknown>>>
 }
@@ -217,6 +212,29 @@ export type ControlComponentPropsMap<TValues extends Record<string, unknown> = R
 export type ControlComponentPropsByIdMap<TValues extends Record<string, unknown> = Record<string, unknown>> =
   Record<string, ControlComponentPropsMap<TValues>>
 
+export interface ControlComponentBindingConfig<TValues extends Record<string, unknown> = Record<string, unknown>> {
+  id?: string
+  component: string
+  props?: ControlComponentPropsMap<TValues>
+}
+
+export interface ControlComponentBindingRecordConfig<TValues extends Record<string, unknown> = Record<string, unknown>> {
+  component: string
+  props?: ControlComponentPropsMap<TValues>
+}
+
+export type ControlComponentBindingsConfig<TValues extends Record<string, unknown> = Record<string, unknown>> =
+  | readonly ControlComponentBindingConfig<TValues>[]
+  | Record<string, ControlComponentBindingRecordConfig<TValues>>
+
+export interface ControlComponentBinding {
+  id: string
+  component: string
+  props: Record<string, unknown>
+}
+
+export type ControlComponentBindingsById = Record<string, ControlComponentBinding>
+
 export interface WellPlateControlPropsOptions<TValues extends Record<string, unknown> = Record<string, unknown>> {
   selectedWells?: ControlComponentPropSource<TValues>
   format?: ControlComponentPropSource<TValues>
@@ -276,7 +294,6 @@ export interface UseControlSchemaReturn<TControls extends ControlSchema> {
   sidebarPanels: Record<string, SidebarToolSection[]>
   viewIds: string[]
   viewItems: PillNavItem[]
-  topBarTabs: TopBarTab[]
   defaultView: string
   sectionSchemas: Record<string, ControlFormSchema>
   sidebar: ControlSidebarBinding
@@ -291,10 +308,12 @@ export interface UseControlWorkspaceReturn<TControls extends ControlSchema>
   activeView: Ref<string>
   form: ControlWorkspaceFormBinding
   sidebar: ControlWorkspaceSidebarBinding
-  topBar: ControlWorkspaceTopBarBinding
+  topBar: ComputedRef<ControlWorkspaceTopBarBinding>
   pillNav: ControlWorkspacePillNavBinding
   topBarSettings: ControlWorkspaceTopBarSettingsBinding
   bindings: ControlWorkspaceComponentBindings
+  componentBindings: ComputedRef<ControlComponentBinding[]>
+  componentBindingsById: ComputedRef<ControlComponentBindingsById>
   componentProps: ComputedRef<Record<string, unknown>>
   componentPropsById: ComputedRef<Record<string, Record<string, unknown>>>
   setActiveView: (viewId: string) => void
@@ -306,6 +325,12 @@ export interface UseControlWorkspaceReturn<TControls extends ControlSchema>
   getComponentPropsById: (
     mappings?: ControlComponentPropsByIdMap<ControlValues<TControls> & Record<string, unknown>>
   ) => Record<string, Record<string, unknown>>
+  getComponentBindings: (
+    bindings?: ControlComponentBindingsConfig<ControlValues<TControls> & Record<string, unknown>>
+  ) => ControlComponentBinding[]
+  getComponentBindingsById: (
+    bindings?: ControlComponentBindingsConfig<ControlValues<TControls> & Record<string, unknown>>
+  ) => ControlComponentBindingsById
 }
 
 export type ControlValues<TControls extends ControlSchema> = {
@@ -339,16 +364,26 @@ export function defineControls<TControls extends ControlSchema>(controls: TContr
   return controls
 }
 
-/** Flatten a simple view/section control data model into ControlWorkspaceView props for generated forms and sidebars. */
+/** Preserve literal SDK component binding ids while marking an object as generated workspace component bindings. */
+export function defineControlComponentBindings<TBindings extends ControlComponentBindingsConfig>(
+  bindings: TBindings,
+): TBindings {
+  return bindings
+}
+
+/** Create a complete workspace component binding from a simple controls data model for ControlWorkspaceView, generated forms, and sidebars. */
 export function defineControlModel(model: ControlModel): ControlModelBinding {
   const {
     controls: rootControls,
     sections: rootSections,
     views: modelViews,
+    components,
+    componentBindings,
     componentProps,
     componentPropsById,
     ...baseOptions
   } = model
+  const resolvedComponentBindings = componentBindings ?? components
   const controls: ControlSchema = {}
   const views: Record<string, ControlViewConfig> = {}
   const sections: Record<string, ControlSectionConfig> = {}
@@ -418,6 +453,7 @@ export function defineControlModel(model: ControlModel): ControlModelBinding {
   return {
     controls,
     controlOptions,
+    ...(resolvedComponentBindings === undefined ? {} : { componentBindings: resolvedComponentBindings }),
     ...(componentProps === undefined ? {} : { componentProps }),
     ...(componentPropsById === undefined ? {} : { componentPropsById }),
   }
@@ -456,6 +492,30 @@ export function controlValuesToComponentProps<TValues extends Record<string, unk
   return props
 }
 
+/** Map control workspace values into named SDK component bindings for direct slot rendering. */
+export function controlValuesToComponentBindings<TValues extends Record<string, unknown>>(
+  values: TValues,
+  bindings?: ControlComponentBindingsConfig<TValues>,
+): ControlComponentBinding[] {
+  if (bindings === undefined) return []
+
+  return normalizeControlComponentBindingConfigs(bindings).map(binding => ({
+    id: binding.id,
+    component: binding.component,
+    props: controlValuesToComponentProps(values, binding.props),
+  }))
+}
+
+/** Map control workspace values into SDK component bindings keyed by binding id. */
+export function controlValuesToComponentBindingsById<TValues extends Record<string, unknown>>(
+  values: TValues,
+  bindings?: ControlComponentBindingsConfig<TValues>,
+): ControlComponentBindingsById {
+  return Object.fromEntries(
+    controlValuesToComponentBindings(values, bindings).map(binding => [binding.id, binding]),
+  )
+}
+
 /** Return a default WellPlate prop mapping for generated control workspaces. */
 export function defineWellPlateControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(
   options: WellPlateControlPropsOptions<TValues> = {},
@@ -506,6 +566,24 @@ export function defineWellPlateDoseControlProps<TValues extends Record<string, u
   }
 }
 
+/** Return named WellPlate + DoseCalculator component bindings for one dose-design control model. */
+export function defineWellPlateDoseComponentBindings<TValues extends Record<string, unknown> = Record<string, unknown>>(
+  options: WellPlateDoseControlPropsOptions<TValues> = {},
+): ControlComponentBindingsConfig<TValues> {
+  return [
+    {
+      id: options.plateId ?? 'plate',
+      component: 'WellPlate',
+      props: defineWellPlateControlProps(options.plate),
+    },
+    {
+      id: options.doseId ?? 'dose',
+      component: 'DoseCalculator',
+      props: defineDoseCalculatorControlProps(options.dose),
+    },
+  ]
+}
+
 /** Return a complete ControlWorkspaceView model for WellPlate + DoseCalculator dose design. */
 export function defineDoseDesignControlModel(
   options: DoseDesignControlModelOptions = {},
@@ -543,16 +621,19 @@ export function defineDoseDesignControlModel(
     }
   }
 
+  const componentProps: WellPlateDoseControlPropsOptions = {
+    ...options.componentProps,
+    dose: {
+      ...(options.componentProps?.dose ?? {}),
+      ...(options.includeMolecularWeight && options.componentProps?.dose?.molecularWeight === undefined
+        ? { molecularWeight: 'molecularWeight' }
+        : {}),
+    },
+  }
+
   return defineControlModel({
-    componentPropsById: defineWellPlateDoseControlProps({
-      ...options.componentProps,
-      dose: {
-        ...(options.componentProps?.dose ?? {}),
-        ...(options.includeMolecularWeight && options.componentProps?.dose?.molecularWeight === undefined
-          ? { molecularWeight: 'molecularWeight' }
-          : {}),
-      },
-    }),
+    componentBindings: defineWellPlateDoseComponentBindings(componentProps),
+    componentPropsById: defineWellPlateDoseControlProps(componentProps),
     views: {
       [viewId]: {
         label: options.viewLabel ?? 'Design',
@@ -705,7 +786,7 @@ export function controlsToViewIds(
   return controlsToViewItems(controls, options).map(item => item.id)
 }
 
-/** Return AppPillNav-compatible view items for switching generated control sidebars. */
+/** Return AppTopBar pillNav-compatible view items for switching generated control sidebars. */
 export function controlsToViewItems(
   controls: ControlSchema,
   options: ControlSchemaOptions = {},
@@ -715,16 +796,6 @@ export function controlsToViewItems(
     .map(([id]) => controlViewItem(id, options))
 }
 
-/** Return AppTopBar-compatible tabs for the same views that drive generated AppSidebar panels. */
-export function controlsToTopBarTabs(
-  controls: ControlSchema,
-  options: ControlSchemaOptions = {},
-): TopBarTab[] {
-  return Object.entries(controlsToSidebarPanels(controls, options))
-    .filter(([, sections]) => sections.length > 0)
-    .map(([id]) => controlTopBarTab(id, options))
-}
-
 /** Return the first generated sidebar view ID, or an empty string when controls render no sidebar panels. */
 export function getDefaultControlView(
   controls: ControlSchema,
@@ -779,7 +850,6 @@ export function useControlSchema<TControls extends ControlSchema>(
   const sidebarPanels = controlsToSidebarPanels(controls, options)
   const viewItems = controlsToViewItems(controls, options)
   const viewIds = viewItems.map(item => item.id)
-  const topBarTabs = controlsToTopBarTabs(controls, options)
   const defaultView = viewIds[0] ?? ''
   const sectionSchemas = controlsToSectionFormSchemas(controls, options)
 
@@ -802,7 +872,6 @@ export function useControlSchema<TControls extends ControlSchema>(
     sidebarPanels,
     viewIds,
     viewItems,
-    topBarTabs,
     defaultView,
     sectionSchemas,
     sidebar: {
@@ -843,7 +912,6 @@ export function useControlWorkspace<TControls extends ControlSchema>(
     if (!schema.viewIds.includes(viewId)) return
     if (activeView.value !== viewId) activeView.value = viewId
     if (sidebar.activeView !== viewId) sidebar.activeView = viewId
-    if (topBar.currentTabId !== viewId) topBar.currentTabId = viewId
     if (pillNav.currentItemId !== viewId) pillNav.currentItemId = viewId
   }
 
@@ -876,10 +944,24 @@ export function useControlWorkspace<TControls extends ControlSchema>(
       ]),
     )
   }
+
+  function getComponentBindings(
+    bindings?: ControlComponentBindingsConfig<ControlValues<TControls> & Record<string, unknown>>,
+  ): ControlComponentBinding[] {
+    return controlValuesToComponentBindings(values, bindings)
+  }
+
+  function getComponentBindingsById(
+    bindings?: ControlComponentBindingsConfig<ControlValues<TControls> & Record<string, unknown>>,
+  ): ControlComponentBindingsById {
+    return controlValuesToComponentBindingsById(values, bindings)
+  }
   const componentProps = computed(() => (
     model?.componentProps === undefined ? {} : getComponentProps(model.componentProps)
   ))
   const componentPropsById = computed(() => getComponentPropsById(model?.componentPropsById))
+  const componentBindings = computed(() => getComponentBindings(model?.componentBindings))
+  const componentBindingsById = computed(() => getComponentBindingsById(model?.componentBindings))
   const form = {
     ...schema.form,
     modelValue: values,
@@ -899,11 +981,6 @@ export function useControlWorkspace<TControls extends ControlSchema>(
     values,
     'onUpdate:values': setValues,
   }) as ControlWorkspaceSidebarBinding
-  const topBar = reactive({
-    tabs: schema.topBarTabs,
-    currentTabId: activeView.value,
-    onTabSelect: (tab: TopBarTab) => setActiveView(tab.id),
-  }) as ControlWorkspaceTopBarBinding
   const pillNav = reactive({
     items: schema.viewItems,
     currentItemId: activeView.value,
@@ -914,32 +991,26 @@ export function useControlWorkspace<TControls extends ControlSchema>(
     settingsConfig: topBarSettingsConfig,
     onSettingsValuesChange: setValues,
   } as ControlWorkspaceTopBarSettingsBinding
-  const topBarProps = computed<ControlWorkspaceAppTopBarPillBinding>(() => ({
+  const topBarProps = computed<ControlWorkspaceTopBarBinding>(() => ({
     pillNav: pillNav.items,
     currentPillId: pillNav.currentItemId,
     onPillSelect: pillNav.onSelect,
     ...topBarSettingsBinding,
   }))
-  const topBarTabsProps = computed<ControlWorkspaceAppTopBarTabsBinding>(() => ({
-    tabs: topBar.tabs,
-    currentTabId: topBar.currentTabId,
-    onTabSelect: topBar.onTabSelect,
-    ...topBarSettingsBinding,
-  }))
   const bindings: ControlWorkspaceComponentBindings = {
     form,
     sidebar,
     topBar: topBarProps,
-    topBarTabs: topBarTabsProps,
     topBarSettings: topBarSettingsBinding,
     pillNav,
+    componentBindings,
+    componentBindingsById,
     componentProps,
     componentPropsById,
   }
 
   watch(activeView, syncActiveView, { flush: 'sync' })
   watch(() => sidebar.activeView, syncActiveView, { flush: 'sync' })
-  watch(() => topBar.currentTabId, syncActiveView, { flush: 'sync' })
   watch(() => pillNav.currentItemId, syncActiveView, { flush: 'sync' })
 
   return {
@@ -950,10 +1021,12 @@ export function useControlWorkspace<TControls extends ControlSchema>(
     topBarSettingsConfig,
     form,
     sidebar,
-    topBar,
+    topBar: topBarProps,
     pillNav,
     topBarSettings: topBarSettingsBinding,
     bindings,
+    componentBindings,
+    componentBindingsById,
     componentProps,
     componentPropsById,
     setActiveView,
@@ -961,6 +1034,8 @@ export function useControlWorkspace<TControls extends ControlSchema>(
     resetValues,
     getComponentProps,
     getComponentPropsById,
+    getComponentBindings,
+    getComponentBindingsById,
   }
 }
 
@@ -1158,6 +1233,31 @@ function compactComponentPropsMap<TValues extends Record<string, unknown>>(
   )
 }
 
+function normalizeControlComponentBindingConfigs<TValues extends Record<string, unknown>>(
+  bindings: ControlComponentBindingsConfig<TValues>,
+): Array<Required<Pick<ControlComponentBindingConfig<TValues>, 'id' | 'component'>> & Pick<ControlComponentBindingConfig<TValues>, 'props'>> {
+  if (Array.isArray(bindings)) {
+    const usedIds = new Map<string, number>()
+    return bindings.map(binding => ({
+      id: uniqueComponentBindingId(binding.id ?? binding.component, usedIds),
+      component: binding.component,
+      props: binding.props,
+    }))
+  }
+
+  return Object.entries(bindings).map(([id, binding]) => ({
+    id,
+    component: binding.component,
+    props: binding.props,
+  }))
+}
+
+function uniqueComponentBindingId(id: string, usedIds: Map<string, number>): string {
+  const count = usedIds.get(id) ?? 0
+  usedIds.set(id, count + 1)
+  return count === 0 ? id : `${id}-${count + 1}`
+}
+
 function sourceKey<TValues extends Record<string, unknown>>(key: string): keyof TValues & string {
   return key as keyof TValues & string
 }
@@ -1234,18 +1334,6 @@ function controlViewItem(viewId: string, options: ControlSchemaOptions): PillNav
     ...(config?.to !== undefined ? { to: config.to } : {}),
     ...(config?.href !== undefined ? { href: config.href } : {}),
     ...(config?.disabled !== undefined ? { disabled: config.disabled } : {}),
-  }
-}
-
-function controlTopBarTab(viewId: string, options: ControlSchemaOptions): TopBarTab {
-  const config = options.views?.[viewId]
-  return {
-    id: viewId,
-    label: config?.label ?? humanize(viewId),
-    ...(config?.to !== undefined ? { to: config.to } : {}),
-    ...(config?.href !== undefined ? { href: config.href } : {}),
-    ...(config?.icon !== undefined ? { icon: config.icon } : {}),
-    ...(config?.disabled !== undefined ? { disabled: config.disabled } : {}),
     ...(config?.children !== undefined ? { children: config.children } : {}),
   }
 }

package/src/composables/usePluginClient.ts

@@ -7,6 +7,7 @@ import {
   getInjectedPlatformContext,
   resolveCurrentExperimentId,
 } from './platformContextHelpers'
+import type { ExperimentSummary, PageSelectorItem } from '../types'
 
 export type PluginHttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete'
 
@@ -90,7 +91,7 @@ export interface UseCurrentExperimentOptions {
   immediate?: boolean
 }
 
-export interface UseCurrentExperimentReturn<TExperiment = unknown> {
+export interface UseCurrentExperimentReturn<TExperiment = ExperimentSummary> {
   /** Current experiment id resolved from platform injection or URL conventions. */
   experimentId: ComputedRef<number | undefined>
   /** Whether a current experiment id is available. */
@@ -114,27 +115,67 @@ export interface UseCurrentExperimentReturn<TExperiment = unknown> {
 export type PluginEndpointCaller = (payload?: unknown) => Promise<unknown>
 export type GeneratedPluginClient = Record<string, (...args: any[]) => Promise<any>>
 
+function normalizeApiBaseUrl(baseUrl: string | undefined): string | undefined {
+  if (!baseUrl) return undefined
+  return baseUrl.length > 1 ? baseUrl.replace(/\/+$/, '') : baseUrl
+}
+
 function normalizeApiPrefix(prefix: string | undefined): string | undefined {
   if (!prefix) return undefined
-  if (prefix.startsWith('/api/')) return prefix
+  if (prefix.startsWith('/api/')) return normalizeApiBaseUrl(prefix)
   if (prefix === '/api') return prefix
-  if (prefix.startsWith('/')) return `/api${prefix}`
-  return `/api/${prefix}`
+  if (prefix.startsWith('/')) return normalizeApiBaseUrl(`/api${prefix}`)
+  return normalizeApiBaseUrl(`/api/${prefix}`)
+}
+
+function normalizePluginNavPath(path: string): string {
+  const raw = path.trim() || '/'
+  const prefixed = raw.startsWith('/') ? raw : `/${raw}`
+  return prefixed.replace(/\/+$/, '') || '/'
+}
+
+function pluginPageIdFromPath(path: string, fallbackIndex: number): string {
+  const normalizedPath = normalizePluginNavPath(path)
+  if (normalizedPath === '/') return 'dashboard'
+  return normalizedPath.replace(/^\/+/, '').replace(/\/+/g, '-') || `page-${fallbackIndex + 1}`
+}
+
+/** Convert PluginMetadata.nav_items into AppTopBar pageSelector items for topbar page switches, homepage PluginCards, and fallback views. */
+export function getPluginPageSelectorItems(contract: PluginContract): PageSelectorItem[] {
+  const pluginIcon = contract.plugin.icon ?? ''
+  const navItems = contract.plugin.navItems ?? []
+  const source: PluginNavItemContract[] = navItems.length > 0
+    ? navItems
+    : [{
+        path: '/',
+        label: contract.plugin.name ?? 'Dashboard',
+        id: 'dashboard',
+        icon: pluginIcon || undefined,
+        description: contract.plugin.description,
+      }]
+
+  return source.map((item, index) => ({
+    id: item.id || pluginPageIdFromPath(item.path, index),
+    label: item.label,
+    to: normalizePluginNavPath(item.path),
+    icon: item.icon || pluginIcon || undefined,
+    hint: item.description || contract.plugin.name,
+  }))
 }
 
 /** Resolve the runtime plugin API base URL from env, explicit options, platform injection, or contract metadata. */
 export function resolvePluginBaseUrl(contract: PluginContract, explicitBaseUrl?: string): string {
   const envPrefix = (import.meta.env?.VITE_API_PREFIX as string | undefined) || undefined
-  if (envPrefix) return envPrefix
-  if (explicitBaseUrl) return explicitBaseUrl
+  if (envPrefix) return normalizeApiBaseUrl(envPrefix) ?? envPrefix
+  if (explicitBaseUrl) return normalizeApiBaseUrl(explicitBaseUrl) ?? explicitBaseUrl
 
   const injected = getInjectedPlatformContext()
   const platformPrefix =
-    injected?.plugin?.api_prefix ||
+    normalizeApiBaseUrl(injected?.plugin?.api_prefix) ||
     normalizeApiPrefix(injected?.plugin?.route_prefix)
   if (platformPrefix) return platformPrefix
 
-  return contract.plugin.apiPrefix || '/api'
+  return normalizeApiBaseUrl(contract.plugin.apiPrefix) || '/api'
 }
 
 function encodePath(path: string, payload: Record<string, unknown>, pathParams: string[]): string {
@@ -352,7 +393,7 @@ export function usePluginSettings<TSettings = Record<string, unknown>>() {
 }
 
 /** Read and optionally load the current platform experiment for integrated plugin views. */
-export function useCurrentExperiment<TExperiment = unknown>(
+export function useCurrentExperiment<TExperiment = ExperimentSummary>(
   options: UseCurrentExperimentOptions = {},
 ): UseCurrentExperimentReturn<TExperiment> {
   const api = useApi({ baseUrl: options.apiBaseUrl ?? getInjectedPlatformContext()?.platformApiUrl })