@morscherlab/mint-sdk 1.0.0-rc.4 → 1.0.0-rc.6

package/src/components/PluginWorkspaceView.props.ts

@@ -0,0 +1,174 @@
+import type {
+  AccountMenuItem,
+  PageSelectorItemInput,
+  PillNavItemInput,
+  PluginSwitcherInfo,
+  SidebarToolSection,
+  TopBarSettingsConfig,
+  TopBarVariant,
+} from '../types'
+import type { FormEnhancements, FormSchema } from '../types/form-builder'
+import type {
+  ControlComponentBinding,
+  ControlComponentBindingsById,
+  ControlComponentBindingsConfig,
+  ControlComponentPropsByIdMap,
+  ControlComponentPropsMap,
+  ControlModel,
+  ControlModelBinding,
+  ControlSchema,
+  ControlWorkspaceOptions,
+} from '../composables/useControlSchema'
+import type { AppExperimentRecord } from '../composables/useAppExperiment'
+
+export type PluginWorkspaceSidebarVariant = 'default' | 'analysis'
+
+export interface PluginWorkspaceViewProps {
+  /** 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[]
+  /** Active page selector id. Defaults to activeView. */
+  currentPageSelectorId?: string
+  /** Optional plugin switcher shown in the left navigation position. */
+  pluginSwitcher?: PluginSwitcherInfo
+  /** Preferred centered navigation for local modes inside the current route. */
+  pillNav?: PillNavItemInput[]
+  /** Active centered pill id. Defaults to activeView. */
+  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 classic admin shortcut. */
+  showAdmin?: boolean
+  /** Route used by the classic admin shortcut. */
+  adminPath?: string
+  /** Show the classic profile button when accountMenu is not provided. */
+  showProfile?: boolean
+  /** Classic profile display name. */
+  userName?: string
+  /** Explicit classic profile initial. */
+  userInitial?: string
+  /** Classic profile email. */
+  userEmail?: string
+  /** Enable the built-in AppTopBar experiment popover and selector flow. */
+  experimentShell?: boolean
+  /** Current experiment mirrored into the AppTopBar experiment chip when experimentShell is enabled. */
+  experiment?: AppExperimentRecord | null
+  /** Save handler used by the AppTopBar experiment chip. Return a message to flash success. */
+  experimentSave?: () => string | null | Promise<string | null>
+  /** Disable the experiment save action. */
+  experimentSaveDisabled?: boolean
+  /** Tooltip shown when the experiment save action is disabled. */
+  experimentSaveDisabledMessage?: string
+
+  /** Active workspace view used by top bar navigation and sidebar panels. */
+  activeView?: string
+  /** Initial active view when activeView is uncontrolled. */
+  defaultActiveView?: string
+  /** Map of view IDs to sidebar tool sections. */
+  panels?: Record<string, SidebarToolSection[]>
+  /** Optional FormBuilder schemas keyed by section ID. */
+  forms?: Record<string, FormSchema>
+  /** Sidebar chrome title. */
+  sidebarTitle?: string
+  /** Sidebar chrome subtitle. */
+  sidebarSubtitle?: string
+  /** Optional compact badge/count rendered in the sidebar header. */
+  sidebarBadge?: string | number
+  /** AppSidebar visual preset. `analysis` matches the LEAF-style MINT analysis sidebar language. */
+  sidebarVariant?: PluginWorkspaceSidebarVariant
+  /** Sidebar CSS width. Defaults to AppSidebar's variant width. */
+  sidebarWidth?: string
+  /** Sidebar position in AppLayout. */
+  sidebarPosition?: 'left' | 'right'
+  /** Convert the sidebar into an SDK-owned mobile overlay below the AppLayout breakpoint. */
+  responsiveSidebar?: boolean
+  /** Render the sidebar shell even when no panel matches the active view. */
+  showSidebarWhenEmpty?: boolean
+  /** Disable the built-in sidebar surface entirely. */
+  showSidebar?: boolean
+  /** DOM id for the AppSidebar scrollable content area. Use with route/tab-owned Teleport sidebars. */
+  sidebarContentId?: string
+  /** Compact AppSidebar density. */
+  dense?: boolean
+  /** Show a built-in collapse/expand button in the sidebar chrome. Defaults to AppSidebar's variant behavior. */
+  sidebarCollapsible?: boolean
+  /** Sidebar width when collapsed. */
+  sidebarCollapsedWidth?: string
+  /** Accessible label for the sidebar collapse action. */
+  sidebarCollapseButtonLabel?: string
+  /** Accessible label for the sidebar expand action. */
+  sidebarExpandButtonLabel?: string
+  /** Floating AppLayout style. */
+  floating?: boolean
+  /** Optional compact control model for generated sidebar forms. */
+  model?: ControlModel | ControlModelBinding
+  /** Compact control schema for generated sidebar forms. */
+  controls?: ControlSchema
+  /** Options passed to compact control schema generation. */
+  controlOptions?: ControlWorkspaceOptions
+  /** Optional SDK component bindings exposed to the default slot with resolved props. */
+  componentBindings?: ControlComponentBindingsConfig
+  /** Optional mapping from workspace values to component props exposed to the default slot. */
+  componentProps?: ControlComponentPropsMap
+  /** Optional named mappings from workspace values to component props exposed to the default slot. */
+  componentPropsById?: ControlComponentPropsByIdMap
+  /** Shared values for auto-rendered sidebar forms. Supports default v-model. */
+  modelValue?: Record<string, unknown>
+  /** Shared values for auto-rendered sidebar forms. */
+  values?: Record<string, unknown>
+  /** Runtime FormBuilder enhancements for auto-rendered sidebar forms. */
+  formEnhancements?: FormEnhancements<Record<string, unknown>>
+  /** Show submit/cancel actions inside auto-rendered sidebar forms. */
+  showFormActions?: boolean
+  /** Loading/saving state for auto-rendered sidebar forms. */
+  formLoading?: boolean
+  /** Disabled state for auto-rendered sidebar forms. */
+  formDisabled?: boolean
+  /** Readonly state for auto-rendered sidebar forms. */
+  formReadonly?: boolean
+  /** Size passed to auto-rendered sidebar forms. */
+  formSize?: 'sm' | 'md' | 'lg'
+  /** Controlled sidebar collapsed state. */
+  sidebarCollapsed?: boolean
+  /** Initial sidebar collapsed state when uncontrolled. */
+  defaultSidebarCollapsed?: boolean
+  /** Accessible label for the mobile sidebar toggle. */
+  sidebarToggleLabel?: string
+  /** Accessible label used when the mobile sidebar is open. */
+  sidebarCloseLabel?: string
+}
+
+export interface PluginWorkspaceSlotProps {
+  activeView: string
+  setActiveView: (viewId: string) => void
+  values: Record<string, unknown>
+  componentBindings: ControlComponentBinding[]
+  componentBindingsById: ControlComponentBindingsById
+  componentProps: Record<string, unknown>
+  componentPropsById: Record<string, Record<string, unknown>>
+}
+
+export type PluginWorkspaceForwardedSlotProps = Record<string, unknown>

package/src/components/PluginWorkspaceView.shell.ts

@@ -0,0 +1,67 @@
+const topBarForwardedSlots = new Set([
+  'icon',
+  'logo',
+  'page-selector-icon',
+  'page-selector-item-icon',
+  'nav',
+  'center',
+  'actions',
+  'account-menu-items',
+  'account-menu-item-icon',
+  'settings-appearance',
+])
+
+const sidebarForwardedSlots = new Set([
+  'header',
+  'collapsed',
+  'collapsed-footer',
+  'footer',
+])
+
+type SlotKeyMap = Readonly<Record<string, unknown>>
+
+export interface PluginWorkspaceSidebarSurfaceOptions {
+  showSidebar: boolean
+  panels: Record<string, unknown>
+  forms: Record<string, unknown>
+  model: unknown
+  controls: unknown
+  showSidebarWhenEmpty: boolean
+  sidebarContentId?: string
+  sidebarTitle?: string
+  sidebarSubtitle?: string
+  sidebarBadge?: string | number
+  hasSidebarSlot: boolean
+  sidebarSlotCount: number
+}
+
+export function getPluginWorkspaceTopBarSlotNames(slots: SlotKeyMap): string[] {
+  return Object.keys(slots).filter(name =>
+    topBarForwardedSlots.has(name) || name.startsWith('settings-tab-'),
+  )
+}
+
+export function getPluginWorkspaceSidebarSlotNames(slots: SlotKeyMap): string[] {
+  return Object.keys(slots).filter(name =>
+    sidebarForwardedSlots.has(name) || name.startsWith('section-'),
+  )
+}
+
+export function hasPluginWorkspaceSidebarSurface(
+  options: PluginWorkspaceSidebarSurfaceOptions,
+): boolean {
+  if (!options.showSidebar) return false
+  return (
+    Object.keys(options.panels).length > 0
+    || Object.keys(options.forms).length > 0
+    || options.model !== undefined
+    || options.controls !== undefined
+    || options.showSidebarWhenEmpty
+    || options.sidebarContentId !== undefined
+    || options.sidebarTitle !== undefined
+    || options.sidebarSubtitle !== undefined
+    || options.sidebarBadge !== undefined
+    || options.hasSidebarSlot
+    || options.sidebarSlotCount > 0
+  )
+}