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

package/src/templates/adapters.ts

@@ -2,6 +2,11 @@ import type {
   DataFrameColumn,
   PlateCondition,
   PlateMapEditorState,
+  ProtocolStep,
+  ProtocolStepStatus,
+  ProtocolStepType,
+  ScheduleEvent,
+  ScheduleEventStatus,
   SelectOption,
   Well,
 } from '../types'
@@ -24,6 +29,7 @@ import type {
   AssayMatrixColumnsAdapterResult,
   AssayMatrixDataFrameAdapterResult,
   AssayMatrixRowsAdapterResult,
+  AssayMatrixSampleOptionsAdapterResult,
   AssayMatrixTemplate,
   AssayMatrixTemplateData,
   BioTemplateEnvelope,
@@ -44,8 +50,13 @@ import type {
   InstrumentRunColumnsAdapterResult,
   InstrumentRunDataFrameAdapterResult,
   InstrumentRunRowsAdapterResult,
+  InstrumentRunScheduleEventsAdapterResult,
+  InstrumentRunStepsAdapterResult,
   InstrumentRunTemplate,
   InstrumentRunTemplateData,
+  InstrumentRunItem,
+  InstrumentRunItemKind,
+  InstrumentRunStatus,
   PlateMapEditorAdapterResult,
   PlateMapTemplate,
   PlateMapTemplateData,
@@ -478,6 +489,19 @@ export function toAssayMatrixDataFrame(
   }
 }
 
+/** Convert an assay-matrix template into SampleSelector options derived from assay samples. */
+export function toAssayMatrixSampleOptions(
+  template: AssayMatrixTemplate | AssayMatrixTemplateData
+): AssayMatrixSampleOptionsAdapterResult {
+  const data = getTemplateData(template, 'assay-matrix')
+  validateAssayMatrixData(data)
+  return data.samples.map((sample): SelectOption<string> => ({
+    value: sample.sampleId,
+    label: sample.name ?? sample.sampleId,
+    description: sample.group,
+  }))
+}
+
 export function toReagentListItems(
   template: ReagentListTemplate | ReagentListTemplateData
 ): ReagentListItemsAdapterResult {
@@ -649,6 +673,91 @@ export function toInstrumentRunDataFrame(
   }
 }
 
+/** Convert an instrument-run template into ExperimentTimeline protocol steps for acquisition queue previews. */
+export function toInstrumentRunSteps(
+  template: InstrumentRunTemplate | InstrumentRunTemplateData
+): InstrumentRunStepsAdapterResult {
+  const data = getTemplateData(template, 'instrument-run')
+  validateInstrumentRunData(data)
+  const methods = new Map(data.methods.map(method => [method.id, method]))
+  return [...data.items]
+    .sort((a, b) => a.order - b.order)
+    .map((item): ProtocolStep => {
+      const method = methods.get(item.methodId)
+      const name = item.name ?? item.sampleId ?? item.kind
+      return {
+        id: item.id,
+        type: instrumentRunStepType(item.kind),
+        name,
+        description: [
+          item.kind,
+          method?.name,
+          item.vial ? `Vial ${item.vial}` : undefined,
+          item.wellId ? `Well ${item.wellId}` : undefined,
+        ]
+          .filter(Boolean)
+          .join(' / '),
+        duration: item.expectedDurationMin,
+        status: instrumentRunStepStatus(item.status),
+        parameters: {
+          kind: item.kind,
+          sampleId: item.sampleId,
+          methodId: item.methodId,
+          method: method?.name,
+          vial: item.vial,
+          plateId: item.plateId,
+          wellId: item.wellId,
+          injectionVolume: item.injectionVolume,
+          instrument: data.instrument ?? method?.instrument,
+        },
+        order: item.order,
+      }
+    })
+}
+
+/** Convert an instrument-run template into readonly ScheduleCalendar events ordered by run queue timing. */
+export function toInstrumentRunScheduleEvents(
+  template: InstrumentRunTemplate | InstrumentRunTemplateData
+): InstrumentRunScheduleEventsAdapterResult {
+  const data = getTemplateData(template, 'instrument-run')
+  validateInstrumentRunData(data)
+  const methods = new Map(data.methods.map(method => [method.id, method]))
+  let cursor = dateFromMetadata(data.metadata, ['scheduledStart', 'runStart', 'start', 'startedAt'])
+    ?? new Date('2024-01-01T08:00:00.000Z')
+
+  return [...data.items]
+    .sort((a, b) => a.order - b.order)
+    .map((item): ScheduleEvent => {
+      const method = methods.get(item.methodId)
+      const start = dateFromMetadata(item.metadata, ['scheduledStart', 'start', 'startedAt']) ?? cursor
+      const end = dateFromMetadata(item.metadata, ['scheduledEnd', 'end', 'completedAt'])
+        ?? addMinutes(start, Math.max(item.expectedDurationMin ?? 10, 1))
+      cursor = end
+
+      return {
+        id: item.id,
+        title: item.name ?? item.sampleId ?? item.kind,
+        start: start.toISOString(),
+        end: end.toISOString(),
+        color: instrumentRunScheduleColor(item.kind),
+        status: instrumentRunScheduleStatus(item.status),
+        draggable: false,
+        resizable: false,
+        metadata: {
+          kind: item.kind,
+          sampleId: item.sampleId,
+          methodId: item.methodId,
+          method: method?.name,
+          vial: item.vial,
+          plateId: item.plateId,
+          wellId: item.wellId,
+          injectionVolume: item.injectionVolume,
+          instrument: data.instrument ?? method?.instrument,
+        },
+      }
+    })
+}
+
 export function toQpcrRows(
   template: QpcrPlateTemplate | QpcrPlateTemplateData
 ): QpcrRowsAdapterResult {
@@ -783,3 +892,87 @@ function sampleColumnKey(columnId: string): string {
   }
   return aliases[columnId] ?? columnId
 }
+
+function instrumentRunStepType(kind: InstrumentRunItemKind): ProtocolStepType {
+  switch (kind) {
+    case 'wash':
+      return 'wash'
+    case 'blank':
+    case 'qc':
+    case 'standard':
+    case 'calibration':
+    case 'sample':
+      return 'measurement'
+    default:
+      return 'custom'
+  }
+}
+
+function instrumentRunStepStatus(status: InstrumentRunStatus): ProtocolStepStatus {
+  switch (status) {
+    case 'running':
+      return 'in_progress'
+    case 'completed':
+      return 'completed'
+    case 'failed':
+      return 'failed'
+    case 'skipped':
+      return 'skipped'
+    case 'planned':
+    case 'queued':
+    default:
+      return 'pending'
+  }
+}
+
+function instrumentRunScheduleStatus(status: InstrumentRunStatus): ScheduleEventStatus {
+  switch (status) {
+    case 'running':
+      return 'in-progress'
+    case 'completed':
+      return 'confirmed'
+    case 'failed':
+    case 'skipped':
+      return 'cancelled'
+    case 'planned':
+    case 'queued':
+    default:
+      return 'pending'
+  }
+}
+
+function instrumentRunScheduleColor(kind: InstrumentRunItem['kind']): string {
+  switch (kind) {
+    case 'blank':
+      return '#64748b'
+    case 'qc':
+      return '#8b5cf6'
+    case 'standard':
+    case 'calibration':
+      return '#f59e0b'
+    case 'wash':
+      return '#06b6d4'
+    case 'sample':
+      return '#2563eb'
+    default:
+      return '#475569'
+  }
+}
+
+function dateFromMetadata(
+  metadata: Record<string, unknown> | undefined,
+  keys: readonly string[]
+): Date | undefined {
+  if (!metadata) return undefined
+  for (const key of keys) {
+    const value = metadata[key]
+    if (!(typeof value === 'string' || value instanceof Date)) continue
+    const date = new Date(value)
+    if (!Number.isNaN(date.getTime())) return date
+  }
+  return undefined
+}
+
+function addMinutes(date: Date, minutes: number): Date {
+  return new Date(date.getTime() + minutes * 60_000)
+}

package/src/templates/catalog.ts

@@ -142,8 +142,8 @@ export const bioTemplateCatalog = [
     aliases: ['omics matrix', 'measurement matrix', 'readout matrix', 'feature table'],
     python_import: 'from mint_sdk.templates import AssayMatrixTemplate, save_template',
     python_example: 'AssayMatrixTemplate.create(samples=["S001", "S002"], features=["Lactate", "Glucose"])',
-    frontend_import: "import { toTemplateDataFrame } from '@morscherlab/mint-sdk/templates'",
-    frontend_adapters: ['toTemplateDataFrame', 'toAssayMatrixDataFrame', 'toAssayMatrixRows', 'toAssayMatrixColumns'],
+    frontend_import: "import { toAssayMatrixSampleOptions, toTemplateDataFrame } from '@morscherlab/mint-sdk/templates'",
+    frontend_adapters: ['toTemplateDataFrame', 'toAssayMatrixDataFrame', 'toAssayMatrixRows', 'toAssayMatrixColumns', 'toAssayMatrixSampleOptions'],
     components: ['DataFrame', 'ChartContainer', 'SampleSelector'],
     add_command: 'mint add data-template assay-matrix --page',
   },
@@ -187,9 +187,9 @@ export const bioTemplateCatalog = [
     aliases: ['run queue', 'sequence table', 'sample queue', 'lcms run', 'instrument sequence', 'batch run'],
     python_import: 'from mint_sdk.templates import InstrumentRunTemplate, save_template',
     python_example: 'InstrumentRunTemplate.create(["S001", "S002"], instrument="LC-MS")',
-    frontend_import: "import { toInstrumentRunDataFrame, toTemplateDataFrame } from '@morscherlab/mint-sdk/templates'",
-    frontend_adapters: ['toTemplateDataFrame', 'toInstrumentRunDataFrame', 'toInstrumentRunRows', 'toInstrumentRunColumns'],
-    components: ['DataFrame', 'ScheduleCalendar', 'SampleSelector'],
+    frontend_import: "import { toInstrumentRunDataFrame, toInstrumentRunScheduleEvents, toInstrumentRunSteps, toTemplateDataFrame } from '@morscherlab/mint-sdk/templates'",
+    frontend_adapters: ['toTemplateDataFrame', 'toInstrumentRunDataFrame', 'toInstrumentRunRows', 'toInstrumentRunColumns', 'toInstrumentRunSteps', 'toInstrumentRunScheduleEvents'],
+    components: ['DataFrame', 'ExperimentTimeline', 'ScheduleCalendar', 'SampleSelector'],
     add_command: 'mint add data-template instrument-run --page',
   },
   {

package/src/templates/componentBindings.ts

@@ -4,8 +4,11 @@ import {
   getTemplateData,
 } from './builders'
 import {
+  toAssayMatrixSampleOptions,
   toDoseConditions,
   toDoseLayoutState,
+  toInstrumentRunScheduleEvents,
+  toInstrumentRunSteps,
   toPlateMapEditorState,
   toProtocolSteps,
   toQpcrWellPlateWells,
@@ -26,8 +29,10 @@ import {
 } from './packs'
 import type {
   BioTemplateEnvelope,
+  AssayMatrixTemplate,
   DataFrameTemplate,
   DoseResponseTemplate,
+  InstrumentRunTemplate,
   PlateMapTemplate,
   QpcrPlateTemplate,
   ReagentListTemplate,
@@ -62,6 +67,16 @@ export interface BioTemplateComponentPropsBinding extends BioTemplateComponentBi
   propsObject: Record<string, unknown>
 }
 
+export interface BioTemplateResolvedComponentBinding extends Omit<BioTemplateComponentBinding, 'props'> {
+  /** Prop names advertised by the static template/component compatibility catalog. */
+  propNames: readonly string[]
+  /** Concrete props ready for direct `v-bind="componentBindingsById[id].props"` use. */
+  props: Record<string, unknown>
+  /** Backward-compatible alias for callers that already consume componentProps entries. */
+  propsObject: Record<string, unknown>
+}
+
+export type BioTemplateComponentBindingsById = Record<string, BioTemplateResolvedComponentBinding>
 export type BioTemplateComponentPropsById = Record<string, Record<string, unknown>>
 export type BioTemplateComponentPropsByComponent = Record<string, Record<string, unknown>[]>
 
@@ -130,6 +145,7 @@ const templateComponentBindings = {
   ],
   'assay-matrix': [
     binding('assay-matrix', 'DataFrame', ['toTemplateDataFrame'], ['data', 'columns', 'rowKey'], 'Render sample-by-feature measurements.'),
+    binding('assay-matrix', 'SampleSelector', ['toAssayMatrixSampleOptions'], ['samples', 'modelValue'], 'Select samples from assay-matrix records.'),
   ],
   'reagent-list': [
     binding('reagent-list', 'ReagentList', ['toReagentListItems'], ['modelValue'], 'Render reagents with lot, storage, and stock metadata.'),
@@ -140,6 +156,20 @@ const templateComponentBindings = {
   ],
   'instrument-run': [
     binding('instrument-run', 'DataFrame', ['toTemplateDataFrame'], ['data', 'columns', 'rowKey'], 'Render acquisition queues, methods, QC, and run status.'),
+    binding(
+      'instrument-run',
+      'ScheduleCalendar',
+      ['toInstrumentRunScheduleEvents'],
+      ['modelValue', 'events', 'view', 'readonly', 'showNavigation', 'showViewToggle'],
+      'Render acquisition queues as a scheduled run calendar.',
+    ),
+    binding(
+      'instrument-run',
+      'ExperimentTimeline',
+      ['toInstrumentRunSteps'],
+      ['modelValue', 'orientation', 'showDuration', 'editable'],
+      'Render acquisition queues as an ordered run timeline.',
+    ),
   ],
   'qpcr-plate': [
     binding('qpcr-plate', 'WellPlate', ['toQpcrWellPlateWells'], ['format', 'wells', 'sampleColors', 'legendItems'], 'Render qPCR reactions on a well plate.'),
@@ -169,6 +199,22 @@ export function toBioTemplateComponentProps(
   return Object.values(collection).flatMap(template => propsForTemplate(template))
 }
 
+/** Return resolved component bindings with concrete props for direct slot rendering. */
+export function toBioTemplateComponentBindings(
+  target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope,
+): BioTemplateResolvedComponentBinding[] {
+  return toBioTemplateComponentProps(target).map(toResolvedComponentBinding)
+}
+
+/** Return resolved component bindings keyed by stable template component id. */
+export function toBioTemplateComponentBindingsById(
+  target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope,
+): BioTemplateComponentBindingsById {
+  return Object.fromEntries(
+    toBioTemplateComponentBindings(target).map(binding => [binding.id, binding]),
+  )
+}
+
 /** Return component props keyed by stable binding id for direct `v-bind="componentPropsById[id]"` use. */
 export function toBioTemplateComponentPropsById(
   target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope,
@@ -205,6 +251,18 @@ export function getBioTemplateComponentProps(
   })?.propsObject
 }
 
+function toResolvedComponentBinding(
+  binding: BioTemplateComponentPropsBinding,
+): BioTemplateResolvedComponentBinding {
+  const { props: propNames, propsObject, ...rest } = binding
+  return {
+    ...rest,
+    propNames,
+    props: propsObject,
+    propsObject,
+  }
+}
+
 export function toBioTemplateComponentImports(
   target: BioTemplateComponentTarget
 ): BioTemplateComponentImport[] {
@@ -291,10 +349,19 @@ function propsForTemplate(template: BioTemplateEnvelope<unknown>): BioTemplateCo
       ]
     case 'sample-prep':
     case 'calibration-curve':
-    case 'assay-matrix':
     case 'flow-cytometry-panel':
-    case 'instrument-run':
       return [dataFrameProps(template as DataFrameTemplate)]
+    case 'assay-matrix':
+      return [
+        dataFrameProps(template as DataFrameTemplate),
+        assayMatrixSampleSelectorProps(template as AssayMatrixTemplate),
+      ]
+    case 'instrument-run':
+      return [
+        dataFrameProps(template as DataFrameTemplate),
+        scheduleCalendarProps(template as InstrumentRunTemplate),
+        timelineProps(template as InstrumentRunTemplate, toInstrumentRunSteps(template as InstrumentRunTemplate)),
+      ]
     case 'dose-response':
       return doseResponseProps(template as DoseResponseTemplate)
     case 'time-course':
@@ -408,8 +475,16 @@ function sampleSelectorProps(template: SampleSheetTemplate): BioTemplateComponen
   })
 }
 
+function assayMatrixSampleSelectorProps(template: AssayMatrixTemplate): BioTemplateComponentPropsBinding {
+  const options = toAssayMatrixSampleOptions(template)
+  return propsBinding('assay-matrix', 'SampleSelector', {
+    samples: options.map(option => option.label),
+    modelValue: [],
+  })
+}
+
 function timelineProps(
-  template: TimeCourseTemplate | ProtocolStepsTemplate,
+  template: TimeCourseTemplate | ProtocolStepsTemplate | InstrumentRunTemplate,
   steps: unknown[],
   editable = false
 ): BioTemplateComponentPropsBinding {
@@ -420,6 +495,18 @@ function timelineProps(
   })
 }
 
+function scheduleCalendarProps(template: InstrumentRunTemplate): BioTemplateComponentPropsBinding {
+  const events = toInstrumentRunScheduleEvents(template)
+  return propsBinding('instrument-run', 'ScheduleCalendar', {
+    modelValue: events[0]?.start,
+    events,
+    view: 'day',
+    readonly: true,
+    showNavigation: false,
+    showViewToggle: false,
+  })
+}
+
 function reagentListProps(template: ReagentListTemplate): BioTemplateComponentPropsBinding {
   return propsBinding('reagent-list', 'ReagentList', {
     modelValue: toReagentListItems(template),

package/src/templates/index.ts

@@ -71,6 +71,8 @@ export {
   getBioTemplateComponentProps,
   getBioTemplateComponentBindings,
   listBioTemplateComponentBindings,
+  toBioTemplateComponentBindings,
+  toBioTemplateComponentBindingsById,
   toBioTemplateComponentImports,
   toBioTemplateComponentProps,
   toBioTemplateComponentPropsByComponent,
@@ -80,6 +82,7 @@ export {
 } from './componentBindings'
 
 export type {
+  BioTemplateComponentBindingsById,
   BioTemplateComponentPropsByComponent,
   BioTemplateComponentPropsById,
   BioTemplateComponentPropsLookupOptions,
@@ -103,6 +106,7 @@ export {
   toAssayMatrixColumns,
   toAssayMatrixDataFrame,
   toAssayMatrixRows,
+  toAssayMatrixSampleOptions,
   toCalibrationCurveColumns,
   toCalibrationCurveDataFrame,
   toCalibrationCurveRows,
@@ -114,6 +118,8 @@ export {
   toInstrumentRunColumns,
   toInstrumentRunDataFrame,
   toInstrumentRunRows,
+  toInstrumentRunScheduleEvents,
+  toInstrumentRunSteps,
   toPlateMapEditorState,
   toProtocolColumns,
   toProtocolDataFrame,
@@ -149,6 +155,7 @@ export type {
   AssayMatrixColumnsAdapterResult,
   AssayMatrixDataFrameAdapterResult,
   AssayMatrixRowsAdapterResult,
+  AssayMatrixSampleOptionsAdapterResult,
   AssayMatrixTemplate,
   AssayMatrixTemplateData,
   AssayMeasurement,
@@ -208,6 +215,8 @@ export type {
   InstrumentRunItemInput,
   InstrumentRunItemKind,
   InstrumentRunRowsAdapterResult,
+  InstrumentRunScheduleEventsAdapterResult,
+  InstrumentRunStepsAdapterResult,
   InstrumentRunStatus,
   InstrumentRunTemplate,
   InstrumentRunTemplateData,
@@ -293,6 +302,7 @@ export type {
   BioTemplateComponentBinding,
   BioTemplateComponentImport,
   BioTemplateComponentPropsBinding,
+  BioTemplateResolvedComponentBinding,
   BioTemplateComponentSnippet,
   BioTemplateComponentSnippetOptions,
   BioTemplateComponentTarget,

package/src/templates/packs.ts

@@ -89,7 +89,16 @@ const bioTemplatePackDefinitions = [
       'calibration-curve',
       'assay-matrix',
     ],
-    aliases: ['omics', 'metabolomics', 'proteomics', 'assay matrix', 'lcms', 'standard curve'],
+    aliases: [
+      'omics',
+      'metabolomics',
+      'metabolism',
+      'metabolite profiling',
+      'proteomics',
+      'assay matrix',
+      'lcms',
+      'standard curve',
+    ],
   },
   {
     name: 'longitudinal-study',

package/src/templates/presets.ts

@@ -57,12 +57,22 @@ export const bioTemplatePresets = [
     category: 'bio-template-preset',
     purpose: 'Sample metadata, instrument queue, and assay matrix payloads for omics acquisition batches.',
     templates: ['sample-sheet', 'instrument-run', 'assay-matrix'],
-    aliases: ['lcms', 'lc-ms', 'mass spec batch', 'omics batch', 'run queue', 'sequence table'],
+    aliases: [
+      'lcms',
+      'lc-ms',
+      'mass spec batch',
+      'omics batch',
+      'metabolomics',
+      'metabolism',
+      'metabolite profiling',
+      'run queue',
+      'sequence table',
+    ],
     python_import: 'from mint_sdk.templates import create_lcms_batch_collection, save_template_collection',
     python_example: 'create_lcms_batch_collection(samples=["S001", "S002"], features=["Glucose", "Lactate"], instrument="LC-MS")',
-    frontend_import: "import { createLcmsBatchCollection, toInstrumentRunDataFrame, toTemplateDataFrame } from '@morscherlab/mint-sdk/templates'",
-    frontend_adapters: ['toTemplateDataFrame', 'toInstrumentRunDataFrame', 'toAssayMatrixDataFrame'],
-    components: ['DataFrame', 'ScheduleCalendar', 'ChartContainer', 'SampleSelector'],
+    frontend_import: "import { createLcmsBatchCollection, toAssayMatrixSampleOptions, toInstrumentRunDataFrame, toInstrumentRunScheduleEvents, toInstrumentRunSteps, toTemplateDataFrame } from '@morscherlab/mint-sdk/templates'",
+    frontend_adapters: ['toTemplateDataFrame', 'toInstrumentRunDataFrame', 'toInstrumentRunSteps', 'toInstrumentRunScheduleEvents', 'toAssayMatrixDataFrame', 'toAssayMatrixSampleOptions'],
+    components: ['DataFrame', 'ExperimentTimeline', 'ScheduleCalendar', 'ChartContainer', 'SampleSelector'],
   },
   {
     name: 'elisa-assay',

package/src/templates/types.ts

@@ -5,6 +5,7 @@ import type {
   PlateMapEditorState,
   ProtocolStep,
   Reagent,
+  ScheduleEvent,
   SampleType,
   SelectOption,
   Well,
@@ -651,6 +652,7 @@ export type ProtocolDataFrameAdapterResult = DataFrameAdapterResult
 export type AssayMatrixRowsAdapterResult = Array<Record<string, unknown>>
 export type AssayMatrixColumnsAdapterResult = DataFrameColumn<Record<string, unknown>>[]
 export type AssayMatrixDataFrameAdapterResult = DataFrameAdapterResult
+export type AssayMatrixSampleOptionsAdapterResult = SelectOption<string>[]
 export type ReagentListItemsAdapterResult = Reagent[]
 export type ReagentRowsAdapterResult = Array<Record<string, unknown>>
 export type ReagentColumnsAdapterResult = DataFrameColumn<Record<string, unknown>>[]
@@ -661,6 +663,8 @@ export type FlowPanelDataFrameAdapterResult = DataFrameAdapterResult
 export type InstrumentRunRowsAdapterResult = Array<Record<string, unknown>>
 export type InstrumentRunColumnsAdapterResult = DataFrameColumn<Record<string, unknown>>[]
 export type InstrumentRunDataFrameAdapterResult = DataFrameAdapterResult
+export type InstrumentRunStepsAdapterResult = ProtocolStep[]
+export type InstrumentRunScheduleEventsAdapterResult = ScheduleEvent[]
 export type QpcrRowsAdapterResult = Array<Record<string, unknown>>
 export type QpcrColumnsAdapterResult = DataFrameColumn<Record<string, unknown>>[]
 export type QpcrDataFrameAdapterResult = DataFrameAdapterResult

package/src/types/components.ts

@@ -89,31 +89,7 @@ export interface CollapsibleState {
 // TopBar types
 export type TopBarVariant = 'card' | 'default'
 
-// TopBar page navigation types
-export interface TopBarPage {
-  id: string
-  label: string
-  to?: string              // vue-router path
-  href?: string            // External link
-  icon?: string            // Optional icon
-  description?: string     // Optional subtitle in dropdown
-  disabled?: boolean
-}
-
-export type TopBarPageInput = TopBarPage | string
-
-// TopBar tab types (displayed in middle of topbar)
-export interface TopBarTab {
-  id: string
-  label: string
-  to?: string              // vue-router path
-  href?: string            // External link
-  icon?: string            // Optional icon
-  disabled?: boolean
-  children?: TopBarTabOption[]  // Dropdown options
-}
-
-export interface TopBarTabOption {
+export interface PillNavOption {
   id: string
   label: string
   to?: string
@@ -122,11 +98,7 @@ export interface TopBarTabOption {
   disabled?: boolean
 }
 
-export type TopBarTabOptionInput = TopBarTabOption | string
-
-export type TopBarTabInput = (Omit<TopBarTab, 'children'> & {
-  children?: TopBarTabOptionInput[]
-}) | string
+export type PillNavOptionInput = PillNavOption | string
 
 // TopBar settings config (pass-through for built-in SettingsModal)
 export interface TopBarSettingsConfig {
@@ -159,9 +131,12 @@ export interface PillNavItem {
   to?: string
   href?: string
   disabled?: boolean
+  children?: PillNavOption[]
 }
 
-export type PillNavItemInput = PillNavItem | string
+export type PillNavItemInput = (Omit<PillNavItem, 'children'> & {
+  children?: PillNavOptionInput[]
+}) | string
 
 // TopBar page selector items (left-side "go to page" dropdown)
 export interface PageSelectorItem {

package/src/types/index.ts

@@ -19,13 +19,9 @@ export type {
   SidebarToolSection,
   CollapsibleState,
   TopBarVariant,
-  TopBarPage,
-  TopBarPageInput,
-  TopBarTab,
-  TopBarTabInput,
-  TopBarTabOption,
-  TopBarTabOptionInput,
   TopBarSettingsConfig,
+  PillNavOption,
+  PillNavOptionInput,
   PillNavItem,
   PillNavItemInput,
   PageSelectorItem,

package/dist/__tests__/composables/usePluginApi.test.d.ts

@@ -1,13 +0,0 @@
-/**
- * Tests for usePluginApi.
- *
- * Exercises the baseUrl resolution priority that every plugin relies on:
- *   1. VITE_API_PREFIX (build-time env override)
- *   2. fallbackPrefix option (plugin's route prefix)
- *   3. '/api' default
- *
- * The SDK-wide axios client is a singleton, so these tests stub axios
- * with a MockAdapter-style approach via vi.spyOn to observe the
- * baseURL actually used at request time.
- */
-export {};

package/dist/components/FormFieldRenderer.vue.d.ts

@@ -1,28 +0,0 @@
-import { FormFieldSchema } from '../types/form-builder';
-import { UseFormReturn } from '../composables/useForm';
-interface Props {
-    field: FormFieldSchema;
-    resolvedProps: Record<string, unknown>;
-    form: UseFormReturn<Record<string, unknown>>;
-}
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: Readonly<{
-        [name: string]: ((props: Record<string, unknown>) => unknown) | undefined;
-        '`field:${field.name}`'?: (props: Record<string, unknown>) => unknown;
-    }> & {
-        [name: string]: ((props: Record<string, unknown>) => unknown) | undefined;
-        '`field:${field.name}`'?: (props: Record<string, unknown>) => unknown;
-    };
-    refs: {};
-    rootEl: HTMLDivElement;
-};
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
-export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};