@morscherlab/mint-sdk 1.1.4 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/dist/{EmptyState-LMPS3keb.js → EmptyState-p90quq8Z.js} +2 -2
  2. package/dist/{EmptyState-LMPS3keb.js.map → EmptyState-p90quq8Z.js.map} +1 -1
  3. package/dist/{ExperimentPopover-D6_RGzTY.js → ExperimentPopover-tLwJ7XF4.js} +3 -3
  4. package/dist/{ExperimentPopover-D6_RGzTY.js.map → ExperimentPopover-tLwJ7XF4.js.map} +1 -1
  5. package/dist/{ExperimentSelectorModal-DcQ38zua.js → ExperimentSelectorModal-B6P2msT4.js} +12 -5
  6. package/dist/ExperimentSelectorModal-B6P2msT4.js.map +1 -0
  7. package/dist/{SettingsModal-Ccq2z-Ms.js → SettingsModal-D7LFUokT.js} +100 -156
  8. package/dist/SettingsModal-D7LFUokT.js.map +1 -0
  9. package/dist/__tests__/components/ActionMenu.test.d.ts +1 -0
  10. package/dist/__tests__/components/BaseModal.test.d.ts +1 -0
  11. package/dist/components/ActionMenu.vue.d.ts +21 -0
  12. package/dist/components/BaseModal.vue.d.ts +17 -1
  13. package/dist/components/GeneratedPluginView.vue.d.ts +3 -3
  14. package/dist/components/GeneratedResultRenderer.vue.d.ts +3 -3
  15. package/dist/components/index.d.ts +1 -0
  16. package/dist/components/index.js +8 -8
  17. package/dist/{components-CV5zuWa8.js → components-Dra_ac_5.js} +350 -71
  18. package/dist/components-Dra_ac_5.js.map +1 -0
  19. package/dist/composables/controlSchemaDoseDesign.d.ts +8 -1
  20. package/dist/composables/controlSchemaModel.d.ts +10 -1
  21. package/dist/composables/index.js +8 -8
  22. package/dist/composables/useAnalysisArtifacts.d.ts +9 -1
  23. package/dist/composables/useAppExperiment.d.ts +7 -0
  24. package/dist/composables/useBioTemplatePackWorkspace.d.ts +9 -1
  25. package/dist/composables/useControlWorkspace.d.ts +9 -1
  26. package/dist/composables/useGeneratedAnalysis.d.ts +9 -0
  27. package/dist/{composables-CW8NRXLB.js → composables-CRR_JxQD.js} +4 -4
  28. package/dist/{composables-CW8NRXLB.js.map → composables-CRR_JxQD.js.map} +1 -1
  29. package/dist/{experiment-utils-7Yw-h0tD.js → experiment-utils-CLnzPPq5.js} +170 -13
  30. package/dist/experiment-utils-CLnzPPq5.js.map +1 -0
  31. package/dist/index.js +13 -13
  32. package/dist/install.js +7 -7
  33. package/dist/styles.css +764 -610
  34. package/dist/templates/index.js +4 -4
  35. package/dist/{templates-CJRFiWUX.js → templates-Cr-48-u2.js} +2 -2
  36. package/dist/{templates-CJRFiWUX.js.map → templates-Cr-48-u2.js.map} +1 -1
  37. package/dist/types/components.d.ts +32 -0
  38. package/dist/types/index.d.ts +1 -1
  39. package/dist/{useControlSchema-BEAgLyyx.js → useControlSchema-BMVb2XIQ.js} +58 -10
  40. package/dist/useControlSchema-BMVb2XIQ.js.map +1 -0
  41. package/dist/{useDropdownState-Be-ug_ci.js → useDropdownState-DSb3BC3N.js} +2 -2
  42. package/dist/{useDropdownState-Be-ug_ci.js.map → useDropdownState-DSb3BC3N.js.map} +1 -1
  43. package/dist/{useExperimentSelector-DFg_iEHI.js → useExperimentSelector-D0pjj9WH.js} +3 -3
  44. package/dist/{useExperimentSelector-DFg_iEHI.js.map → useExperimentSelector-D0pjj9WH.js.map} +1 -1
  45. package/dist/{useFormBuilder-CR9pBApW.js → useFormBuilder-DG3HOFGA.js} +2 -2
  46. package/dist/{useFormBuilder-CR9pBApW.js.map → useFormBuilder-DG3HOFGA.js.map} +1 -1
  47. package/dist/{useProtocolTemplates-DXeIHMwV.js → useProtocolTemplates-BMt0LlXf.js} +21 -6
  48. package/dist/useProtocolTemplates-BMt0LlXf.js.map +1 -0
  49. package/package.json +1 -1
  50. package/src/__tests__/components/ActionMenu.test.ts +99 -0
  51. package/src/__tests__/components/BaseModal.test.ts +133 -0
  52. package/src/__tests__/components/SettingsModal.test.ts +9 -7
  53. package/src/__tests__/docs/extractDocsComponents.test.ts +15 -1
  54. package/src/__tests__/docs/extractDocsParsing.test.ts +22 -0
  55. package/src/__tests__/docs/frontendDocsCatalog.test.ts +80 -0
  56. package/src/components/ActionMenu.story.vue +26 -0
  57. package/src/components/ActionMenu.vue +212 -0
  58. package/src/components/AppSidebar.vue +2 -13
  59. package/src/components/ArtifactSelectorModal.vue +8 -1
  60. package/src/components/BaseModal.story.vue +107 -1
  61. package/src/components/BaseModal.vue +152 -4
  62. package/src/components/BioTemplateExperimentWorkspaceView.vue +8 -1
  63. package/src/components/BioTemplatePackWorkspaceView.vue +8 -1
  64. package/src/components/BioTemplatePresetWorkspaceView.vue +8 -1
  65. package/src/components/BioTemplateRenderer.vue +8 -1
  66. package/src/components/ComponentBindingRenderer.vue +8 -1
  67. package/src/components/ControlWorkspaceView.vue +8 -1
  68. package/src/components/DoseDesignWorkspaceView.vue +8 -1
  69. package/src/components/ExperimentSelectorModal.vue +8 -1
  70. package/src/components/FormBuilder.vue +5 -0
  71. package/src/components/GeneratedPluginView.vue +12 -2
  72. package/src/components/GeneratedResultRenderer.vue +12 -2
  73. package/src/components/JobsStatusTray.vue +8 -1
  74. package/src/components/PluginWorkspaceView.vue +10 -1
  75. package/src/components/SettingsModal.vue +102 -149
  76. package/src/components/index.ts +1 -0
  77. package/src/composables/controlSchemaDoseDesign.ts +8 -1
  78. package/src/composables/controlSchemaModel.ts +10 -1
  79. package/src/composables/useAnalysisArtifacts.ts +9 -1
  80. package/src/composables/useAppExperiment.ts +7 -0
  81. package/src/composables/useBioTemplatePackWorkspace.ts +9 -1
  82. package/src/composables/useControlWorkspace.ts +9 -1
  83. package/src/composables/useGeneratedAnalysis.ts +9 -0
  84. package/src/styles/components/action-menu.css +59 -0
  85. package/src/styles/components/icon-button.css +7 -3
  86. package/src/styles/components/modal.css +293 -0
  87. package/src/styles/components/settings-modal.css +3 -273
  88. package/src/styles/index.css +1 -0
  89. package/src/types/components.ts +38 -0
  90. package/src/types/index.ts +3 -0
  91. package/dist/ExperimentSelectorModal-DcQ38zua.js.map +0 -1
  92. package/dist/SettingsModal-Ccq2z-Ms.js.map +0 -1
  93. package/dist/components-CV5zuWa8.js.map +0 -1
  94. package/dist/experiment-utils-7Yw-h0tD.js.map +0 -1
  95. package/dist/useControlSchema-BEAgLyyx.js.map +0 -1
  96. package/dist/useProtocolTemplates-DXeIHMwV.js.map +0 -1
@@ -7,5 +7,12 @@ export declare function defineDoseCalculatorControlProps<TValues extends Record<
7
7
  export declare function defineWellPlateDoseControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(options?: WellPlateDoseControlPropsOptions<TValues>): ControlComponentPropsByIdMap<TValues>;
8
8
  /** Return named WellPlate + DoseCalculator component bindings for one dose-design control model. */
9
9
  export declare function defineWellPlateDoseComponentBindings<TValues extends Record<string, unknown> = Record<string, unknown>>(options?: WellPlateDoseControlPropsOptions<TValues>): ControlComponentBindingsConfig<TValues>;
10
- /** Return a complete ControlWorkspaceView model for WellPlate + DoseCalculator dose design. */
10
+ /**
11
+ * Return a complete ControlWorkspaceView model for WellPlate + DoseCalculator dose design.
12
+ *
13
+ * @example Recommended
14
+ * ```ts
15
+ * const workspaceModel = defineDoseDesignControlModel({ selectedWells: ['A1', 'A2'] })
16
+ * ```
17
+ */
11
18
  export declare function defineDoseDesignControlModel(options?: DoseDesignControlModelOptions): ControlModelBinding;
@@ -1,5 +1,14 @@
1
1
  import { ControlModel, ControlModelBinding } from './controlSchemaTypes';
2
2
  export declare function isControlModelBinding<TBinding extends ControlModelBinding = ControlModelBinding>(model: unknown): model is TBinding;
3
3
  export declare function resolveControlModel(model: ControlModel | ControlModelBinding | undefined): ControlModelBinding | undefined;
4
- /** Create a complete workspace component binding from a simple controls data model for ControlWorkspaceView, generated forms, and sidebars. */
4
+ /**
5
+ * Create a complete workspace component binding from a simple controls data model for ControlWorkspaceView, generated forms, and sidebars.
6
+ *
7
+ * @example Recommended
8
+ * ```ts
9
+ * const workspaceModel = defineControlModel({
10
+ * controls: { threshold: { type: 'number', default: 0.05 } },
11
+ * })
12
+ * ```
13
+ */
5
14
  export declare function defineControlModel(model: ControlModel): ControlModelBinding;
@@ -1,11 +1,11 @@
1
- import { a as SORT_OPTIONS, c as formatExperimentDate, d as resolveExperimentCode, i as EXPERIMENT_STATUS_VARIANT_MAP, l as formatExperimentStatus, n as EXPERIMENT_STATUS_LABELS, o as datePresetToISO, p as useEventListener, r as EXPERIMENT_STATUS_OPTIONS, s as experimentIdFromRoute, t as DATE_PRESET_OPTIONS, u as getExperimentStatusVariant } from "../experiment-utils-7Yw-h0tD.js";
2
- import { r as useRequestSyncState } from "../EmptyState-LMPS3keb.js";
3
- import { A as useConcentrationUnits, B as useAnalysisArtifacts, C as controlsToViewIds, D as getTypeDefault, E as getFieldRegistryEntry, Et as useSelectionLimit, F as ATOMIC_WEIGHTS, G as resolveCurrentPluginId, I as useChemicalFormula, J as usePluginJobs, K as createGeneratedAnalysisTransport, N as useSequenceUtils, S as controlsToTopBarSettingsConfig, St as useTimeUtils, T as getDefaultControlView, Tt as useListSelection, _ as controlsToFormSchema, _t as isTimeInRange, a as defineDoseCalculatorControlProps, b as controlsToSettingsSchema, bt as snapToSlot, c as defineWellPlateDoseComponentBindings, ct as compareTime, d as defineControlModel, dt as findNearestTimeSlotIndex, ft as formatDuration, gt as generateTimeSlots, h as controlValuesToComponentProps, ht as fromMinutes, i as useControlSchema, l as defineWellPlateDoseControlProps, lt as durationMinutes, m as controlValuesToComponentBindingsById, mt as formatTimeSlot, n as defineControls, o as defineDoseDesignControlModel, p as controlValuesToComponentBindings, pt as formatTime, q as useGeneratedAnalysis, r as getControlDefaults, s as defineWellPlateControlProps, st as addMinutes, t as defineControlComponentBindings, u as useControlWorkspace, ut as findAvailableSlots, v as controlsToSectionFormSchema, vt as parseTime, w as controlsToViewItems, x as controlsToSidebarPanels, xt as toMinutes, y as controlsToSectionFormSchemas, yt as rangesOverlap } from "../useControlSchema-BEAgLyyx.js";
4
- import { A as extractSamplesFromDesignData, B as useJobsStatusTray, D as readFileAsText, E as parseDelimitedText, F as unwrapExperimentDesignData, G as useAppExperiment, H as DEFAULT_MOBILE_VIEWPORT_QUERY, I as DEFAULT_COLORS, J as candidateMatchesSearch, K as useTheme, L as useWellPlateEditor, N as extractSampleNamesFromDesignData, O as useFileImport, P as extractSampleOptionsFromDesignData, Q as useSortedItems, R as useDoseCalculator, T as detectDelimiter, U as useMobileSupportGate, V as usePluginJobCenter, W as APP_EXPERIMENT_KEY, X as useTextSearch, Y as normalizeSearchQuery, Z as compareSortValues, _ as useScheduleDrag, a as useReagentSeries, b as useExpansionSet, c as useBioTemplatePresetWorkspace, d as getBioTemplateComponentProps, f as toBioTemplateComponentPropsByComponent, g as useExperimentSave, h as useTemplateCollection, i as generateDilutionSeries, j as useAutoGroup, k as validateImportFile, l as useBioTemplatePackWorkspace, m as useBioTemplateControls, n as DEFAULT_PRESETS, o as useGroupAssignment, p as useBioTemplateComponents, q as useToast, r as DEFAULT_UNITS, s as useRackEditor, t as useProtocolTemplates, u as useBioTemplateWorkspace, v as useExperimentSamples, x as useSampleGroups, y as useExperimentData, z as combinePluginJobSources } from "../useProtocolTemplates-DXeIHMwV.js";
1
+ import { a as SORT_OPTIONS, c as formatExperimentDate, d as resolveExperimentCode, i as EXPERIMENT_STATUS_VARIANT_MAP, l as formatExperimentStatus, n as EXPERIMENT_STATUS_LABELS, o as datePresetToISO, p as useEventListener, r as EXPERIMENT_STATUS_OPTIONS, s as experimentIdFromRoute, t as DATE_PRESET_OPTIONS, u as getExperimentStatusVariant } from "../experiment-utils-CLnzPPq5.js";
2
+ import { r as useRequestSyncState } from "../EmptyState-p90quq8Z.js";
3
+ import { A as useConcentrationUnits, B as useAnalysisArtifacts, C as controlsToViewIds, D as getTypeDefault, E as getFieldRegistryEntry, Et as useSelectionLimit, F as ATOMIC_WEIGHTS, G as resolveCurrentPluginId, I as useChemicalFormula, J as usePluginJobs, K as createGeneratedAnalysisTransport, N as useSequenceUtils, S as controlsToTopBarSettingsConfig, St as useTimeUtils, T as getDefaultControlView, Tt as useListSelection, _ as controlsToFormSchema, _t as isTimeInRange, a as defineDoseCalculatorControlProps, b as controlsToSettingsSchema, bt as snapToSlot, c as defineWellPlateDoseComponentBindings, ct as compareTime, d as defineControlModel, dt as findNearestTimeSlotIndex, ft as formatDuration, gt as generateTimeSlots, h as controlValuesToComponentProps, ht as fromMinutes, i as useControlSchema, l as defineWellPlateDoseControlProps, lt as durationMinutes, m as controlValuesToComponentBindingsById, mt as formatTimeSlot, n as defineControls, o as defineDoseDesignControlModel, p as controlValuesToComponentBindings, pt as formatTime, q as useGeneratedAnalysis, r as getControlDefaults, s as defineWellPlateControlProps, st as addMinutes, t as defineControlComponentBindings, u as useControlWorkspace, ut as findAvailableSlots, v as controlsToSectionFormSchema, vt as parseTime, w as controlsToViewItems, x as controlsToSidebarPanels, xt as toMinutes, y as controlsToSectionFormSchemas, yt as rangesOverlap } from "../useControlSchema-BMVb2XIQ.js";
4
+ import { A as extractSamplesFromDesignData, B as useJobsStatusTray, D as readFileAsText, E as parseDelimitedText, F as unwrapExperimentDesignData, G as useAppExperiment, H as DEFAULT_MOBILE_VIEWPORT_QUERY, I as DEFAULT_COLORS, J as candidateMatchesSearch, K as useTheme, L as useWellPlateEditor, N as extractSampleNamesFromDesignData, O as useFileImport, P as extractSampleOptionsFromDesignData, Q as useSortedItems, R as useDoseCalculator, T as detectDelimiter, U as useMobileSupportGate, V as usePluginJobCenter, W as APP_EXPERIMENT_KEY, X as useTextSearch, Y as normalizeSearchQuery, Z as compareSortValues, _ as useScheduleDrag, a as useReagentSeries, b as useExpansionSet, c as useBioTemplatePresetWorkspace, d as getBioTemplateComponentProps, f as toBioTemplateComponentPropsByComponent, g as useExperimentSave, h as useTemplateCollection, i as generateDilutionSeries, j as useAutoGroup, k as validateImportFile, l as useBioTemplatePackWorkspace, m as useBioTemplateControls, n as DEFAULT_PRESETS, o as useGroupAssignment, p as useBioTemplateComponents, q as useToast, r as DEFAULT_UNITS, s as useRackEditor, t as useProtocolTemplates, u as useBioTemplateWorkspace, v as useExperimentSamples, x as useSampleGroups, y as useExperimentData, z as combinePluginJobSources } from "../useProtocolTemplates-BMt0LlXf.js";
5
5
  import { r as useApi, t as AuthenticationRequiredError } from "../useApi-CDBq6z23.js";
6
- import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as useFormBuilder } from "../useFormBuilder-CR9pBApW.js";
6
+ import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as useFormBuilder } from "../useFormBuilder-DG3HOFGA.js";
7
7
  import { t as ANALYSIS_FILE_ARTIFACT_SCHEMA } from "../analysisArtifactTypes-DQ0MjwHZ.js";
8
- import { B as toBioTemplateComponentProps, H as toBioTemplateComponentPropsById, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, R as toBioTemplateComponentBindingsById, l as requireBioTemplateControlSchema, o as getBioTemplateControlSchema } from "../templates-CJRFiWUX.js";
9
- import { n as useDebouncedWatch, t as useExperimentSelector } from "../useExperimentSelector-DFg_iEHI.js";
10
- import { A as useAsync, C as createPluginResourceClient, D as buildAnalysisArtifactTargetQuery, E as useCommandHistory, M as resolvePluginFrontendBase, N as usePasskey, O as parseAnalysisArtifactTarget, P as useAuth, S as wellIdsInRectangle, T as useOptimisticMutation, _ as createWellPlateWells, a as pluginFormDataFromPayload, b as useWellPainting, c as usePluginClient, d as buildPluginEndpointUrl, f as resolvePluginBaseUrl, g as createRowConditions, h as createColumnConditions, i as getPluginPageSelectorItems, j as useAsyncBatch, k as usePluginConfig, l as usePluginEventStream, m as useWellPlateValidation, n as downloadBlob, o as uploadPluginEndpoint, p as runWellPlateValidation, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as usePluginSettings, v as useWellPlateAdapter, w as useResourceCrud, x as wellIdToCoordinate, y as coordinateToWellId } from "../composables-CW8NRXLB.js";
8
+ import { B as toBioTemplateComponentProps, H as toBioTemplateComponentPropsById, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, R as toBioTemplateComponentBindingsById, l as requireBioTemplateControlSchema, o as getBioTemplateControlSchema } from "../templates-Cr-48-u2.js";
9
+ import { n as useDebouncedWatch, t as useExperimentSelector } from "../useExperimentSelector-D0pjj9WH.js";
10
+ import { A as useAsync, C as createPluginResourceClient, D as buildAnalysisArtifactTargetQuery, E as useCommandHistory, M as resolvePluginFrontendBase, N as usePasskey, O as parseAnalysisArtifactTarget, P as useAuth, S as wellIdsInRectangle, T as useOptimisticMutation, _ as createWellPlateWells, a as pluginFormDataFromPayload, b as useWellPainting, c as usePluginClient, d as buildPluginEndpointUrl, f as resolvePluginBaseUrl, g as createRowConditions, h as createColumnConditions, i as getPluginPageSelectorItems, j as useAsyncBatch, k as usePluginConfig, l as usePluginEventStream, m as useWellPlateValidation, n as downloadBlob, o as uploadPluginEndpoint, p as runWellPlateValidation, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as usePluginSettings, v as useWellPlateAdapter, w as useResourceCrud, x as wellIdToCoordinate, y as coordinateToWellId } from "../composables-CRR_JxQD.js";
11
11
  export { ANALYSIS_FILE_ARTIFACT_SCHEMA, APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, AuthenticationRequiredError, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_MOBILE_VIEWPORT_QUERY, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildAnalysisArtifactTargetQuery, buildPluginEndpointUrl, candidateMatchesSearch, combinePluginJobSources, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, coordinateToWellId, createColumnConditions, createGeneratedAnalysisTransport, createPluginClient, createPluginResourceClient, createRowConditions, createWellPlateWells, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, detectDelimiter, downloadBlob, downloadPluginEndpoint, durationMinutes, evaluateCondition, experimentIdFromRoute, extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getPluginPageSelectorItems, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseAnalysisArtifactTarget, parseDelimitedText, parseTime, pluginFormDataFromPayload, rangesOverlap, readFileAsText, requireBioTemplateControlSchema, resolveCurrentPluginId, resolveExperimentCode, resolvePluginBaseUrl, resolvePluginFrontendBase, runWellPlateValidation, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, unwrapExperimentDesignData, uploadPluginEndpoint, useAnalysisArtifacts, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useCommandHistory, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSamples, useExperimentSave, useExperimentSelector, useFileImport, useForm, useFormBuilder, useGeneratedAnalysis, useGroupAssignment, useJobsStatusTray, useListSelection, useMobileSupportGate, useOptimisticMutation, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginEventStream, usePluginJobCenter, usePluginJobs, usePluginSettings, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useResourceCrud, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPainting, useWellPlateAdapter, useWellPlateEditor, useWellPlateValidation, validateImportFile, wellIdToCoordinate, wellIdsInRectangle };
@@ -57,5 +57,13 @@ export interface UseAnalysisArtifactsReturn {
57
57
  /** Reset artifacts, selection, and error. */
58
58
  clear: () => void;
59
59
  }
60
- /** Lists and manages analysis artifacts through the user-facing platform API. */
60
+ /**
61
+ * Lists and manages analysis artifacts through the user-facing platform API.
62
+ *
63
+ * @example Recommended
64
+ * ```ts
65
+ * const artifacts = useAnalysisArtifacts({ pluginId: 'LEAF' })
66
+ * await artifacts.list()
67
+ * ```
68
+ */
61
69
  export declare function useAnalysisArtifacts(options?: UseAnalysisArtifactsOptions): UseAnalysisArtifactsReturn;
@@ -74,5 +74,12 @@ export declare const APP_EXPERIMENT_KEY: InjectionKey<AppExperimentState>;
74
74
  * The composable never writes a selection of its own. `ExperimentSelectorModal`
75
75
  * commits to the store and this reads back, so a displayed name can only ever
76
76
  * have come from the platform.
77
+ *
78
+ * @example Recommended
79
+ * ```ts
80
+ * const appExperiment = useAppExperiment({
81
+ * onSelect: experiment => loadExperiment(experiment.id),
82
+ * })
83
+ * ```
77
84
  */
78
85
  export declare function useAppExperiment(options?: UseAppExperimentOptions): UseAppExperimentReturn;
@@ -42,5 +42,13 @@ export interface UseBioTemplatePackWorkspaceReturn {
42
42
  loadCurrent: UseTemplateCollectionReturn['loadCurrent'];
43
43
  requireCurrentExperimentId: UseTemplateCollectionReturn['requireCurrentExperimentId'];
44
44
  }
45
- /** Create a complete workspace for a curated biology template pack from a single pack id. */
45
+ /**
46
+ * Create a complete workspace for a curated biology template pack from a single pack id.
47
+ *
48
+ * @example Recommended
49
+ * ```ts
50
+ * const pack = useBioTemplatePackWorkspace('cell-culture-screen')
51
+ * await pack.loadCurrent()
52
+ * ```
53
+ */
46
54
  export declare function useBioTemplatePackWorkspace(packId: TemplatePackId | string, options?: UseBioTemplatePackWorkspaceOptions): UseBioTemplatePackWorkspaceReturn;
@@ -1,5 +1,13 @@
1
1
  import { ControlModelBinding, ControlSchema, ControlWorkspaceOptions, UseControlWorkspaceReturn } from './controlSchemaTypes';
2
- /** Prepare shared reactive values plus AppTopBar/AppSidebar/FormBuilder bindings from one simple controls data model. */
2
+ /**
3
+ * Prepare shared reactive values plus AppTopBar/AppSidebar/FormBuilder bindings from one simple controls data model.
4
+ *
5
+ * @example Recommended
6
+ * ```ts
7
+ * const workspace = useControlWorkspace(workspaceModel)
8
+ * const { form, sidebar, topBar } = workspace.bindings
9
+ * ```
10
+ */
3
11
  export declare function useControlWorkspace<TControls extends ControlSchema>(controlsOrModel: TControls | (ControlModelBinding & {
4
12
  controls: TControls;
5
13
  }), options?: ControlWorkspaceOptions): UseControlWorkspaceReturn<TControls>;
@@ -59,4 +59,13 @@ export interface UsePluginJobsReturn extends PluginJobCenterSource {
59
59
  export type UseGeneratedAnalysisReturn = UsePluginJobsReturn;
60
60
  export declare function createGeneratedAnalysisTransport(options?: GeneratedAnalysisTransportOptions): GeneratedAnalysisTransport;
61
61
  export declare function useGeneratedAnalysis(options: GeneratedAnalysisOptions): UseGeneratedAnalysisReturn;
62
+ /**
63
+ * Connect a custom plugin frontend to the SDK-owned job lifecycle.
64
+ *
65
+ * @example Recommended
66
+ * ```ts
67
+ * const jobs = usePluginJobs({ baseUrl: '/api/leaf/jobs' })
68
+ * await jobs.initialize()
69
+ * ```
70
+ */
62
71
  export declare function usePluginJobs(options: UsePluginJobsOptions): UsePluginJobsReturn;
@@ -1,7 +1,7 @@
1
- import { r as useRequestSyncState } from "./EmptyState-LMPS3keb.js";
2
- import { H as getInjectedPlatformContext, V as currentExperimentFromContext, W as resolveCurrentExperimentId } from "./useControlSchema-BEAgLyyx.js";
1
+ import { r as useRequestSyncState } from "./EmptyState-p90quq8Z.js";
2
+ import { H as getInjectedPlatformContext, V as currentExperimentFromContext, W as resolveCurrentExperimentId } from "./useControlSchema-BMVb2XIQ.js";
3
3
  import { i as useAuthStore, n as authenticationRequiredError, o as useSettingsStore, r as useApi, t as AuthenticationRequiredError } from "./useApi-CDBq6z23.js";
4
- import { i as usePlatformContext } from "./useFormBuilder-CR9pBApW.js";
4
+ import { i as usePlatformContext } from "./useFormBuilder-DG3HOFGA.js";
5
5
  import { computed, getCurrentInstance, onMounted, onUnmounted, ref, shallowRef, toValue, watch } from "vue";
6
6
  import axios from "axios";
7
7
  //#region src/composables/useAuth.ts
@@ -2041,4 +2041,4 @@ function useCurrentExperiment(options = {}) {
2041
2041
  //#endregion
2042
2042
  export { useAsync as A, createPluginResourceClient as C, buildAnalysisArtifactTargetQuery as D, useCommandHistory as E, resolvePluginFrontendBase as M, usePasskey as N, parseAnalysisArtifactTarget as O, useAuth as P, wellIdsInRectangle as S, useOptimisticMutation as T, createWellPlateWells as _, pluginFormDataFromPayload as a, useWellPainting as b, usePluginClient as c, buildPluginEndpointUrl as d, resolvePluginBaseUrl as f, createRowConditions as g, createColumnConditions as h, getPluginPageSelectorItems as i, useAsyncBatch as j, usePluginConfig as k, usePluginEventStream as l, useWellPlateValidation as m, downloadBlob as n, uploadPluginEndpoint as o, runWellPlateValidation as p, downloadPluginEndpoint as r, useCurrentExperiment as s, createPluginClient as t, usePluginSettings as u, useWellPlateAdapter as v, useResourceCrud as w, wellIdToCoordinate as x, coordinateToWellId as y };
2043
2043
 
2044
- //# sourceMappingURL=composables-CW8NRXLB.js.map
2044
+ //# sourceMappingURL=composables-CRR_JxQD.js.map