@morscherlab/mint-sdk 1.4.0-beta.14 → 1.4.0-beta.16

package/dist/runtime.js

@@ -2,7 +2,7 @@ import { i as AuthenticationRequiredError, o as useApi } from "./experiment-DyO5
 import { c as isTerminalJobStatus, d as normalizeJobState, f as resolveJobCapabilities, l as jobStatusLabel, o as resolveCurrentPluginId, s as isActiveJobStatus, u as normalizeJobPercent } from "./records-B4yl2oIu.js";
 import { A as createGeneratedAnalysisTransport, D as GeneratedPathInput_default, _ as getFieldRegistryEntry, j as useJobsEndpoint, v as getTypeDefault } from "./useListReorder-C_8RYeVP.js";
 import { a as GeneratedPlotlyResult_default, c as downloadEndpoint, d as useEventStream, f as useSettingsEndpoint, i as GeneratedResultRenderer_default, l as pluginFormDataFromPayload, m as resolvePluginBaseUrl, o as createClient, p as buildEndpointUrl, u as uploadEndpoint } from "./useRackEditor-BhYlXKFM.js";
-import { a as ComponentBindingRenderer_default, c as generatedJobFormSchema, f as useControlWorkspace, i as RuntimeUpdateNotice_default, l as normalizeGeneratedJobInput, n as PresenceAvatars_default, o as GeneratedPluginView_default, r as usePresence, s as generatedJobDefaults } from "./runtime-BJvGms6h.js";
-import { A as getDefaultControlView, C as controlBindings, D as controlsTo, S as useControlSchema, b as defineControls, d as useForm, l as useFormBuilder, u as evaluateCondition, x as getControlDefaults, y as defineControlComponentBindings } from "./AppSidebar-Bi8g9mRt.js";
+import { a as ComponentBindingRenderer_default, c as generatedJobFormSchema, f as useControlWorkspace, i as RuntimeUpdateNotice_default, l as normalizeGeneratedJobInput, n as PresenceAvatars_default, o as GeneratedPluginView_default, r as usePresence, s as generatedJobDefaults } from "./runtime-Cz1GJa_O.js";
+import { D as useControlSchema, E as getControlDefaults, F as getDefaultControlView, M as controlsTo, O as controlBindings, T as defineControls, d as useForm, l as useFormBuilder, u as evaluateCondition, w as defineControlComponentBindings } from "./AppSidebar-CB0-RQ4m.js";
 import { a as combinePluginJobSources, o as useJobCenter, r as useRealtime } from "./useRealtime-CUMbW_ln.js";
 export { AuthenticationRequiredError, ComponentBindingRenderer_default as ComponentBindingRenderer, GeneratedPathInput_default as GeneratedPathInput, GeneratedPlotlyResult_default as GeneratedPlotlyResult, GeneratedPluginView_default as GeneratedPluginView, GeneratedResultRenderer_default as GeneratedResultRenderer, PresenceAvatars_default as PresenceAvatars, RuntimeUpdateNotice_default as RuntimeUpdateNotice, buildEndpointUrl, combinePluginJobSources, controlBindings, controlsTo, createClient, createGeneratedAnalysisTransport, defineControlComponentBindings, defineControls, downloadEndpoint, evaluateCondition, generatedJobDefaults, generatedJobFormSchema, getControlDefaults, getDefaultControlView, getFieldRegistryEntry, getTypeDefault, isActiveJobStatus, isTerminalJobStatus, jobStatusLabel, normalizeGeneratedJobInput, normalizeJobPercent, normalizeJobState, pluginFormDataFromPayload, resolveCurrentPluginId, resolveJobCapabilities, resolvePluginBaseUrl, uploadEndpoint, useApi, useControlSchema, useControlWorkspace, useEventStream, useForm, useFormBuilder, useJobCenter, useJobsEndpoint, usePresence, useRealtime, useSettingsEndpoint };

package/dist/{shell-Czyrzk7l.js → shell-kq9p4VsX.js}

@@ -1,7 +1,7 @@
 import { i as useEventListener, o as __exportAll, r as useFocusTrap } from "./useDropdownState-Bb2N4m40.js";
 import { E as useMenuKeyboard, H as useListSelection, R as useRovingFocus, U as useSelectionLimit } from "./records-B4yl2oIu.js";
 import { B as compareSortValues, V as useSortedItems, i as useReorderAnnouncer, n as reorderList, r as useListReorder, t as REORDER_ANNOUNCER_STYLE } from "./useListReorder-C_8RYeVP.js";
-import { _ as AppLayout_default, f as AppTopBar_default, t as AppSidebar_default, v as usePluginWorkspace } from "./AppSidebar-Bi8g9mRt.js";
+import { C as usePluginWorkspace, S as AppLayout_default, _ as provideOnboarding, f as AppTopBar_default, g as defineOnboarding, h as ONBOARDING_KEY, m as ANCHOR_WAIT_MS, t as AppSidebar_default, v as useOnboarding } from "./AppSidebar-CB0-RQ4m.js";
 import { t as useDebouncedWatch } from "./useDebouncedWatch-BPwyl6eS.js";
 import { t as useExpansionSet } from "./useExpansionSet-CvoNMZJi.js";
 import { computed, createElementBlock, createElementVNode, defineComponent, normalizeClass, onBeforeUnmount, openBlock, shallowRef, toValue, watch } from "vue";
@@ -167,12 +167,16 @@ function useManualLayoutResize(options) {
 //#endregion
 //#region src/shell.ts
 var shell_exports = /* @__PURE__ */ __exportAll({
+	ANCHOR_WAIT_MS: () => ANCHOR_WAIT_MS,
 	AppLayout: () => AppLayout_default,
 	AppSidebar: () => AppSidebar_default,
 	AppTopBar: () => AppTopBar_default,
 	LayoutResizeHandle: () => LayoutResizeHandle_default,
+	ONBOARDING_KEY: () => ONBOARDING_KEY,
 	REORDER_ANNOUNCER_STYLE: () => REORDER_ANNOUNCER_STYLE,
 	compareSortValues: () => compareSortValues,
+	defineOnboarding: () => defineOnboarding,
+	provideOnboarding: () => provideOnboarding,
 	reorderList: () => reorderList,
 	resizedLeadingPanelWidth: () => resizedLeadingPanelWidth,
 	resizedTrailingPanelWidth: () => resizedTrailingPanelWidth,
@@ -185,6 +189,7 @@ var shell_exports = /* @__PURE__ */ __exportAll({
 	useListSelection: () => useListSelection,
 	useManualLayoutResize: () => useManualLayoutResize,
 	useMenuKeyboard: () => useMenuKeyboard,
+	useOnboarding: () => useOnboarding,
 	usePluginWorkspace: () => usePluginWorkspace,
 	useReorderAnnouncer: () => useReorderAnnouncer,
 	useRovingFocus: () => useRovingFocus,
@@ -194,4 +199,4 @@ var shell_exports = /* @__PURE__ */ __exportAll({
 //#endregion
 export { useManualLayoutResize as a, resizedVerticalSplitPercent as i, resizedLeadingPanelWidth as n, LayoutResizeHandle_default as o, resizedTrailingPanelWidth as r, shell_exports as t };
 
-//# sourceMappingURL=shell-Czyrzk7l.js.map
+//# sourceMappingURL=shell-kq9p4VsX.js.map

package/dist/{shell-Czyrzk7l.js.map → shell-kq9p4VsX.js.map}

@@ -1 +1 @@
-{"version":3,"file":"shell-Czyrzk7l.js","names":[],"sources":["../src/components/LayoutResizeHandle.vue","../src/components/LayoutResizeHandle.vue","../src/composables/useManualLayoutResize.ts","../src/shell.ts"],"sourcesContent":["<script setup lang=\"ts\">\n/** Accessible pointer and keyboard handle for resizable workbench panes. */\ninterface Props {\n  modelValue: number\n  min: number\n  max: number\n  label: string\n  orientation: 'vertical' | 'horizontal'\n  edge?: 'left' | 'right'\n  step?: number\n  disabled?: boolean\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n  edge: undefined,\n  step: 10,\n  disabled: false,\n})\n\nconst emit = defineEmits<{\n  'update:modelValue': [value: number]\n  'resize-start': [event: PointerEvent]\n}>()\n\nfunction update(value: number): void {\n  emit('update:modelValue', Math.min(props.max, Math.max(props.min, value)))\n}\n\nfunction handleKeydown(event: KeyboardEvent): void {\n  if (props.disabled) return\n  const decrement = props.orientation === 'vertical' ? 'ArrowLeft' : 'ArrowUp'\n  const increment = props.orientation === 'vertical' ? 'ArrowRight' : 'ArrowDown'\n  if (event.key === decrement) update(props.modelValue - props.step)\n  else if (event.key === increment) update(props.modelValue + props.step)\n  else if (event.key === 'Home') update(props.min)\n  else if (event.key === 'End') update(props.max)\n  else return\n  event.preventDefault()\n}\n</script>\n\n<template>\n  <div\n    role=\"separator\"\n    :tabindex=\"disabled ? -1 : 0\"\n    :class=\"[\n      'mint-layout-resize-handle',\n      `mint-layout-resize-handle--${orientation}`,\n      edge ? `mint-layout-resize-handle--edge-${edge}` : '',\n    ]\"\n    :aria-label=\"label\"\n    :aria-orientation=\"orientation\"\n    :aria-valuemin=\"min\"\n    :aria-valuemax=\"max\"\n    :aria-valuenow=\"modelValue\"\n    :aria-disabled=\"disabled || undefined\"\n    @pointerdown=\"!disabled && emit('resize-start', $event)\"\n    @keydown=\"handleKeydown\"\n  >\n    <span class=\"mint-layout-resize-handle__bar\" aria-hidden=\"true\" />\n  </div>\n</template>\n","<script setup lang=\"ts\">\n/** Accessible pointer and keyboard handle for resizable workbench panes. */\ninterface Props {\n  modelValue: number\n  min: number\n  max: number\n  label: string\n  orientation: 'vertical' | 'horizontal'\n  edge?: 'left' | 'right'\n  step?: number\n  disabled?: boolean\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n  edge: undefined,\n  step: 10,\n  disabled: false,\n})\n\nconst emit = defineEmits<{\n  'update:modelValue': [value: number]\n  'resize-start': [event: PointerEvent]\n}>()\n\nfunction update(value: number): void {\n  emit('update:modelValue', Math.min(props.max, Math.max(props.min, value)))\n}\n\nfunction handleKeydown(event: KeyboardEvent): void {\n  if (props.disabled) return\n  const decrement = props.orientation === 'vertical' ? 'ArrowLeft' : 'ArrowUp'\n  const increment = props.orientation === 'vertical' ? 'ArrowRight' : 'ArrowDown'\n  if (event.key === decrement) update(props.modelValue - props.step)\n  else if (event.key === increment) update(props.modelValue + props.step)\n  else if (event.key === 'Home') update(props.min)\n  else if (event.key === 'End') update(props.max)\n  else return\n  event.preventDefault()\n}\n</script>\n\n<template>\n  <div\n    role=\"separator\"\n    :tabindex=\"disabled ? -1 : 0\"\n    :class=\"[\n      'mint-layout-resize-handle',\n      `mint-layout-resize-handle--${orientation}`,\n      edge ? `mint-layout-resize-handle--edge-${edge}` : '',\n    ]\"\n    :aria-label=\"label\"\n    :aria-orientation=\"orientation\"\n    :aria-valuemin=\"min\"\n    :aria-valuemax=\"max\"\n    :aria-valuenow=\"modelValue\"\n    :aria-disabled=\"disabled || undefined\"\n    @pointerdown=\"!disabled && emit('resize-start', $event)\"\n    @keydown=\"handleKeydown\"\n  >\n    <span class=\"mint-layout-resize-handle__bar\" aria-hidden=\"true\" />\n  </div>\n</template>\n","import { computed, onBeforeUnmount, shallowRef, toValue, watch, type MaybeRefOrGetter } from 'vue'\n\nexport interface ResizePanelWidthConstraints {\n  minWidth: number\n  maxWidth: number\n  mainMinWidth?: number\n  layoutGap?: number\n}\n\nexport interface ResizePercentConstraints {\n  minPercent: number\n  maxPercent: number\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value))\n}\n\nfunction availablePanelWidth(\n  containerWidth: number,\n  constraints: ResizePanelWidthConstraints,\n): number {\n  return Math.min(\n    constraints.maxWidth,\n    containerWidth - (constraints.mainMinWidth ?? 0) - (constraints.layoutGap ?? 0),\n  )\n}\n\nexport function resizedLeadingPanelWidth(\n  startWidth: number,\n  deltaX: number,\n  containerWidth: number,\n  constraints: ResizePanelWidthConstraints,\n): number {\n  return Math.round(clamp(\n    startWidth + deltaX,\n    constraints.minWidth,\n    Math.max(constraints.minWidth, availablePanelWidth(containerWidth, constraints)),\n  ))\n}\n\nexport function resizedTrailingPanelWidth(\n  startWidth: number,\n  deltaX: number,\n  containerWidth: number,\n  constraints: ResizePanelWidthConstraints,\n): number {\n  return resizedLeadingPanelWidth(startWidth, -deltaX, containerWidth, constraints)\n}\n\nexport function resizedVerticalSplitPercent(\n  startPercent: number,\n  deltaY: number,\n  containerHeight: number,\n  constraints: ResizePercentConstraints,\n): number {\n  if (containerHeight <= 0) return startPercent\n  return Math.round(clamp(\n    startPercent + (deltaY / containerHeight) * 100,\n    constraints.minPercent,\n    constraints.maxPercent,\n  ))\n}\n\nexport interface ManualLayoutResizeContext<TKind extends string> {\n  kind: TKind\n  startValue: number\n  deltaX: number\n  deltaY: number\n  containerRect: DOMRectReadOnly\n  secondaryRect: DOMRectReadOnly | null\n}\n\nexport interface ManualLayoutResizeTarget<TKind extends string> {\n  cursor?: string\n  getContainerElement: () => HTMLElement | null\n  getSecondaryElement?: () => HTMLElement | null\n  getStartValue: () => number\n  onResize: (context: ManualLayoutResizeContext<TKind>) => void\n}\n\n/** Coordinates pointer-driven resizing for one or more layout splitters. */\nexport function useManualLayoutResize<TKind extends string>(options: {\n  enabled: MaybeRefOrGetter<boolean>\n  resolveTarget: (kind: TKind) => ManualLayoutResizeTarget<TKind> | null\n}) {\n  const activeResize = shallowRef<{\n    kind: TKind\n    startClientX: number\n    startClientY: number\n    startValue: number\n    containerRect: DOMRectReadOnly\n    secondaryRect: DOMRectReadOnly | null\n    cursor: string\n  } | null>(null)\n  const isResizing = computed(() => activeResize.value !== null)\n  let previousBodyCursor = ''\n  let previousBodyUserSelect = ''\n\n  function stopResize(): void {\n    if (!activeResize.value) return\n    activeResize.value = null\n    window.removeEventListener('pointermove', handlePointerMove)\n    window.removeEventListener('pointerup', stopResize)\n    window.removeEventListener('pointercancel', stopResize)\n    if (typeof document !== 'undefined') {\n      document.body.style.cursor = previousBodyCursor\n      document.body.style.userSelect = previousBodyUserSelect\n    }\n  }\n\n  function handlePointerMove(event: PointerEvent): void {\n    const state = activeResize.value\n    if (!state) return\n    options.resolveTarget(state.kind)?.onResize({\n      kind: state.kind,\n      startValue: state.startValue,\n      deltaX: event.clientX - state.startClientX,\n      deltaY: event.clientY - state.startClientY,\n      containerRect: state.containerRect,\n      secondaryRect: state.secondaryRect,\n    })\n  }\n\n  function startResize(kind: TKind, event: PointerEvent): void {\n    if (!toValue(options.enabled) || event.button !== 0) return\n    const target = options.resolveTarget(kind)\n    const containerRect = target?.getContainerElement()?.getBoundingClientRect()\n    if (!target || !containerRect) return\n\n    event.preventDefault()\n    if (event.currentTarget instanceof HTMLElement) {\n      event.currentTarget.setPointerCapture(event.pointerId)\n    }\n    const secondary = target.getSecondaryElement?.() ?? null\n    activeResize.value = {\n      kind,\n      startClientX: event.clientX,\n      startClientY: event.clientY,\n      startValue: target.getStartValue(),\n      containerRect,\n      secondaryRect: secondary?.getBoundingClientRect() ?? null,\n      cursor: target.cursor ?? 'col-resize',\n    }\n\n    if (typeof document !== 'undefined') {\n      previousBodyCursor = document.body.style.cursor\n      previousBodyUserSelect = document.body.style.userSelect\n      document.body.style.cursor = activeResize.value.cursor\n      document.body.style.userSelect = 'none'\n    }\n    window.addEventListener('pointermove', handlePointerMove)\n    window.addEventListener('pointerup', stopResize)\n    window.addEventListener('pointercancel', stopResize)\n  }\n\n  function isResizingKind(kind: TKind): boolean {\n    return activeResize.value?.kind === kind\n  }\n\n  watch(() => toValue(options.enabled), enabled => { if (!enabled) stopResize() })\n  onBeforeUnmount(stopResize)\n\n  return { activeResize, isResizing, isResizingKind, startResize, stopResize }\n}\n","// Application shell components (`@morscherlab/mint-sdk/shell`).\n\n// Layout components\nexport { default as AppTopBar } from './components/AppTopBar.vue'\nexport { default as AppSidebar } from './components/AppSidebar.vue'\nexport { default as AppLayout } from './components/AppLayout.vue'\nexport { default as LayoutResizeHandle } from './components/LayoutResizeHandle.vue'\n\n// Headless interaction composables\nexport {\n  useEventListener,\n  type EventListenerEnabled,\n  type EventFor,\n  type EventListenerStop,\n  type EventMapFor,\n  type EventTargetGetter,\n  type EventTargetLike,\n  type UseEventListenerObjectOptions,\n  type UseEventListenerOptions,\n} from './composables/useEventListener'\nexport {\n  useDebouncedWatch,\n  type DebouncedWatchCallback,\n  type DebouncedWatchCleanup,\n  type DebouncedWatchSource,\n  type UseDebouncedWatchOptions,\n  type UseDebouncedWatchReturn,\n} from './composables/useDebouncedWatch'\nexport {\n  useFocusTrap,\n  type UseFocusTrapOptions,\n  type UseFocusTrapReturn,\n} from './composables/useFocusTrap'\nexport {\n  useRovingFocus,\n  type UseRovingFocusOptions,\n  type UseRovingFocusReturn,\n} from './composables/useRovingFocus'\nexport {\n  reorderList,\n  useListReorder,\n  useReorderAnnouncer,\n  REORDER_ANNOUNCER_STYLE,\n  type ListReorderMove,\n  type UseListReorderOptions,\n  type UseListReorderReturn,\n  type UseReorderAnnouncerReturn,\n} from './composables/useListReorder'\nexport {\n  useMenuKeyboard,\n  type UseMenuKeyboardOptions,\n  type UseMenuKeyboardReturn,\n} from './composables/useMenuKeyboard'\n\n// Layout, selection, expansion and sort primitives\nexport {\n  resizedLeadingPanelWidth,\n  resizedTrailingPanelWidth,\n  resizedVerticalSplitPercent,\n  useManualLayoutResize,\n  type ManualLayoutResizeContext,\n  type ManualLayoutResizeTarget,\n  type ResizePanelWidthConstraints,\n  type ResizePercentConstraints,\n} from './composables/useManualLayoutResize'\nexport {\n  useSelectionLimit,\n  type SelectionLimitSource,\n  type UseSelectionLimitOptions,\n  type UseSelectionLimitReturn,\n} from './composables/useSelectionLimit'\nexport {\n  useListSelection,\n  type ListSelectionSource,\n  type ListSelectionValue,\n  type UseListSelectionOptions,\n  type UseListSelectionReturn,\n  type WidenListSelectionValue,\n} from './composables/useListSelection'\nexport {\n  useExpansionSet,\n  type ExpansionSetSource,\n  type UseExpansionSetOptions,\n  type UseExpansionSetReturn,\n} from './composables/useExpansionSet'\nexport {\n  compareSortValues,\n  useSortedItems,\n  type CompareSortValuesOptions,\n  type SortComparator,\n  type SortComparatorContext,\n  type SortDescriptor,\n  type SortedItemsSource,\n  type SortOrder,\n  type UseSortedItemsOptions,\n  type UseSortedItemsReturn,\n} from './composables/useSortedItems'\nexport {\n  usePluginWorkspace,\n  type PluginWorkspaceSlotsLike,\n  type UsePluginWorkspaceOptions,\n  type UsePluginWorkspaceReturn,\n} from './composables/usePluginWorkspace'\n"],"mappings":"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"}
+{"version":3,"file":"shell-kq9p4VsX.js","names":[],"sources":["../src/components/LayoutResizeHandle.vue","../src/components/LayoutResizeHandle.vue","../src/composables/useManualLayoutResize.ts","../src/shell.ts"],"sourcesContent":["<script setup lang=\"ts\">\n/** Accessible pointer and keyboard handle for resizable workbench panes. */\ninterface Props {\n  modelValue: number\n  min: number\n  max: number\n  label: string\n  orientation: 'vertical' | 'horizontal'\n  edge?: 'left' | 'right'\n  step?: number\n  disabled?: boolean\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n  edge: undefined,\n  step: 10,\n  disabled: false,\n})\n\nconst emit = defineEmits<{\n  'update:modelValue': [value: number]\n  'resize-start': [event: PointerEvent]\n}>()\n\nfunction update(value: number): void {\n  emit('update:modelValue', Math.min(props.max, Math.max(props.min, value)))\n}\n\nfunction handleKeydown(event: KeyboardEvent): void {\n  if (props.disabled) return\n  const decrement = props.orientation === 'vertical' ? 'ArrowLeft' : 'ArrowUp'\n  const increment = props.orientation === 'vertical' ? 'ArrowRight' : 'ArrowDown'\n  if (event.key === decrement) update(props.modelValue - props.step)\n  else if (event.key === increment) update(props.modelValue + props.step)\n  else if (event.key === 'Home') update(props.min)\n  else if (event.key === 'End') update(props.max)\n  else return\n  event.preventDefault()\n}\n</script>\n\n<template>\n  <div\n    role=\"separator\"\n    :tabindex=\"disabled ? -1 : 0\"\n    :class=\"[\n      'mint-layout-resize-handle',\n      `mint-layout-resize-handle--${orientation}`,\n      edge ? `mint-layout-resize-handle--edge-${edge}` : '',\n    ]\"\n    :aria-label=\"label\"\n    :aria-orientation=\"orientation\"\n    :aria-valuemin=\"min\"\n    :aria-valuemax=\"max\"\n    :aria-valuenow=\"modelValue\"\n    :aria-disabled=\"disabled || undefined\"\n    @pointerdown=\"!disabled && emit('resize-start', $event)\"\n    @keydown=\"handleKeydown\"\n  >\n    <span class=\"mint-layout-resize-handle__bar\" aria-hidden=\"true\" />\n  </div>\n</template>\n","<script setup lang=\"ts\">\n/** Accessible pointer and keyboard handle for resizable workbench panes. */\ninterface Props {\n  modelValue: number\n  min: number\n  max: number\n  label: string\n  orientation: 'vertical' | 'horizontal'\n  edge?: 'left' | 'right'\n  step?: number\n  disabled?: boolean\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n  edge: undefined,\n  step: 10,\n  disabled: false,\n})\n\nconst emit = defineEmits<{\n  'update:modelValue': [value: number]\n  'resize-start': [event: PointerEvent]\n}>()\n\nfunction update(value: number): void {\n  emit('update:modelValue', Math.min(props.max, Math.max(props.min, value)))\n}\n\nfunction handleKeydown(event: KeyboardEvent): void {\n  if (props.disabled) return\n  const decrement = props.orientation === 'vertical' ? 'ArrowLeft' : 'ArrowUp'\n  const increment = props.orientation === 'vertical' ? 'ArrowRight' : 'ArrowDown'\n  if (event.key === decrement) update(props.modelValue - props.step)\n  else if (event.key === increment) update(props.modelValue + props.step)\n  else if (event.key === 'Home') update(props.min)\n  else if (event.key === 'End') update(props.max)\n  else return\n  event.preventDefault()\n}\n</script>\n\n<template>\n  <div\n    role=\"separator\"\n    :tabindex=\"disabled ? -1 : 0\"\n    :class=\"[\n      'mint-layout-resize-handle',\n      `mint-layout-resize-handle--${orientation}`,\n      edge ? `mint-layout-resize-handle--edge-${edge}` : '',\n    ]\"\n    :aria-label=\"label\"\n    :aria-orientation=\"orientation\"\n    :aria-valuemin=\"min\"\n    :aria-valuemax=\"max\"\n    :aria-valuenow=\"modelValue\"\n    :aria-disabled=\"disabled || undefined\"\n    @pointerdown=\"!disabled && emit('resize-start', $event)\"\n    @keydown=\"handleKeydown\"\n  >\n    <span class=\"mint-layout-resize-handle__bar\" aria-hidden=\"true\" />\n  </div>\n</template>\n","import { computed, onBeforeUnmount, shallowRef, toValue, watch, type MaybeRefOrGetter } from 'vue'\n\nexport interface ResizePanelWidthConstraints {\n  minWidth: number\n  maxWidth: number\n  mainMinWidth?: number\n  layoutGap?: number\n}\n\nexport interface ResizePercentConstraints {\n  minPercent: number\n  maxPercent: number\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value))\n}\n\nfunction availablePanelWidth(\n  containerWidth: number,\n  constraints: ResizePanelWidthConstraints,\n): number {\n  return Math.min(\n    constraints.maxWidth,\n    containerWidth - (constraints.mainMinWidth ?? 0) - (constraints.layoutGap ?? 0),\n  )\n}\n\nexport function resizedLeadingPanelWidth(\n  startWidth: number,\n  deltaX: number,\n  containerWidth: number,\n  constraints: ResizePanelWidthConstraints,\n): number {\n  return Math.round(clamp(\n    startWidth + deltaX,\n    constraints.minWidth,\n    Math.max(constraints.minWidth, availablePanelWidth(containerWidth, constraints)),\n  ))\n}\n\nexport function resizedTrailingPanelWidth(\n  startWidth: number,\n  deltaX: number,\n  containerWidth: number,\n  constraints: ResizePanelWidthConstraints,\n): number {\n  return resizedLeadingPanelWidth(startWidth, -deltaX, containerWidth, constraints)\n}\n\nexport function resizedVerticalSplitPercent(\n  startPercent: number,\n  deltaY: number,\n  containerHeight: number,\n  constraints: ResizePercentConstraints,\n): number {\n  if (containerHeight <= 0) return startPercent\n  return Math.round(clamp(\n    startPercent + (deltaY / containerHeight) * 100,\n    constraints.minPercent,\n    constraints.maxPercent,\n  ))\n}\n\nexport interface ManualLayoutResizeContext<TKind extends string> {\n  kind: TKind\n  startValue: number\n  deltaX: number\n  deltaY: number\n  containerRect: DOMRectReadOnly\n  secondaryRect: DOMRectReadOnly | null\n}\n\nexport interface ManualLayoutResizeTarget<TKind extends string> {\n  cursor?: string\n  getContainerElement: () => HTMLElement | null\n  getSecondaryElement?: () => HTMLElement | null\n  getStartValue: () => number\n  onResize: (context: ManualLayoutResizeContext<TKind>) => void\n}\n\n/** Coordinates pointer-driven resizing for one or more layout splitters. */\nexport function useManualLayoutResize<TKind extends string>(options: {\n  enabled: MaybeRefOrGetter<boolean>\n  resolveTarget: (kind: TKind) => ManualLayoutResizeTarget<TKind> | null\n}) {\n  const activeResize = shallowRef<{\n    kind: TKind\n    startClientX: number\n    startClientY: number\n    startValue: number\n    containerRect: DOMRectReadOnly\n    secondaryRect: DOMRectReadOnly | null\n    cursor: string\n  } | null>(null)\n  const isResizing = computed(() => activeResize.value !== null)\n  let previousBodyCursor = ''\n  let previousBodyUserSelect = ''\n\n  function stopResize(): void {\n    if (!activeResize.value) return\n    activeResize.value = null\n    window.removeEventListener('pointermove', handlePointerMove)\n    window.removeEventListener('pointerup', stopResize)\n    window.removeEventListener('pointercancel', stopResize)\n    if (typeof document !== 'undefined') {\n      document.body.style.cursor = previousBodyCursor\n      document.body.style.userSelect = previousBodyUserSelect\n    }\n  }\n\n  function handlePointerMove(event: PointerEvent): void {\n    const state = activeResize.value\n    if (!state) return\n    options.resolveTarget(state.kind)?.onResize({\n      kind: state.kind,\n      startValue: state.startValue,\n      deltaX: event.clientX - state.startClientX,\n      deltaY: event.clientY - state.startClientY,\n      containerRect: state.containerRect,\n      secondaryRect: state.secondaryRect,\n    })\n  }\n\n  function startResize(kind: TKind, event: PointerEvent): void {\n    if (!toValue(options.enabled) || event.button !== 0) return\n    const target = options.resolveTarget(kind)\n    const containerRect = target?.getContainerElement()?.getBoundingClientRect()\n    if (!target || !containerRect) return\n\n    event.preventDefault()\n    if (event.currentTarget instanceof HTMLElement) {\n      event.currentTarget.setPointerCapture(event.pointerId)\n    }\n    const secondary = target.getSecondaryElement?.() ?? null\n    activeResize.value = {\n      kind,\n      startClientX: event.clientX,\n      startClientY: event.clientY,\n      startValue: target.getStartValue(),\n      containerRect,\n      secondaryRect: secondary?.getBoundingClientRect() ?? null,\n      cursor: target.cursor ?? 'col-resize',\n    }\n\n    if (typeof document !== 'undefined') {\n      previousBodyCursor = document.body.style.cursor\n      previousBodyUserSelect = document.body.style.userSelect\n      document.body.style.cursor = activeResize.value.cursor\n      document.body.style.userSelect = 'none'\n    }\n    window.addEventListener('pointermove', handlePointerMove)\n    window.addEventListener('pointerup', stopResize)\n    window.addEventListener('pointercancel', stopResize)\n  }\n\n  function isResizingKind(kind: TKind): boolean {\n    return activeResize.value?.kind === kind\n  }\n\n  watch(() => toValue(options.enabled), enabled => { if (!enabled) stopResize() })\n  onBeforeUnmount(stopResize)\n\n  return { activeResize, isResizing, isResizingKind, startResize, stopResize }\n}\n","// Application shell components (`@morscherlab/mint-sdk/shell`).\n\n// Layout components\nexport { default as AppTopBar } from './components/AppTopBar.vue'\nexport { default as AppSidebar } from './components/AppSidebar.vue'\nexport { default as AppLayout } from './components/AppLayout.vue'\nexport { default as LayoutResizeHandle } from './components/LayoutResizeHandle.vue'\n\n// Headless interaction composables\nexport {\n  useEventListener,\n  type EventListenerEnabled,\n  type EventFor,\n  type EventListenerStop,\n  type EventMapFor,\n  type EventTargetGetter,\n  type EventTargetLike,\n  type UseEventListenerObjectOptions,\n  type UseEventListenerOptions,\n} from './composables/useEventListener'\nexport {\n  useDebouncedWatch,\n  type DebouncedWatchCallback,\n  type DebouncedWatchCleanup,\n  type DebouncedWatchSource,\n  type UseDebouncedWatchOptions,\n  type UseDebouncedWatchReturn,\n} from './composables/useDebouncedWatch'\nexport {\n  useFocusTrap,\n  type UseFocusTrapOptions,\n  type UseFocusTrapReturn,\n} from './composables/useFocusTrap'\nexport {\n  useRovingFocus,\n  type UseRovingFocusOptions,\n  type UseRovingFocusReturn,\n} from './composables/useRovingFocus'\nexport {\n  reorderList,\n  useListReorder,\n  useReorderAnnouncer,\n  REORDER_ANNOUNCER_STYLE,\n  type ListReorderMove,\n  type UseListReorderOptions,\n  type UseListReorderReturn,\n  type UseReorderAnnouncerReturn,\n} from './composables/useListReorder'\nexport {\n  useMenuKeyboard,\n  type UseMenuKeyboardOptions,\n  type UseMenuKeyboardReturn,\n} from './composables/useMenuKeyboard'\n\n// Layout, selection, expansion and sort primitives\nexport {\n  resizedLeadingPanelWidth,\n  resizedTrailingPanelWidth,\n  resizedVerticalSplitPercent,\n  useManualLayoutResize,\n  type ManualLayoutResizeContext,\n  type ManualLayoutResizeTarget,\n  type ResizePanelWidthConstraints,\n  type ResizePercentConstraints,\n} from './composables/useManualLayoutResize'\nexport {\n  useSelectionLimit,\n  type SelectionLimitSource,\n  type UseSelectionLimitOptions,\n  type UseSelectionLimitReturn,\n} from './composables/useSelectionLimit'\nexport {\n  useListSelection,\n  type ListSelectionSource,\n  type ListSelectionValue,\n  type UseListSelectionOptions,\n  type UseListSelectionReturn,\n  type WidenListSelectionValue,\n} from './composables/useListSelection'\nexport {\n  useExpansionSet,\n  type ExpansionSetSource,\n  type UseExpansionSetOptions,\n  type UseExpansionSetReturn,\n} from './composables/useExpansionSet'\nexport {\n  compareSortValues,\n  useSortedItems,\n  type CompareSortValuesOptions,\n  type SortComparator,\n  type SortComparatorContext,\n  type SortDescriptor,\n  type SortedItemsSource,\n  type SortOrder,\n  type UseSortedItemsOptions,\n  type UseSortedItemsReturn,\n} from './composables/useSortedItems'\nexport {\n  usePluginWorkspace,\n  type PluginWorkspaceSlotsLike,\n  type UsePluginWorkspaceOptions,\n  type UsePluginWorkspaceReturn,\n} from './composables/usePluginWorkspace'\n\n// Onboarding: tours, the Getting started checklist and what's-new hints\nexport {\n  ANCHOR_WAIT_MS,\n  defineOnboarding,\n  provideOnboarding,\n  useOnboarding,\n  ONBOARDING_KEY,\n  type OnboardingActiveStep,\n  type OnboardingDefinition,\n  type OnboardingNews,\n  type OnboardingState,\n  type OnboardingStep,\n  type OnboardingTask,\n  type OnboardingTour,\n  type ProvideOnboardingOptions,\n} from './composables/useOnboarding'\n"],"mappings":"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"}

package/dist/shell.d.ts

@@ -14,3 +14,4 @@ export { useListSelection, type ListSelectionSource, type ListSelectionValue, ty
 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';
+export { ANCHOR_WAIT_MS, defineOnboarding, provideOnboarding, useOnboarding, ONBOARDING_KEY, type OnboardingActiveStep, type OnboardingDefinition, type OnboardingNews, type OnboardingState, type OnboardingStep, type OnboardingTask, type OnboardingTour, type ProvideOnboardingOptions, } from './composables/useOnboarding';

package/dist/shell.js

@@ -1,8 +1,8 @@
 import { i as useEventListener, r as useFocusTrap } from "./useDropdownState-Bb2N4m40.js";
 import { E as useMenuKeyboard, H as useListSelection, R as useRovingFocus, U as useSelectionLimit } from "./records-B4yl2oIu.js";
 import { B as compareSortValues, V as useSortedItems, i as useReorderAnnouncer, n as reorderList, r as useListReorder, t as REORDER_ANNOUNCER_STYLE } from "./useListReorder-C_8RYeVP.js";
-import { _ as AppLayout_default, f as AppTopBar_default, t as AppSidebar_default, v as usePluginWorkspace } from "./AppSidebar-Bi8g9mRt.js";
+import { C as usePluginWorkspace, S as AppLayout_default, _ as provideOnboarding, f as AppTopBar_default, g as defineOnboarding, h as ONBOARDING_KEY, m as ANCHOR_WAIT_MS, t as AppSidebar_default, v as useOnboarding } from "./AppSidebar-CB0-RQ4m.js";
 import { t as useDebouncedWatch } from "./useDebouncedWatch-BPwyl6eS.js";
 import { t as useExpansionSet } from "./useExpansionSet-CvoNMZJi.js";
-import { a as useManualLayoutResize, i as resizedVerticalSplitPercent, n as resizedLeadingPanelWidth, o as LayoutResizeHandle_default, r as resizedTrailingPanelWidth } from "./shell-Czyrzk7l.js";
-export { AppLayout_default as AppLayout, AppSidebar_default as AppSidebar, AppTopBar_default as AppTopBar, LayoutResizeHandle_default as LayoutResizeHandle, REORDER_ANNOUNCER_STYLE, compareSortValues, reorderList, resizedLeadingPanelWidth, resizedTrailingPanelWidth, resizedVerticalSplitPercent, useDebouncedWatch, useEventListener, useExpansionSet, useFocusTrap, useListReorder, useListSelection, useManualLayoutResize, useMenuKeyboard, usePluginWorkspace, useReorderAnnouncer, useRovingFocus, useSelectionLimit, useSortedItems };
+import { a as useManualLayoutResize, i as resizedVerticalSplitPercent, n as resizedLeadingPanelWidth, o as LayoutResizeHandle_default, r as resizedTrailingPanelWidth } from "./shell-kq9p4VsX.js";
+export { ANCHOR_WAIT_MS, AppLayout_default as AppLayout, AppSidebar_default as AppSidebar, AppTopBar_default as AppTopBar, LayoutResizeHandle_default as LayoutResizeHandle, ONBOARDING_KEY, REORDER_ANNOUNCER_STYLE, compareSortValues, defineOnboarding, provideOnboarding, reorderList, resizedLeadingPanelWidth, resizedTrailingPanelWidth, resizedVerticalSplitPercent, useDebouncedWatch, useEventListener, useExpansionSet, useFocusTrap, useListReorder, useListSelection, useManualLayoutResize, useMenuKeyboard, useOnboarding, usePluginWorkspace, useReorderAnnouncer, useRovingFocus, useSelectionLimit, useSortedItems };

package/dist/styles.css

@@ -5823,6 +5823,375 @@ button, input, select, textarea {
   }
 }
 
+/* Onboarding: the top-bar Help button and checklist chip, the Help panel,
+ * the tour layer (scrim, hole, card) and the what's-new dots. */
+
+:root {
+  --mint-onboarding-scrim: rgba(15, 23, 42, 0.45);
+}
+
+html.dark {
+  --mint-onboarding-scrim: rgba(2, 6, 23, 0.62);
+}
+
+/* ---- Top bar ---- */
+
+.mint-onboarding-help {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+}
+
+.mint-topbar__settings-btn--open {
+  background: var(--color-primary-soft);
+  color: var(--_ink-primary);
+}
+
+.mint-onboarding-help__chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  height: 2rem;
+  padding: 0 0.625rem;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: transparent;
+  color: var(--text-primary);
+  font: 500 0.8125rem/1 var(--font-sans);
+  white-space: nowrap;
+  cursor: pointer;
+  transition: background-color var(--mint-transition), border-color var(--mint-transition);
+}
+
+.mint-onboarding-help__chip:hover {
+  background: var(--bg-hover);
+}
+
+.mint-onboarding-help__chip--open {
+  border-color: var(--color-primary);
+  background: var(--color-primary-soft);
+  color: var(--_ink-primary);
+}
+
+.mint-onboarding-help__chip:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
+}
+
+.mint-onboarding-help__count {
+  color: var(--text-muted);
+  font: 500 0.75rem/1 var(--font-mono);
+}
+
+.mint-onboarding-help__bar {
+  width: 1.75rem;
+  height: 3px;
+  border-radius: 2px;
+  background: var(--bg-tertiary);
+  overflow: hidden;
+}
+
+.mint-onboarding-help__bar > span {
+  display: block;
+  height: 100%;
+  background: var(--color-primary);
+  transition: width var(--mint-transition);
+}
+
+.mint-onboarding-help__badge {
+  position: absolute;
+  top: -4px;
+  right: -4px;
+  min-width: 16px;
+  height: 16px;
+  padding: 0 4px;
+  box-sizing: border-box;
+  border-radius: 8px;
+  background: var(--color-primary);
+  color: var(--text-on-accent);
+  font: 600 11px/16px var(--font-sans);
+  text-align: center;
+  box-shadow: 0 0 0 2px var(--bg-card);
+}
+
+/* ---- Help panel ---- */
+
+.mint-onboarding-help__panel {
+  position: fixed;
+  z-index: 1000;
+  width: 18rem;
+  padding: 0 0 4px;
+  overflow: hidden;
+}
+
+.mint-onboarding-help__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem 0.75rem 0.5rem;
+}
+
+.mint-onboarding-help__heading {
+  color: var(--text-secondary);
+  font-size: 0.6875rem;
+  font-weight: 600;
+}
+
+.mint-onboarding-help__progress {
+  height: 3px;
+  margin: 0 0.75rem 0.25rem;
+  border-radius: 2px;
+  background: var(--bg-tertiary);
+  overflow: hidden;
+}
+
+.mint-onboarding-help__progress > span {
+  display: block;
+  height: 100%;
+  background: var(--color-primary);
+  transition: width var(--mint-transition);
+}
+
+.mint-onboarding-help__todos {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.mint-onboarding-help__todo {
+  display: grid;
+  grid-template-columns: 1rem 1fr auto;
+  align-items: center;
+  gap: 0.5rem;
+  min-height: 1.875rem;
+  padding: 0 0.75rem;
+  color: var(--text-primary);
+  font-size: 0.8125rem;
+}
+
+.mint-onboarding-help__check {
+  display: grid;
+  place-items: center;
+  width: 1rem;
+  height: 1rem;
+  box-sizing: border-box;
+  border: 1.5px solid var(--border-color);
+  border-radius: 50%;
+}
+
+.mint-onboarding-help__todo--done .mint-onboarding-help__check {
+  border: 0;
+  background: var(--color-primary);
+  color: var(--text-on-accent);
+}
+
+.mint-onboarding-help__todo--done .mint-onboarding-help__todo-title {
+  color: var(--text-muted);
+}
+
+.mint-onboarding-help__link {
+  padding: 0;
+  border: 0;
+  background: transparent;
+  color: var(--_ink-primary);
+  font-size: 0.75rem;
+  font-weight: 500;
+  white-space: nowrap;
+  cursor: pointer;
+}
+
+.mint-onboarding-help__link:hover {
+  text-decoration: underline;
+}
+
+.mint-onboarding-help__link:focus-visible {
+  outline: none;
+  border-radius: var(--radius-sm);
+  box-shadow: var(--focus-ring-offset);
+}
+
+.mint-onboarding-help__hide {
+  display: block;
+  text-align: left;
+  margin: 0.25rem 0.75rem 0.5rem;
+  color: var(--text-secondary);
+}
+
+.mint-onboarding-help__section {
+  padding: 0.625rem 0.75rem 0.25rem;
+  border-top: 1px solid var(--border-color);
+  color: var(--text-secondary);
+  font-size: 0.6875rem;
+  font-weight: 600;
+}
+
+.mint-onboarding-help__icon {
+  width: 0.8125rem;
+  height: 0.8125rem;
+  flex-shrink: 0;
+  color: var(--text-muted);
+}
+
+.mint-onboarding-help__panel > .mint-menu-item {
+  width: calc(100% - 8px);
+  margin: 0 4px;
+}
+
+.mint-onboarding-help__new {
+  margin-left: auto;
+  padding: 3px 4px;
+  border-radius: var(--radius-sm);
+  background: var(--color-primary);
+  color: var(--text-on-accent);
+  font-size: 0.6875rem;
+  font-weight: 600;
+  line-height: 1;
+}
+
+/* ---- Tour layer ---- */
+
+.mint-onboarding {
+  position: fixed;
+  inset: 0;
+  z-index: 1100;
+  pointer-events: none;
+}
+
+/* Takes every click outside the card. An advanceOn 'click' step cuts the hole out of it. */
+.mint-onboarding__blocker {
+  position: absolute;
+  inset: 0;
+  pointer-events: auto;
+}
+
+.mint-onboarding__hole {
+  position: fixed;
+  border-radius: var(--radius-lg);
+  box-shadow: 0 0 0 2px var(--color-primary), 0 0 0 9999px var(--mint-onboarding-scrim);
+  pointer-events: none;
+  transition: left 200ms ease, top 200ms ease, width 200ms ease, height 200ms ease;
+}
+
+.mint-onboarding__card {
+  position: fixed;
+  display: grid;
+  gap: 0.5rem;
+  box-sizing: border-box;
+  width: 17rem;
+  max-width: calc(100vw - 24px);
+  padding: 0.875rem;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-lg);
+  background: var(--bg-card);
+  box-shadow: var(--shadow-lg);
+  color: var(--text-primary);
+  pointer-events: auto;
+}
+
+.mint-onboarding__card:focus {
+  outline: none;
+}
+
+.mint-onboarding__close {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.5rem;
+  display: grid;
+  place-items: center;
+  width: 1.5rem;
+  height: 1.5rem;
+  padding: 0;
+  border: 0;
+  border-radius: var(--radius);
+  background: transparent;
+  color: var(--text-muted);
+  cursor: pointer;
+}
+
+.mint-onboarding__close:hover {
+  background: var(--bg-hover);
+  color: var(--text-primary);
+}
+
+.mint-onboarding__close:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
+}
+
+.mint-onboarding__title {
+  margin: 0;
+  padding-right: 1.5rem;
+  font-size: 0.875rem;
+  font-weight: 600;
+}
+
+.mint-onboarding__body {
+  margin: 0;
+  color: var(--text-secondary);
+  font-size: 0.8125rem;
+  line-height: 1.45;
+}
+
+.mint-onboarding__footer {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 0.375rem;
+  margin-top: 0.25rem;
+}
+
+.mint-onboarding__count {
+  color: var(--text-muted);
+  font: 500 0.75rem/1.5rem var(--font-mono);
+  margin-top: -0.375rem;
+}
+
+/* Read by screen readers only. */
+.mint-onboarding__sr {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
+
+.mint-onboarding__hint {
+  margin-right: auto;
+  color: var(--text-muted);
+  font-size: 0.75rem;
+}
+
+/* A dot at the top-right corner of an element with unseen news. */
+.mint-onboarding__dot {
+  position: fixed;
+  z-index: 40;
+  width: 8px;
+  height: 8px;
+  padding: 0;
+  border: 0;
+  border-radius: 50%;
+  background: var(--color-primary);
+  box-shadow: 0 0 0 2px var(--bg-card);
+  transform: translate(-50%, -50%);
+  cursor: pointer;
+}
+
+.mint-onboarding__dot:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .mint-onboarding-help__chip,
+  .mint-onboarding-help__bar > span,
+  .mint-onboarding-help__progress > span,
+  .mint-onboarding__hole {
+    transition: none;
+  }
+}
+
 /* PlateEditor (SDK control refresh 7a).
  * Wells are WellPlate's (2b, 3a); this file owns the shell: tabs, toolbar, rail. */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morscherlab/mint-sdk",
-  "version": "1.4.0-beta.14",
+  "version": "1.4.0-beta.16",
   "description": "MINT Platform SDK — Vue 3 components, composables, and types for plugin development. MINT = Mass-spec INtegrated Toolkit.",
   "type": "module",
   "main": "./dist/index.js",