@morscherlab/mint-sdk 1.2.0-beta.4 → 1.2.0-beta.7

package/src/components/internal/WorkspaceControlsInternal.vue

@@ -0,0 +1,20 @@
+<script setup lang="ts">
+/**
+ * Internal: renders PluginWorkspaceView's default (main content) slot bound to the
+ * control-schema-derived scoped-slot payload (active view, values, component bindings/props).
+ * Not part of the public SDK surface — see PluginWorkspaceView.vue for the public component.
+ */
+import type { PluginWorkspaceControlsModel } from '../../composables/pluginWorkspaceModel'
+
+defineProps<{
+  controls: PluginWorkspaceControlsModel
+}>()
+
+defineSlots<{
+  default?: (props: PluginWorkspaceControlsModel) => unknown
+}>()
+</script>
+
+<template>
+  <slot v-bind="controls" />
+</template>

package/src/components/internal/WorkspaceShellInternal.vue

@@ -0,0 +1,125 @@
+<script setup lang="ts">
+/**
+ * Internal: AppLayout + AppTopBar for PluginWorkspaceView, driven by a single `shell` model.
+ * Owns the responsive/collapse layout props and the top bar's default rendering; the caller
+ * decides whether to override the `topbar`/`sidebar` slots and supplies the sidebar content.
+ * Not part of the public SDK surface — see PluginWorkspaceView.vue for the public component.
+ */
+import type {
+  AccountMenuItem,
+  PageSelectorItem,
+  PillNavItem,
+  PillNavOption,
+  PluginSwitcherPlugin,
+} from '../../types'
+import AppLayout from '../AppLayout.vue'
+import AppTopBar from '../AppTopBar.vue'
+import type { PluginWorkspaceShellModel } from '../../composables/pluginWorkspaceModel'
+
+defineProps<{
+  shell: PluginWorkspaceShellModel
+}>()
+
+const emit = defineEmits<{
+  'page-selector-select': [page: PageSelectorItem]
+  'pill-select': [item: PillNavItem]
+  'pill-option-select': [option: PillNavOption, item: PillNavItem]
+  'plugin-switcher-select': [plugin: PluginSwitcherPlugin]
+  'plugin-switcher-install': []
+  'account-menu-select': [item: AccountMenuItem]
+  'sign-out': []
+  'notifications-click': []
+  'settings-values-change': [data: Record<string, unknown>]
+  'admin-click': []
+}>()
+
+function handlePillOptionSelect(option: PillNavOption, item: PillNavItem) {
+  emit('pill-option-select', option, item)
+}
+
+defineSlots<{
+  topbar?: (props: PluginWorkspaceShellModel['controls']) => unknown
+  sidebar?: (props: PluginWorkspaceShellModel['controls']) => unknown
+  default?: (props: PluginWorkspaceShellModel['controls']) => unknown
+  icon?: (props: Record<string, unknown>) => unknown
+  logo?: (props: Record<string, unknown>) => unknown
+  'page-selector-icon'?: (props: Record<string, unknown>) => unknown
+  'page-selector-item-icon'?: (props: Record<string, unknown>) => unknown
+  nav?: (props: Record<string, unknown>) => unknown
+  center?: (props: Record<string, unknown>) => unknown
+  actions?: (props: Record<string, unknown>) => unknown
+  'account-menu-items'?: (props: Record<string, unknown>) => unknown
+  'account-menu-item-icon'?: (props: Record<string, unknown>) => unknown
+  'settings-appearance'?: (props: Record<string, unknown>) => unknown
+}>()
+</script>
+
+<template>
+  <AppLayout
+    class="mint-plugin-workspace-view"
+    :sidebar-position="shell.sidebarPosition"
+    :sidebar-width="shell.sidebarWidth"
+    :floating="shell.floating"
+    :responsive-sidebar="shell.responsiveSidebar"
+    :sidebar-toggle-label="shell.sidebarToggleLabel"
+    :sidebar-close-label="shell.sidebarCloseLabel"
+  >
+    <template #topbar>
+      <slot name="topbar" v-bind="shell.controls">
+        <AppTopBar
+          :title="shell.title"
+          :subtitle="shell.subtitle"
+          :variant="shell.topBarVariant"
+          :home-path="shell.homePath"
+          :show-logo="shell.showLogo"
+          :page-selector="shell.pageSelector"
+          :current-page-selector-id="shell.currentPageSelectorId"
+          :plugin-switcher="shell.pluginSwitcher"
+          :pill-nav="shell.pillNav"
+          :current-pill-id="shell.currentPillId"
+          :show-theme-toggle="shell.showThemeToggle"
+          :show-settings="shell.showSettings"
+          :settings-config="shell.settingsConfig"
+          :show-standalone-label="shell.showStandaloneLabel"
+          :standalone-label="shell.standaloneLabel"
+          :account-menu="shell.accountMenu"
+          :show-notifications="shell.showNotifications"
+          :has-notification-dot="shell.hasNotificationDot"
+          :show-admin="shell.showAdmin"
+          :admin-path="shell.adminPath"
+          :user-name="shell.userName"
+          :user-initial="shell.userInitial"
+          :user-email="shell.userEmail"
+          @page-selector-select="emit('page-selector-select', $event)"
+          @pill-select="emit('pill-select', $event)"
+          @pill-option-select="handlePillOptionSelect"
+          @plugin-switcher-select="emit('plugin-switcher-select', $event)"
+          @plugin-switcher-install="emit('plugin-switcher-install')"
+          @account-menu-select="emit('account-menu-select', $event)"
+          @sign-out="emit('sign-out')"
+          @notifications-click="emit('notifications-click')"
+          @settings-values-change="emit('settings-values-change', $event)"
+          @admin-click="emit('admin-click')"
+        >
+          <template
+            v-for="slotName in shell.topBarSlotNames"
+            :key="slotName"
+            #[slotName]="slotProps"
+          >
+            <!-- @vue-ignore dynamic SDK slot forwarding for AppTopBar passthrough slots -->
+            <slot
+              :name="slotName"
+              v-bind="slotProps ?? {}"
+            />
+          </template>
+        </AppTopBar>
+      </slot>
+    </template>
+
+    <template v-if="shell.hasSidebarSurface" #sidebar>
+      <slot name="sidebar" v-bind="shell.controls" />
+    </template>
+
+    <slot v-bind="shell.controls" />
+  </AppLayout>
+</template>

package/src/components/internal/WorkspaceSidebarInternal.vue

@@ -0,0 +1,82 @@
+<script setup lang="ts">
+/**
+ * Internal: AppSidebar for PluginWorkspaceView, driven by a single `sidebar` model covering
+ * chrome, panels/forms, collapse behavior, and the compact control-schema props that drive
+ * AppSidebar's auto-generated form.
+ * Not part of the public SDK surface — see PluginWorkspaceView.vue for the public component.
+ */
+import AppSidebar from '../AppSidebar.vue'
+import type { PluginWorkspaceSidebarModel } from '../../composables/pluginWorkspaceModel'
+
+defineProps<{
+  sidebar: PluginWorkspaceSidebarModel
+}>()
+
+defineEmits<{
+  'update:modelValue': [values: Record<string, unknown>]
+  'update:collapsed': [value: boolean]
+  'update:toggle': [sectionId: string, value: boolean]
+  'section-action': [sectionId: string, actionId: string]
+  'form-submit': [sectionId: string, values: Record<string, unknown>]
+  'form-cancel': [sectionId: string]
+}>()
+
+defineSlots<{
+  header?: (props: Record<string, unknown>) => unknown
+  collapsed?: (props: Record<string, unknown>) => unknown
+  'collapsed-footer'?: (props: Record<string, unknown>) => unknown
+  footer?: (props: Record<string, unknown>) => unknown
+}>()
+</script>
+
+<template>
+  <AppSidebar
+    :title="sidebar.title"
+    :subtitle="sidebar.subtitle"
+    :badge="sidebar.badge"
+    :variant="sidebar.variant"
+    :panels="sidebar.panels"
+    :active-view="sidebar.activeView"
+    :floating="sidebar.floating"
+    :dense="sidebar.dense"
+    :width="sidebar.width"
+    :side="sidebar.side"
+    :forms="sidebar.forms"
+    :content-id="sidebar.contentId"
+    :show-when-empty="sidebar.showWhenEmpty"
+    :model="sidebar.model"
+    :controls="sidebar.controlSchema"
+    :control-options="sidebar.controlOptions"
+    :values="sidebar.values"
+    :form-enhancements="sidebar.formEnhancements"
+    :show-form-actions="sidebar.showFormActions"
+    :form-loading="sidebar.formLoading"
+    :form-disabled="sidebar.formDisabled"
+    :form-readonly="sidebar.formReadonly"
+    :form-size="sidebar.formSize"
+    :collapsible="sidebar.collapsible"
+    :collapsed="sidebar.collapsed"
+    :default-collapsed="sidebar.defaultCollapsed"
+    :collapsed-width="sidebar.collapsedWidth"
+    :collapse-button-label="sidebar.collapseButtonLabel"
+    :expand-button-label="sidebar.expandButtonLabel"
+    @update:model-value="$emit('update:modelValue', $event)"
+    @update:collapsed="$emit('update:collapsed', $event)"
+    @update:toggle="(sectionId, value) => $emit('update:toggle', sectionId, value)"
+    @section-action="(sectionId, actionId) => $emit('section-action', sectionId, actionId)"
+    @form-submit="(sectionId, values) => $emit('form-submit', sectionId, values)"
+    @form-cancel="$emit('form-cancel', $event)"
+  >
+    <template
+      v-for="slotName in sidebar.slotNames"
+      :key="slotName"
+      #[slotName]="slotProps"
+    >
+      <!-- @vue-ignore dynamic SDK slot forwarding for AppSidebar section-* passthrough slots -->
+      <slot
+        :name="slotName"
+        v-bind="slotProps ?? {}"
+      />
+    </template>
+  </AppSidebar>
+</template>

package/src/composables/experimentDesignData.ts

@@ -1,4 +1,5 @@
 import type { SelectOption } from '../types'
+import { isRecord } from '../utils/records'
 
 export interface ExperimentDesignDataResponse {
   experiment_id?: number
@@ -12,9 +13,6 @@ export interface ExtractExperimentSamplesOptions {
   includeControls?: boolean
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return value !== null && typeof value === 'object' && !Array.isArray(value)
-}
 
 function isPlatformDesignDataResponse(value: Record<string, unknown>): boolean {
   return (

package/src/composables/flattenWorkspaceBindings.ts

@@ -0,0 +1,104 @@
+import { computed } from 'vue'
+import type { ComputedRef } from 'vue'
+import type {
+  BioTemplateComponentBinding,
+  BioTemplateComponentBindingsById,
+  BioTemplateComponentImport,
+  BioTemplateComponentPropsByComponent,
+  BioTemplateComponentPropsBinding,
+  BioTemplateComponentPropsById,
+  BioTemplateComponentPropsLookupOptions,
+  BioTemplateComponentSnippet,
+  BioTemplateComponentUsage,
+} from './useBioTemplateComponents'
+
+/**
+ * The template-component slice of `UseBioTemplateWorkspaceReturn`: the ~9 keys every
+ * bio-template workspace composable (`useBioTemplateWorkspace`, `useBioTemplatePackWorkspace`,
+ * `useBioTemplatePresetWorkspace`) re-exposes verbatim from `useBioTemplateComponents()`.
+ */
+export interface BioTemplateWorkspaceComponentBindings {
+  componentBindings: BioTemplateComponentBinding[]
+  componentBindingsById: BioTemplateComponentBindingsById
+  componentImports: BioTemplateComponentImport[]
+  componentProps: BioTemplateComponentPropsBinding[]
+  componentPropsById: BioTemplateComponentPropsById
+  componentPropsByComponent: BioTemplateComponentPropsByComponent
+  componentSnippets: BioTemplateComponentSnippet[]
+  componentUsage: BioTemplateComponentUsage | null
+  getComponentProps: (component: string, options?: BioTemplateComponentPropsLookupOptions) => Record<string, unknown> | undefined
+}
+
+/** Structural source shape accepted by {@link flattenWorkspaceComponentBindings}. */
+export interface BioTemplateWorkspaceComponentSource {
+  componentBindings: BioTemplateComponentBinding[]
+  componentBindingsById: BioTemplateComponentBindingsById
+  componentImports: BioTemplateComponentImport[]
+  componentProps: BioTemplateComponentPropsBinding[]
+  componentPropsById: BioTemplateComponentPropsById
+  componentPropsByComponent: BioTemplateComponentPropsByComponent
+  componentSnippets: BioTemplateComponentSnippet[]
+  componentUsage: BioTemplateComponentUsage | null
+  getComponentProps: (component: string, options?: BioTemplateComponentPropsLookupOptions) => Record<string, unknown> | undefined
+}
+
+/**
+ * Pick the shared template-component binding keys off a resolved bio-template workspace
+ * (or its `components` source directly), so composables that build on `useBioTemplateWorkspace`
+ * spread one object instead of re-listing all 9 keys by hand.
+ *
+ * @example Recommended
+ * ```ts
+ * const bindings = { renderer, ...flattenWorkspaceComponentBindings(components) }
+ * ```
+ */
+export function flattenWorkspaceComponentBindings(
+  source: BioTemplateWorkspaceComponentSource,
+): BioTemplateWorkspaceComponentBindings {
+  return {
+    componentBindings: source.componentBindings,
+    componentBindingsById: source.componentBindingsById,
+    componentImports: source.componentImports,
+    componentProps: source.componentProps,
+    componentPropsById: source.componentPropsById,
+    componentPropsByComponent: source.componentPropsByComponent,
+    componentSnippets: source.componentSnippets,
+    componentUsage: source.componentUsage,
+    getComponentProps: source.getComponentProps,
+  }
+}
+
+/** Keys of {@link BioTemplateWorkspaceComponentBindings} that are plain (non-reactive) values, lifted to `ComputedRef`s by {@link liftWorkspaceComponentBindings}. */
+export type LiftedBioTemplateWorkspaceComponentBindings =
+  { [K in Exclude<keyof BioTemplateWorkspaceComponentBindings, 'getComponentProps'>]: ComputedRef<BioTemplateWorkspaceComponentBindings[K]> }
+  & { getComponentProps: BioTemplateWorkspaceComponentBindings['getComponentProps'] }
+
+/**
+ * `computed()`-lifted version of {@link flattenWorkspaceComponentBindings} for composables
+ * that hold their resolved workspace behind a `ComputedRef` (e.g. a regenerated workspace
+ * swapped in via `shallowRef`/`effectScope`), so each key stays independently reactive
+ * instead of forcing consumers to unwrap the whole workspace to read one field.
+ * `getComponentProps` stays a plain callable function, matching the un-lifted composables.
+ *
+ * @example Recommended
+ * ```ts
+ * const workspace = computed(() => workspaceRef.value)
+ * const { componentBindings, componentProps, getComponentProps } = liftWorkspaceComponentBindings(workspace)
+ * ```
+ */
+export function liftWorkspaceComponentBindings<TSource extends BioTemplateWorkspaceComponentSource>(
+  workspace: ComputedRef<TSource>,
+): LiftedBioTemplateWorkspaceComponentBindings {
+  return {
+    componentBindings: computed(() => workspace.value.componentBindings),
+    componentBindingsById: computed(() => workspace.value.componentBindingsById),
+    componentImports: computed(() => workspace.value.componentImports),
+    componentProps: computed(() => workspace.value.componentProps),
+    componentPropsById: computed(() => workspace.value.componentPropsById),
+    componentPropsByComponent: computed(() => workspace.value.componentPropsByComponent),
+    componentSnippets: computed(() => workspace.value.componentSnippets),
+    componentUsage: computed(() => workspace.value.componentUsage),
+    getComponentProps: (component: string, options?: BioTemplateComponentPropsLookupOptions) =>
+      workspace.value.getComponentProps(component, options),
+  }
+}

package/src/composables/formBuilderRegistry.ts

@@ -2,6 +2,7 @@ import type { Component } from 'vue'
 import type { FormFieldType } from '../types/form-builder'
 
 import BaseInput from '../components/BaseInput.vue'
+import SecretInput from '../components/SecretInput.vue'
 import BaseTextarea from '../components/BaseTextarea.vue'
 import BaseSelect from '../components/BaseSelect.vue'
 import MultiSelect from '../components/MultiSelect.vue'
@@ -34,6 +35,7 @@ const registry: Record<FormFieldType, RegistryEntry> = {
   text: { component: BaseInput, defaults: { type: 'text' }, vModel: true },
   email: { component: BaseInput, defaults: { type: 'email' }, vModel: true },
   password: { component: BaseInput, defaults: { type: 'password' }, vModel: true },
+  secret: { component: SecretInput, defaults: {}, vModel: true },
   tel: { component: BaseInput, defaults: { type: 'tel' }, vModel: true },
   url: { component: BaseInput, defaults: { type: 'url' }, vModel: true },
   search: { component: BaseInput, defaults: { type: 'search' }, vModel: true },
@@ -75,6 +77,9 @@ export function getTypeDefault(type: FormFieldType): unknown {
     case 'multiselect':
     case 'tags':
       return []
+    case 'secret':
+      // A secret field has no empty string state: `null` means "not stored".
+      return null
     default:
       return ''
   }

package/src/composables/index.ts

@@ -528,3 +528,29 @@ export {
   type UsePluginJobCenterOptions,
   type UsePluginJobCenterReturn,
 } from './useJobsStatusTray'
+export {
+  usePluginWorkspace,
+  type PluginWorkspaceSlotsLike,
+  type UsePluginWorkspaceOptions,
+  type UsePluginWorkspaceReturn,
+} from './usePluginWorkspace'
+export {
+  type PluginWorkspaceControlsModel,
+  type PluginWorkspaceShellModel,
+  type PluginWorkspaceSidebarModel,
+} from './pluginWorkspaceModel'
+export {
+  useFocusTrap,
+  type UseFocusTrapOptions,
+  type UseFocusTrapReturn,
+} from './useFocusTrap'
+export {
+  useRovingFocus,
+  type UseRovingFocusOptions,
+  type UseRovingFocusReturn,
+} from './useRovingFocus'
+export {
+  useMenuKeyboard,
+  type UseMenuKeyboardOptions,
+  type UseMenuKeyboardReturn,
+} from './useMenuKeyboard'

package/src/composables/pluginWorkspaceModel.ts

@@ -0,0 +1,182 @@
+import type {
+  AccountMenuItem,
+  PageSelectorItemInput,
+  PillNavItemInput,
+  PluginSwitcherInfo,
+  SidebarToolSection,
+  TopBarSettingsConfig,
+  TopBarVariant,
+} from '../types'
+import type { FormEnhancements, FormSchema } from '../types/form-builder'
+import type {
+  ControlComponentBinding,
+  ControlComponentBindingsById,
+  ControlModel,
+  ControlModelBinding,
+  ControlSchema,
+  ControlWorkspaceOptions,
+} from './useControlSchema'
+import type { PluginWorkspaceSidebarVariant } from '../components/PluginWorkspaceView.props'
+
+/**
+ * Scoped-slot payload shared by PluginWorkspaceView's `default`, `topbar`, and `sidebar`
+ * slots: the resolved active view plus the values and component bindings/props derived
+ * from the compact control schema. WorkspaceControlsInternal renders a component's default
+ * slot bound to exactly this shape.
+ */
+export interface PluginWorkspaceControlsModel {
+  /** Currently resolved workspace view id. */
+  activeView: string
+  /** Sets the active view, updating any uncontrolled state and emitting `update:activeView`. */
+  setActiveView: (viewId: string) => void
+  /** Current control values, shared between the auto-rendered sidebar form and the default slot. */
+  values: Record<string, unknown>
+  /** Ordered SDK component bindings resolved from the current control values. */
+  componentBindings: ControlComponentBinding[]
+  /** SDK component bindings resolved from the current control values, keyed by binding id. */
+  componentBindingsById: ControlComponentBindingsById
+  /** Flat component props resolved from the current control values. */
+  componentProps: Record<string, unknown>
+  /** Named component prop mappings resolved from the current control values. */
+  componentPropsById: Record<string, Record<string, unknown>>
+}
+
+/**
+ * Resolved AppLayout + AppTopBar configuration consumed by WorkspaceShellInternal: top bar
+ * chrome and navigation, plus the AppLayout layout/collapse props that own the responsive
+ * mobile sidebar toggle.
+ */
+export interface PluginWorkspaceShellModel {
+  /** AppLayout sidebar position. */
+  sidebarPosition: 'left' | 'right'
+  /** AppLayout sidebar width, forwarded so the layout can reserve space before AppSidebar mounts. */
+  sidebarWidth?: string
+  /** AppLayout floating style. */
+  floating: boolean
+  /** Convert the sidebar into an SDK-owned mobile overlay below the AppLayout breakpoint. */
+  responsiveSidebar: boolean
+  /** Accessible label for the mobile sidebar toggle. */
+  sidebarToggleLabel: string
+  /** Accessible label used when the mobile sidebar is open. */
+  sidebarCloseLabel: string
+  /** Whether AppLayout should render a `#sidebar` template at all. */
+  hasSidebarSurface: boolean
+  /** App or plugin title shown in the top bar. */
+  title: string
+  /** Secondary copy shown under the title. */
+  subtitle?: string
+  /** Top bar visual treatment. */
+  topBarVariant: TopBarVariant
+  /** Home link used by the top bar brand icon. */
+  homePath: string
+  /** Show the default MINT logo when no icon/logo slot is provided. */
+  showLogo: boolean
+  /** Preferred route-level page selector entries. */
+  pageSelector?: PageSelectorItemInput[]
+  /** Resolved active page selector id. */
+  currentPageSelectorId: string
+  /** Optional plugin switcher shown in the left navigation position. */
+  pluginSwitcher?: PluginSwitcherInfo
+  /** Resolved centered pill navigation, generated from the control schema when omitted. */
+  pillNav?: PillNavItemInput[]
+  /** Resolved active centered pill id. */
+  currentPillId: string
+  /** Show the theme toggle button. */
+  showThemeToggle: boolean
+  /** Show the settings button and modal. */
+  showSettings: boolean
+  /** Built-in settings modal configuration. */
+  settingsConfig?: TopBarSettingsConfig
+  /** Show the standalone badge when not integrated into the platform. */
+  showStandaloneLabel: boolean
+  /** Custom standalone badge label. */
+  standaloneLabel: string
+  /** Account dropdown entries. */
+  accountMenu?: AccountMenuItem[]
+  /** Show the notifications icon button. */
+  showNotifications: boolean
+  /** Draw a notification dot on the notifications icon. */
+  hasNotificationDot: boolean
+  /** Show the admin shortcut. */
+  showAdmin: boolean
+  /** Route used by the admin shortcut. */
+  adminPath: string
+  /** Account display name. */
+  userName?: string
+  /** Explicit account avatar initial. */
+  userInitial?: string
+  /** Account email shown in the avatar menu. */
+  userEmail?: string
+  /** Names of AppTopBar passthrough slots the caller actually provided. */
+  topBarSlotNames: string[]
+  /** Scoped-slot payload exposed to the `topbar` override slot. */
+  controls: PluginWorkspaceControlsModel
+}
+
+/**
+ * Resolved AppSidebar configuration consumed by WorkspaceSidebarInternal: sidebar chrome,
+ * panels/forms, collapse behavior, and the compact control-schema props that drive
+ * AppSidebar's auto-generated form.
+ */
+export interface PluginWorkspaceSidebarModel {
+  /** Sidebar chrome title. */
+  title?: string
+  /** Sidebar chrome subtitle. */
+  subtitle?: string
+  /** Optional compact badge/count rendered in the sidebar header. */
+  badge?: string | number
+  /** AppSidebar visual preset. */
+  variant: PluginWorkspaceSidebarVariant
+  /** Map of view IDs to sidebar tool sections. */
+  panels: Record<string, SidebarToolSection[]>
+  /** Resolved active view, used to pick which panels/forms render. */
+  activeView: string
+  /** AppSidebar floating style (always false: PluginWorkspaceView docks the sidebar inside AppLayout). */
+  floating: boolean
+  /** Compact AppSidebar density. */
+  dense: boolean
+  /** Sidebar CSS width. */
+  width?: string
+  /** Sidebar position, mirrors the shell's `sidebarPosition`. */
+  side: 'left' | 'right'
+  /** Optional FormBuilder schemas keyed by section ID. */
+  forms: Record<string, FormSchema>
+  /** DOM id for the AppSidebar scrollable content area. */
+  contentId?: string
+  /** Render the sidebar shell even when no panel matches the active view. */
+  showWhenEmpty: boolean
+  /** Optional compact control model for the generated sidebar form. */
+  model?: ControlModel | ControlModelBinding
+  /** Compact control schema for the generated sidebar form. */
+  controlSchema?: ControlSchema
+  /** Options passed to compact control schema generation. */
+  controlOptions: ControlWorkspaceOptions
+  /** Shared values for the auto-rendered sidebar form. */
+  values: Record<string, unknown>
+  /** Runtime FormBuilder enhancements for the auto-rendered sidebar form. */
+  formEnhancements?: FormEnhancements<Record<string, unknown>>
+  /** Show submit/cancel actions inside the auto-rendered sidebar form. */
+  showFormActions: boolean
+  /** Loading/saving state for the auto-rendered sidebar form. */
+  formLoading: boolean
+  /** Disabled state for the auto-rendered sidebar form. */
+  formDisabled: boolean
+  /** Readonly state for the auto-rendered sidebar form. */
+  formReadonly: boolean
+  /** Size passed to the auto-rendered sidebar form. */
+  formSize: 'sm' | 'md' | 'lg'
+  /** Show a built-in collapse/expand button in the sidebar chrome. */
+  collapsible?: boolean
+  /** Controlled sidebar collapsed state. */
+  collapsed?: boolean
+  /** Initial sidebar collapsed state when uncontrolled. */
+  defaultCollapsed: boolean
+  /** Sidebar width when collapsed. */
+  collapsedWidth: string
+  /** Accessible label for the sidebar collapse action. */
+  collapseButtonLabel: string
+  /** Accessible label for the sidebar expand action. */
+  expandButtonLabel: string
+  /** Names of AppSidebar passthrough slots the caller actually provided. */
+  slotNames: string[]
+}

package/src/composables/useAsync.ts

@@ -165,7 +165,11 @@ function defaultTransformError(error: unknown): AsyncError {
  * const handleSubmit = () => submit(new FormData(formRef.value))
  * ```
  */
-/** Wraps an async function with reactive loading, error, and success state plus optional auto-execute. */
+/**
+ * Wraps an async function with reactive loading, error, and success state plus optional auto-execute.
+ *
+ * @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useRequestSyncState()` instead.
+ */
 export function useAsync<T>(
   asyncFn: (...args: unknown[]) => Promise<T>,
   options: UseAsyncOptions<T> = {}

package/src/composables/useBioTemplatePackWorkspace.ts

@@ -27,6 +27,9 @@ import {
   type BioTemplateWorkspaceBindings,
   type UseBioTemplateWorkspaceReturn,
 } from './useBioTemplateWorkspace'
+import {
+  liftWorkspaceComponentBindings,
+} from './flattenWorkspaceBindings'
 import type {
   BioTemplateComponentBinding,
   BioTemplateComponentBindingsById,
@@ -120,14 +123,17 @@ export function useBioTemplatePackWorkspace(
   const pillNav = computed(() => workspace.value.pillNav)
   const topBarSettings = computed(() => workspace.value.topBarSettings)
   const bindings = computed(() => workspace.value.bindings)
-  const componentBindings = computed(() => workspace.value.componentBindings)
-  const componentBindingsById = computed(() => workspace.value.componentBindingsById)
-  const componentImports = computed(() => workspace.value.componentImports)
-  const componentProps = computed(() => workspace.value.componentProps)
-  const componentPropsById = computed(() => workspace.value.componentPropsById)
-  const componentPropsByComponent = computed(() => workspace.value.componentPropsByComponent)
-  const componentSnippets = computed(() => workspace.value.componentSnippets)
-  const componentUsage = computed(() => workspace.value.componentUsage)
+  const {
+    componentBindings,
+    componentBindingsById,
+    componentImports,
+    componentProps,
+    componentPropsById,
+    componentPropsByComponent,
+    componentSnippets,
+    componentUsage,
+    getComponentProps: getWorkspaceComponentProps,
+  } = liftWorkspaceComponentBindings(workspace)
 
   watch(collection, value => {
     workspaceRef.value = createWorkspace(value)
@@ -181,7 +187,7 @@ export function useBioTemplatePackWorkspace(
     componentPropsByComponent,
     componentSnippets,
     componentUsage,
-    getComponentProps: (component, options) => workspace.value.getComponentProps(component, options),
+    getComponentProps: getWorkspaceComponentProps,
     applyCollection,
     resetToDefaultCollection,
     save: templateCollection.save,