@morscherlab/mint-sdk 1.4.0-beta.8 → 1.4.0

package/dist/composables/pluginIdentity.d.ts

@@ -0,0 +1,24 @@
+import { PluginContract } from './createClient';
+/** The `plugin` block of the generated contract (`./generated/mint-plugin`) that `providePluginIdentity` reads. */
+export interface PluginIdentityContract {
+    plugin: Pick<PluginContract['plugin'], 'name' | 'displayName' | 'subtitle' | 'description' | 'icon'>;
+}
+/** The seeded identity AppTopBar shows in standalone mode. Internal: not exported from the package. */
+export declare const pluginIdentity: {
+    readonly name?: string | undefined;
+    readonly subtitle?: string | undefined;
+    readonly icon?: string | undefined;
+};
+/**
+ * Seed the standalone AppTopBar with the plugin name, subtitle and icon. In integrated
+ * mode the platform supplies them. Explicit `title`/`subtitle` props and the `#icon` slot still win.
+ *
+ * @example
+ * ```typescript
+ * import { providePluginIdentity } from '@morscherlab/mint-sdk'
+ * import { contract } from './generated/mint-plugin'
+ *
+ * providePluginIdentity(contract)
+ * ```
+ */
+export declare function providePluginIdentity(contract: PluginIdentityContract): void;

package/dist/composables/pluginWorkspaceModel.d.ts

@@ -42,8 +42,8 @@ export interface PluginWorkspaceShellModel {
     sidebarCloseLabel: string;
     /** Whether AppLayout should render a `#sidebar` template at all. */
     hasSidebarSurface: boolean;
-    /** App or plugin title shown in the top bar. */
-    title: string;
+    /** Top bar title. Unset, the top bar shows the plugin identity (`providePluginIdentity` or the platform). */
+    title?: string;
     /** Secondary copy shown under the title. */
     subtitle?: string;
     /** AppTopBar spec with the workspace defaults applied and the generated pills filled in; `false` removes the top bar. */

package/dist/composables/useAppExperiment.d.ts

@@ -10,11 +10,18 @@ export interface UseAppExperimentOptions {
     onDetach?: () => void;
     saveDisabled?: Ref<boolean> | ComputedRef<boolean>;
     saveDisabledMessage?: string | Ref<string | undefined> | ComputedRef<string | undefined>;
+    /** Unsaved changes; marks the Save button with a dot. */
+    dirty?: Ref<boolean> | ComputedRef<boolean>;
 }
 export interface AppExperimentPopoverBinding {
     experimentName?: string;
     experimentCode?: string;
     experimentStatus?: ExperimentStatus;
+    experimentId?: number | null;
+    experimentProject?: string;
+    experimentOwner?: string;
+    /** ISO timestamp of the experiment's last update. */
+    experimentUpdatedAt?: string;
     /** An experiment is bound but its record has not arrived yet. */
     isResolving: boolean;
     /** Resolution failed; the binding is kept so the user can retry or detach. */
@@ -25,6 +32,7 @@ export interface AppExperimentPopoverBinding {
     saveDisabledMessage?: string;
     saveLoading: boolean;
     saveSuccessMessage?: string;
+    dirty?: boolean;
 }
 export interface AppExperimentSelectorModalBinding {
     open: boolean;

package/dist/composables/useCalendarGrid.d.ts

@@ -22,5 +22,5 @@ export interface UseCalendarGridReturn {
     prevMonth: () => void;
     nextMonth: () => void;
 }
-/** Shared calendar grid state for date and datetime pickers. */
+/** Shared Monday-first calendar grid state for date and datetime pickers. */
 export declare function useCalendarGrid(options?: UseCalendarGridOptions): UseCalendarGridReturn;

package/dist/composables/useExperimentSelector.d.ts

@@ -6,6 +6,8 @@ export interface UseExperimentSelectorOptions {
     apiBaseUrl?: string;
     limit?: number;
     immediate?: boolean;
+    /** Keep `statusCounts` in step with the non-status filters (one stats request per change). */
+    withStatusCounts?: boolean;
 }
 export interface UseExperimentSelectorReturn {
     /** Current page of fetched experiment rows. */
@@ -32,8 +34,8 @@ export interface UseExperimentSelectorReturn {
     experimentTypes: Ref<ExperimentTypeOption[]>;
     /** Available project options for filter UI. */
     projects: Ref<SelectOption<string>[]>;
-    /** Fetched experiments grouped by project name. */
-    groupedByProject: ComputedRef<[string, ExperimentSummary[]][]>;
+    /** Experiment count per status under every filter except status itself. */
+    statusCounts: Ref<Record<string, number>>;
     /** Fetch the current page with the current filters. */
     fetch: () => Promise<void>;
     /** Fetch and append the next page when available. */
@@ -46,6 +48,8 @@ export interface UseExperimentSelectorReturn {
     clear: () => void;
     /** Fetch experiment type and project filter options. */
     fetchFilterOptions: () => Promise<void>;
+    /** Fetch `statusCounts` from `GET /experiments/stats`. */
+    fetchStatusCounts: () => Promise<void>;
 }
 /** Fetches a paginated, filtered experiment list from the platform API for picker and selector UIs. */
 export declare function useExperimentSelector(options?: UseExperimentSelectorOptions): UseExperimentSelectorReturn;

package/dist/composables/useFileImport.d.ts

@@ -31,5 +31,12 @@ export interface UseFileImportReturn<TResult> {
 export declare function useFileImport<TResult = string>(options?: FileImportOptions<TResult>): UseFileImportReturn<TResult>;
 export declare function validateImportFile(file: File, options?: FileImportValidationOptions): void;
 export declare function readFileAsText(file: File, encoding?: string): Promise<string>;
+/**
+ * Read a `.csv`, `.tsv` or `.xlsx` upload as comma-delimited CSV text.
+ * A `.csv` file (or any other extension) comes back unchanged. An `.xlsx`
+ * file gives its first sheet; each cell is its stored value, so number
+ * formats such as leading zeros are not applied. Dates become ISO text.
+ */
+export declare function readTableFileAsCsv(file: File): Promise<string>;
 export declare function parseDelimitedText(text: string, options?: ParseDelimitedTextOptions): DelimitedTable;
 export declare function detectDelimiter(text: string): string;

package/dist/composables/useFloatingPanel.d.ts

@@ -0,0 +1,29 @@
+import { Placement, ReferenceElement } from '@floating-ui/dom';
+import { MaybeRefOrGetter, Ref } from 'vue';
+export interface UseFloatingPanelOptions {
+    /** Default `'bottom-start'`. */
+    placement?: MaybeRefOrGetter<Placement>;
+    /** Gap to the reference in px. Default 4. */
+    offset?: number;
+    /** At least the reference width, at most 28rem (selects). */
+    matchWidth?: boolean;
+    /** Re-place on scroll, resize and layout shift while open. Default `true`. */
+    follow?: boolean;
+}
+export interface UseFloatingPanelReturn {
+    /** Bind to the panel: `position: fixed`, `left`, `top`, and `visibility: hidden` while the reference is scrolled out of view. */
+    style: Ref<Record<string, string>>;
+    /** The placement after flip, for arrows and transitions. */
+    placement: Ref<Placement>;
+    update: () => Promise<void>;
+}
+/**
+ * Places `floating` next to `reference` with fixed positioning (offset, flip,
+ * shift, size, hide). A fixed panel escapes the `overflow` of its ancestors (a
+ * modal body) unless one of them has a transform, so it can stay in the DOM right
+ * after its trigger: Tab order, focus traps and outside-click checks are those of
+ * an in-place panel. The size middleware publishes the free height as
+ * `--mint-floating-available-height`; a panel whose list scrolls caps its
+ * `max-height` with it.
+ */
+export declare function useFloatingPanel(reference: MaybeRefOrGetter<ReferenceElement | null>, floating: Ref<HTMLElement | null>, open: Ref<boolean>, options?: UseFloatingPanelOptions): UseFloatingPanelReturn;

package/dist/composables/useJobCenter.d.ts

@@ -1,6 +1,5 @@
 import { ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
-import { JobListPayload, JobState, JobStateInput } from '../types/jobs';
-export type JobsStatusTrayTab = 'active' | 'history';
+import { JobListPayload, JobState, JobStateInput, JobStatus, TopBarJob } from '../types/jobs';
 /**
  * The canonical owner of a collection of plugin jobs.
  *
@@ -29,8 +28,38 @@ export declare function combinePluginJobSources(sources: readonly PluginJobCente
 export interface UseJobCenterOptions {
     source?: MaybeRefOrGetter<PluginJobCenterSource | undefined>;
     loadOnMount?: boolean;
+    /**
+     * Maps the job that the top-bar chip shows. It is called for the chosen own
+     * active job AND for the held just-completed job, so check `job.status`.
+     * `null` keeps the default mapping.
+     */
+    topBarJob?: (job: JobState) => TopBarJob | null;
+    /**
+     * Overrides how a tray row looks: `status` (icon, awaiting-input tint and
+     * pinning), `percent` (progress bar and value) and `message` (detail line).
+     * A missing or `undefined` field, or a `null` status or message, keeps the
+     * job's own; `percent: null` hides the bar and shows the time, and a status
+     * alone keeps the job's own percent. The job's section, actions and counts
+     * do not change.
+     */
+    rowJob?: (job: JobState) => JobRowOverride | null;
+}
+/** A `rowJob` result; see `UseJobCenterOptions.rowJob`. */
+export interface JobRowOverride {
+    status?: JobStatus | null;
+    percent?: number | null;
+    message?: string | null;
+}
+/** How a tray row shows a job; see `UseJobCenterReturn.rowView`. */
+export interface JobRowView {
+    status: JobStatus;
+    /** 0-100, rounded; `null` hides the progress bar and shows the time instead. */
+    percent: number | null;
+    message: string;
 }
 export interface UseJobCenterReturn {
+    /** The current source; a new identity is a new job list. */
+    source: ComputedRef<PluginJobCenterSource | undefined>;
     jobs: ComputedRef<JobState[]>;
     activeJobs: ComputedRef<JobState[]>;
     historyJobs: ComputedRef<JobState[]>;
@@ -40,14 +69,23 @@ export interface UseJobCenterReturn {
     canCancel: ComputedRef<boolean>;
     canDelete: ComputedRef<boolean>;
     canClearFinished: ComputedRef<boolean>;
+    /** DOM id of the JobsStatusTray panel, for `AppTopBar`'s `jobsPanelId` prop. */
+    panelId: string;
+    /** The row view of a job, with the `rowJob` option applied. */
+    rowView: (job: JobState) => JobRowView;
+    /** The viewer's own job for `AppTopBar`'s `job` prop. */
+    topBarJob: ComputedRef<TopBarJob | null>;
+    /** Jobs in the list with status `completed`, for `AppTopBar`'s `jobsDone` prop. */
+    completedCount: ComputedRef<number>;
     isOpen: Ref<boolean>;
-    activeTab: Ref<JobsStatusTrayTab>;
     isLoading: Ref<boolean>;
     error: ShallowRef<string | null>;
     pendingJobIds: Ref<Set<string>>;
     open: () => void;
     close: () => void;
     toggle: () => void;
+    /** The top-bar chip: with the tray closed and none of the viewer's jobs active, selects the held just-completed job; else toggles. */
+    handleTopBarClick: (onSelect: (job: JobState) => void) => void;
     refresh: () => Promise<boolean>;
     cancelJob: (job: JobState) => Promise<boolean>;
     deleteJob: (job: JobState) => Promise<boolean>;

package/dist/composables/useOnboarding.d.ts

@@ -0,0 +1,119 @@
+import { ComputedRef, InjectionKey, MaybeRefOrGetter, ShallowRef } from 'vue';
+import { Placement } from '@floating-ui/dom';
+/** One card of a tour. It points at the element with `data-onboarding="<anchor>"`. */
+export interface OnboardingStep {
+    /** Stable id. A returning user sees only steps whose id is new. */
+    id: string;
+    /** `data-onboarding` value of the element the step points at. */
+    anchor: string;
+    title: string;
+    body: string;
+    /** Side of the anchor for the card. Default `bottom`. */
+    placement?: Placement;
+    /** `'click'`: the highlighted element takes clicks, and a click moves the tour to the next step. */
+    advanceOn?: 'click';
+    /** Leave the step out while this returns false, e.g. without the permission its control needs. */
+    available?: () => boolean;
+}
+export interface OnboardingTour {
+    id: string;
+    /** Name in the Help menu. */
+    title: string;
+    /** Start only while the app's route is this value. Omit it for elements on every page, such as the top bar. */
+    route?: string;
+    steps: OnboardingStep[];
+}
+export interface OnboardingTask {
+    id: string;
+    title: string;
+    /** Leave the task out while this returns false, e.g. without the permission it needs. */
+    available?: () => boolean;
+    /** The task is done when this returns true. The coordinator checks it at start, on a route change and when the Help menu opens. */
+    done?: () => boolean;
+    /** The link at the end of the task row. */
+    action?: {
+        label: string;
+        run: () => void;
+    };
+}
+/** A new feature. A dot marks its element until the user opens it. */
+export interface OnboardingNews {
+    id: string;
+    anchor: string;
+    title: string;
+    body: string;
+    placement?: Placement;
+}
+export interface OnboardingDefinition {
+    tours?: OnboardingTour[];
+    /** The "Getting started" checklist. */
+    checklist?: OnboardingTask[];
+    whatsNew?: OnboardingNews[];
+}
+export interface ProvideOnboardingOptions {
+    /** Storage namespace, e.g. `platform` or the plugin name. */
+    appId: string;
+    /** The signed-in user. `null` turns onboarding off (no user yet). Default: the platform user; `local` standalone or with auth off. */
+    userId?: MaybeRefOrGetter<string | number | null | undefined>;
+    /** The current route, matched against `OnboardingTour.route`. */
+    route?: MaybeRefOrGetter<string | null | undefined>;
+    /** Start unseen tours on their own. Default `true`. */
+    autoStart?: boolean;
+}
+/** The step on screen and the element it points at. */
+export interface OnboardingActiveStep {
+    step: OnboardingStep;
+    element: HTMLElement;
+    /** Position among the steps of this run, and their count. */
+    index: number;
+    count: number;
+    /** A what's-new card, not a tour step. */
+    news: boolean;
+}
+export interface OnboardingState {
+    definition: OnboardingDefinition;
+    /** False until a user is known. */
+    enabled: ComputedRef<boolean>;
+    active: ShallowRef<OnboardingActiveStep | null>;
+    /** Tours that can run on the current route. */
+    tours: ComputedRef<OnboardingTour[]>;
+    /** The available tasks. */
+    tasks: ComputedRef<Array<Omit<OnboardingTask, 'done'> & {
+        done: boolean;
+    }>>;
+    tasksDone: ComputedRef<number>;
+    /** The checklist chip shows while a task is open and the user did not hide it. */
+    checklistVisible: ComputedRef<boolean>;
+    checklistHidden: ComputedRef<boolean>;
+    news: ComputedRef<Array<OnboardingNews & {
+        unseen: boolean;
+    }>>;
+    unseenNews: ComputedRef<number>;
+    startTour: (id: string) => void;
+    showNews: (id: string) => void;
+    next: () => void;
+    back: () => void;
+    /** End the run (× or Esc). Every step of the tour counts as seen. */
+    dismiss: () => void;
+    complete: (taskId: string) => void;
+    setChecklistHidden: (hidden: boolean) => void;
+    /** Run the task predicates again. */
+    refresh: () => void;
+}
+export declare const ONBOARDING_KEY: InjectionKey<OnboardingState>;
+/** Wait this long for the missing anchor of a run's first step, or of the step after a click step; then skip it. */
+export declare const ANCHOR_WAIT_MS = 2000;
+/** Types a definition, so it can live in its own file. */
+export declare function defineOnboarding(definition: OnboardingDefinition): OnboardingDefinition;
+/**
+ * Creates the app's onboarding coordinator and provides it to `AppTopBar`, which then
+ * shows the Help button, the checklist chip and the tour layer. Call it once, in the
+ * root component. It shows one item at a time and waits for open modals.
+ *
+ * ```ts
+ * provideOnboarding(onboarding, { appId: 'leaf' })
+ * ```
+ */
+export declare function provideOnboarding(definition: OnboardingDefinition, options: ProvideOnboardingOptions): OnboardingState;
+/** The app's onboarding coordinator, e.g. to call `complete(taskId)`. Null when the app provides none. */
+export declare function useOnboarding(): OnboardingState | null;

package/dist/composables/usePlatform.d.ts

@@ -24,6 +24,7 @@ export declare function usePlatform(): {
         route_prefix: string;
         api_prefix: string;
         settings_api: "plugin" | "platform";
+        subtitle?: string | undefined;
         description?: string | undefined;
         icon?: string | undefined;
         color?: string | undefined;

package/dist/{controlSchemaModel-CP5-_nAj.js → controlSchemaModel-Bsg0t5Ab.js}

@@ -1,4 +1,4 @@
-import { c as normalizeControlDefinition, p as omitUndefined } from "./useListReorder-CcbEYxX-.js";
+import { f as omitUndefined, s as normalizeControlDefinition } from "./useListReorder-DsuzwWGS.js";
 //#region src/composables/controlSchemaModel.ts
 function isControlModelBinding(model) {
 	return typeof model === "object" && model !== null && "controls" in model && "controlOptions" in model;
@@ -92,4 +92,4 @@ function registerSectionOptions(target, sectionId, options) {
 //#endregion
 export { isControlModelBinding as n, defineControlModel as t };
 
-//# sourceMappingURL=controlSchemaModel-CP5-_nAj.js.map
+//# sourceMappingURL=controlSchemaModel-Bsg0t5Ab.js.map

package/dist/{controlSchemaModel-CP5-_nAj.js.map → controlSchemaModel-Bsg0t5Ab.js.map}

@@ -1 +1 @@
-{"version":3,"file":"controlSchemaModel-CP5-_nAj.js","names":[],"sources":["../src/composables/controlSchemaModel.ts"],"sourcesContent":["import type {\n  ControlModel,\n  ControlModelBinding,\n  ControlModelSectionConfig,\n  ControlSchema,\n  ControlSectionConfig,\n  ControlSidebarConfig,\n  ControlViewConfig,\n  ControlWorkspaceOptions,\n} from './controlSchemaTypes'\nimport {\n  normalizeControlDefinition,\n} from './controlSchemaNormalize'\nimport {\n  omitUndefined,\n} from './controlSchemaUtils'\n\nexport function isControlModelBinding<TBinding extends ControlModelBinding = ControlModelBinding>(\n  model: unknown,\n): model is TBinding {\n  return (\n    typeof model === 'object'\n    && model !== null\n    && 'controls' in model\n    && 'controlOptions' in model\n  )\n}\n\nexport function resolveControlModel(\n  model: ControlModel | ControlModelBinding | undefined,\n): ControlModelBinding | undefined {\n  if (model === undefined) return undefined\n  return isControlModelBinding(model) ? model : defineControlModel(model)\n}\n\n/**\n * Create a complete control model binding for FormBuilder, SettingsModal and the PluginWorkspaceView sidebar from a simple controls data model.\n *\n * @example Recommended\n * ```ts\n * const workspaceModel = defineControlModel({\n *   controls: { threshold: { type: 'number', default: 0.05 } },\n * })\n * ```\n */\nexport function defineControlModel(model: ControlModel): ControlModelBinding {\n  const {\n    controls: rootControls,\n    sections: rootSections,\n    views: modelViews,\n    components,\n    componentBindings,\n    componentProps,\n    componentPropsById,\n    ...baseOptions\n  } = model\n  const resolvedComponentBindings = componentBindings ?? components\n  const controls: ControlSchema = {}\n  const views: Record<string, ControlViewConfig> = {}\n  const sections: Record<string, ControlSectionConfig> = {}\n\n  const defaultViewId = model.view ?? 'default'\n  const defaultSectionId = model.section ?? 'controls'\n\n  if (rootControls) {\n    registerSectionOptions(sections, defaultSectionId, {\n      id: defaultSectionId,\n      label: model.sectionLabel,\n      title: model.sectionLabel,\n      columns: model.columns,\n    })\n    appendModelControls(controls, rootControls, defaultViewId, defaultSectionId)\n  }\n\n  for (const [sectionId, section] of Object.entries(rootSections ?? {})) {\n    registerSectionOptions(sections, sectionId, controlModelSectionOptions(section))\n    appendModelControls(controls, section.controls, defaultViewId, sectionId, section.sidebar)\n  }\n\n  for (const [viewId, view] of Object.entries(modelViews ?? {})) {\n    const {\n      controls: viewControls,\n      sections: viewSections,\n      section,\n      sectionLabel,\n      sectionDescription,\n      ...viewConfig\n    } = view\n\n    views[viewId] = omitUndefined(viewConfig)\n\n    if (viewControls) {\n      const sectionId = section ?? `${viewId}-controls`\n      const label = sectionLabel ?? view.label\n      registerSectionOptions(sections, sectionId, {\n        id: sectionId,\n        label,\n        title: label,\n        description: sectionDescription,\n        columns: model.columns,\n      })\n      appendModelControls(controls, viewControls, viewId, sectionId)\n    }\n\n    for (const [sectionKey, sectionConfig] of Object.entries(viewSections ?? {})) {\n      const sectionId = sectionConfig.id ?? `${viewId}-${sectionKey}`\n      registerSectionOptions(sections, sectionId, controlModelSectionOptions(sectionConfig))\n      appendModelControls(controls, sectionConfig.controls, viewId, sectionId, sectionConfig.sidebar)\n    }\n  }\n\n  const controlOptions: ControlWorkspaceOptions = {\n    ...baseOptions,\n  }\n\n  if (Object.keys(views).length > 0) {\n    controlOptions.views = views\n  }\n\n  if (Object.keys(sections).length > 0) {\n    controlOptions.sections = sections\n  }\n\n  return {\n    controls,\n    controlOptions,\n    ...(resolvedComponentBindings === undefined ? {} : { componentBindings: resolvedComponentBindings }),\n    ...(componentProps === undefined ? {} : { componentProps }),\n    ...(componentPropsById === undefined ? {} : { componentPropsById }),\n  }\n}\n\nfunction appendModelControls(\n  target: ControlSchema,\n  source: ControlSchema,\n  viewId: string,\n  sectionId: string,\n  sidebar?: boolean | ControlSidebarConfig,\n): void {\n  for (const [name, input] of Object.entries(source)) {\n    if (Object.prototype.hasOwnProperty.call(target, name)) {\n      throw new Error(\n        `Duplicate control \"${name}\" in defineControlModel(). Control names must be unique across views and sections.`,\n      )\n    }\n\n    const definition = normalizeControlDefinition(input)\n    target[name] = omitUndefined({\n      ...definition,\n      view: definition.view ?? viewId,\n      section: definition.section ?? sectionId,\n      sidebar: definition.sidebar ?? sidebar,\n    })\n  }\n}\n\nfunction controlModelSectionOptions(section: ControlModelSectionConfig): ControlSectionConfig {\n  const { controls: _controls, sidebar: _sidebar, ...options } = section\n  return omitUndefined(options)\n}\n\nfunction registerSectionOptions(\n  target: Record<string, ControlSectionConfig>,\n  sectionId: string,\n  options: ControlSectionConfig,\n): void {\n  target[sectionId] = omitUndefined({\n    ...(target[sectionId] ?? {}),\n    ...options,\n    id: sectionId,\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"controlSchemaModel-Bsg0t5Ab.js","names":[],"sources":["../src/composables/controlSchemaModel.ts"],"sourcesContent":["import type {\n  ControlModel,\n  ControlModelBinding,\n  ControlModelSectionConfig,\n  ControlSchema,\n  ControlSectionConfig,\n  ControlSidebarConfig,\n  ControlViewConfig,\n  ControlWorkspaceOptions,\n} from './controlSchemaTypes'\nimport {\n  normalizeControlDefinition,\n} from './controlSchemaNormalize'\nimport {\n  omitUndefined,\n} from './controlSchemaUtils'\n\nexport function isControlModelBinding<TBinding extends ControlModelBinding = ControlModelBinding>(\n  model: unknown,\n): model is TBinding {\n  return (\n    typeof model === 'object'\n    && model !== null\n    && 'controls' in model\n    && 'controlOptions' in model\n  )\n}\n\nexport function resolveControlModel(\n  model: ControlModel | ControlModelBinding | undefined,\n): ControlModelBinding | undefined {\n  if (model === undefined) return undefined\n  return isControlModelBinding(model) ? model : defineControlModel(model)\n}\n\n/**\n * Create a complete control model binding for FormBuilder, SettingsModal and the PluginWorkspaceView sidebar from a simple controls data model.\n *\n * @example Recommended\n * ```ts\n * const workspaceModel = defineControlModel({\n *   controls: { threshold: { type: 'number', default: 0.05 } },\n * })\n * ```\n */\nexport function defineControlModel(model: ControlModel): ControlModelBinding {\n  const {\n    controls: rootControls,\n    sections: rootSections,\n    views: modelViews,\n    components,\n    componentBindings,\n    componentProps,\n    componentPropsById,\n    ...baseOptions\n  } = model\n  const resolvedComponentBindings = componentBindings ?? components\n  const controls: ControlSchema = {}\n  const views: Record<string, ControlViewConfig> = {}\n  const sections: Record<string, ControlSectionConfig> = {}\n\n  const defaultViewId = model.view ?? 'default'\n  const defaultSectionId = model.section ?? 'controls'\n\n  if (rootControls) {\n    registerSectionOptions(sections, defaultSectionId, {\n      id: defaultSectionId,\n      label: model.sectionLabel,\n      title: model.sectionLabel,\n      columns: model.columns,\n    })\n    appendModelControls(controls, rootControls, defaultViewId, defaultSectionId)\n  }\n\n  for (const [sectionId, section] of Object.entries(rootSections ?? {})) {\n    registerSectionOptions(sections, sectionId, controlModelSectionOptions(section))\n    appendModelControls(controls, section.controls, defaultViewId, sectionId, section.sidebar)\n  }\n\n  for (const [viewId, view] of Object.entries(modelViews ?? {})) {\n    const {\n      controls: viewControls,\n      sections: viewSections,\n      section,\n      sectionLabel,\n      sectionDescription,\n      ...viewConfig\n    } = view\n\n    views[viewId] = omitUndefined(viewConfig)\n\n    if (viewControls) {\n      const sectionId = section ?? `${viewId}-controls`\n      const label = sectionLabel ?? view.label\n      registerSectionOptions(sections, sectionId, {\n        id: sectionId,\n        label,\n        title: label,\n        description: sectionDescription,\n        columns: model.columns,\n      })\n      appendModelControls(controls, viewControls, viewId, sectionId)\n    }\n\n    for (const [sectionKey, sectionConfig] of Object.entries(viewSections ?? {})) {\n      const sectionId = sectionConfig.id ?? `${viewId}-${sectionKey}`\n      registerSectionOptions(sections, sectionId, controlModelSectionOptions(sectionConfig))\n      appendModelControls(controls, sectionConfig.controls, viewId, sectionId, sectionConfig.sidebar)\n    }\n  }\n\n  const controlOptions: ControlWorkspaceOptions = {\n    ...baseOptions,\n  }\n\n  if (Object.keys(views).length > 0) {\n    controlOptions.views = views\n  }\n\n  if (Object.keys(sections).length > 0) {\n    controlOptions.sections = sections\n  }\n\n  return {\n    controls,\n    controlOptions,\n    ...(resolvedComponentBindings === undefined ? {} : { componentBindings: resolvedComponentBindings }),\n    ...(componentProps === undefined ? {} : { componentProps }),\n    ...(componentPropsById === undefined ? {} : { componentPropsById }),\n  }\n}\n\nfunction appendModelControls(\n  target: ControlSchema,\n  source: ControlSchema,\n  viewId: string,\n  sectionId: string,\n  sidebar?: boolean | ControlSidebarConfig,\n): void {\n  for (const [name, input] of Object.entries(source)) {\n    if (Object.prototype.hasOwnProperty.call(target, name)) {\n      throw new Error(\n        `Duplicate control \"${name}\" in defineControlModel(). Control names must be unique across views and sections.`,\n      )\n    }\n\n    const definition = normalizeControlDefinition(input)\n    target[name] = omitUndefined({\n      ...definition,\n      view: definition.view ?? viewId,\n      section: definition.section ?? sectionId,\n      sidebar: definition.sidebar ?? sidebar,\n    })\n  }\n}\n\nfunction controlModelSectionOptions(section: ControlModelSectionConfig): ControlSectionConfig {\n  const { controls: _controls, sidebar: _sidebar, ...options } = section\n  return omitUndefined(options)\n}\n\nfunction registerSectionOptions(\n  target: Record<string, ControlSectionConfig>,\n  sectionId: string,\n  options: ControlSectionConfig,\n): void {\n  target[sectionId] = omitUndefined({\n    ...(target[sectionId] ?? {}),\n    ...options,\n    id: sectionId,\n  })\n}\n"],"mappings":"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"}