@morscherlab/mint-sdk 1.0.13 → 1.0.15

package/dist/composables/index.d.ts

@@ -31,6 +31,10 @@ export { useAppExperiment, APP_EXPERIMENT_KEY, type AppExperimentRecord, type Ap
 export { useExperimentSave, type UseExperimentSaveOptions, type UseExperimentSaveReturn, } from './useExperimentSave';
 export { useTemplateCollection, type TemplateCollectionInput, type UseTemplateCollectionOptions, type UseTemplateCollectionReturn, } from './useTemplateCollection';
 export { useRequestSyncState, type RequestSyncRunOptions, type RequestSyncSuccessKind, type UseRequestSyncStateReturn, } from './useRequestSyncState';
+export { useCommandHistory, type CommandHistoryCommand, type CommandHistoryExecuteOptions, type CommandHistoryResult, type UseCommandHistoryOptions, type UseCommandHistoryReturn, } from './useCommandHistory';
+export { useOptimisticMutation, type OptimisticMutationContext, type UseOptimisticMutationOptions, type UseOptimisticMutationReturn, } from './useOptimisticMutation';
+export { createPluginResourceClient, useResourceCrud, type PluginResourceClientOptions, type ResourceCrudAdapter, type ResourceKey, type UseResourceCrudOptions, type UseResourceCrudReturn, } from './useResourceCrud';
+export { detectDelimiter, parseDelimitedText, readFileAsText, useFileImport, validateImportFile, type DelimitedTable, type FileImportOptions, type FileImportValidationOptions, type ParseDelimitedTextOptions, type UseFileImportReturn, } from './useFileImport';
 export { useSelectionLimit, type SelectionLimitSource, type UseSelectionLimitOptions, type UseSelectionLimitReturn, } from './useSelectionLimit';
 export { useListSelection, type ListSelectionSource, type ListSelectionValue, type UseListSelectionOptions, type UseListSelectionReturn, type WidenListSelectionValue, } from './useListSelection';
 export { useGroupAssignment, type GroupAssignmentSource, type GroupAssignmentState, type GroupAssignmentZone, type UseGroupAssignmentOptions, type UseGroupAssignmentReturn, } from './useGroupAssignment';
@@ -38,6 +42,9 @@ export { useSampleGroups, type DisplaySampleSubGroup, type SampleGroupSource, ty
 export { useExpansionSet, type ExpansionSetSource, type UseExpansionSetOptions, type UseExpansionSetReturn, } from './useExpansionSet';
 export { compareSortValues, useSortedItems, type CompareSortValuesOptions, type SortComparator, type SortComparatorContext, type SortDescriptor, type SortedItemsSource, type SortOrder, type UseSortedItemsOptions, type UseSortedItemsReturn, } from './useSortedItems';
 export { candidateMatchesSearch, normalizeSearchQuery, useTextSearch, type TextSearchCandidate, type TextSearchSource, type UseTextSearchOptions, type UseTextSearchReturn, } from './useTextSearch';
+export { coordinateToWellId, useWellPainting, wellIdToCoordinate, wellIdsInRectangle, type UseWellPaintingOptions, type UseWellPaintingReturn, type WellCoordinate, type WellPaintResult, type WellPlateSource, } from './useWellPainting';
+export { createColumnConditions, createRowConditions, createWellPlateWells, useWellPlateAdapter, type AxisConditionEntry, type UseWellPlateAdapterReturn, type WellPlateAdapterOptions, type WellPlateAdapterSource, type WellPlateEntry, } from './useWellPlateAdapter';
+export { runWellPlateValidation, useWellPlateValidation, type UseWellPlateValidationOptions, type UseWellPlateValidationReturn, type WellPlateValidationRule, type WellPlateValidationSeverity, type WellPlateValidationSource, type WellPlateValidationWarning, } from './useWellPlateValidation';
 export { controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSidebarPanels, controlsToSettingsSchema, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, defineControlComponentBindings, defineControlModel, defineDoseDesignControlModel, defineDoseCalculatorControlProps, defineControls, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, getDefaultControlView, getControlDefaults, useControlSchema, useControlWorkspace, type ControlDefinition, type ControlComponentBinding, type ControlComponentBindingConfig, type ControlComponentBindingRecordConfig, type ControlComponentBindingsById, type ControlComponentBindingsConfig, type ControlComponentPropSource, type ControlComponentPropsByIdMap, type ControlComponentPropsMap, type DoseDesignControlModelOptions, type DoseCalculatorControlPropsOptions, type ControlFormSchema, type ControlInput, type ControlModel, type ControlModelBinding, type ControlModelSectionConfig, type ControlModelViewConfig, type ControlOption, type ControlOptionValue, type ControlPrimitive, type ControlSchema, type ControlSchemaOptions, type ControlShorthand, type ControlWorkspaceOptions, type ControlFormBinding, type ControlSettingsBinding, type ControlSidebarBinding, type ControlSectionConfig, type ControlSidebarConfig, type ControlTopBarSettingsBinding, type ControlViewConfig, type ControlValues, type UseControlSchemaReturn, type ControlWorkspaceAppTopBarPillBinding, type ControlWorkspaceComponentBindings, type ControlWorkspaceFormBinding, type ControlWorkspacePillNavBinding, type ControlWorkspaceSidebarBinding, type ControlWorkspaceTopBarBinding, type ControlWorkspaceTopBarSettingsBinding, type UseControlWorkspaceReturn, type WellPlateControlPropsOptions, type WellPlateDoseControlPropsOptions, } from './useControlSchema';
 export { getBioTemplateControlSchema, requireBioTemplateControlSchema, useBioTemplateControls, type BioTemplateControlSchema, type BioTemplateControlTarget, } from './useBioTemplateControls';
 export { getBioTemplateComponentProps, getBioTemplateComponentBindings, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, useBioTemplateComponents, type BioTemplateComponentBinding, type BioTemplateComponentBindingsById, type BioTemplateComponentPropsByComponent, type BioTemplateComponentPropsBinding, type BioTemplateComponentPropsById, type BioTemplateComponentPropsLookupOptions, type BioTemplateResolvedComponentBinding, type BioTemplateComponentTarget, type UseBioTemplateComponentsReturn, } from './useBioTemplateComponents';

package/dist/composables/index.js

@@ -6,5 +6,5 @@ import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as use
 import { a as SORT_OPTIONS, c as formatExperimentStatus, i as EXPERIMENT_STATUS_VARIANT_MAP, l as getExperimentStatusVariant, n as EXPERIMENT_STATUS_LABELS, o as datePresetToISO, r as EXPERIMENT_STATUS_OPTIONS, s as formatExperimentDate, t as DATE_PRESET_OPTIONS, u as resolveExperimentCode } from "../experiment-utils-D11yT3AR.js";
 import { i as useApi, n as useDebouncedWatch, r as useRequestSyncState, t as useExperimentSelector } from "../useExperimentSelector-BBaz0w51.js";
 import { B as toBioTemplateComponentProps, H as toBioTemplateComponentPropsById, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, R as toBioTemplateComponentBindingsById, l as requireBioTemplateControlSchema, o as getBioTemplateControlSchema } from "../templates-Do43ZIMb.js";
-import { a as pluginFormDataFromPayload, c as usePluginClient, d as resolvePluginBaseUrl, f as usePluginConfig, g as useAuth, h as usePasskey, i as getPluginPageSelectorItems, l as usePluginSettings, m as useAsyncBatch, n as downloadBlob, o as uploadPluginEndpoint, p as useAsync, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as buildPluginEndpointUrl } from "../composables-BuG5yAb7.js";
-export { APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildPluginEndpointUrl, candidateMatchesSearch, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, createPluginClient, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, downloadBlob, downloadPluginEndpoint, durationMinutes, evaluateCondition, extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getPluginPageSelectorItems, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseTime, pluginFormDataFromPayload, rangesOverlap, requireBioTemplateControlSchema, resolveExperimentCode, resolvePluginBaseUrl, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, unwrapExperimentDesignData, uploadPluginEndpoint, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSamples, useExperimentSave, useExperimentSelector, useForm, useFormBuilder, useGroupAssignment, useListSelection, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginSettings, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPlateEditor };
+import { A as useCommandHistory, C as parseDelimitedText, D as createPluginResourceClient, E as validateImportFile, F as useAuth, M as useAsync, N as useAsyncBatch, O as useResourceCrud, P as usePasskey, S as detectDelimiter, T as useFileImport, _ as useWellPlateAdapter, a as pluginFormDataFromPayload, b as wellIdToCoordinate, c as usePluginClient, d as resolvePluginBaseUrl, f as runWellPlateValidation, g as createWellPlateWells, h as createRowConditions, i as getPluginPageSelectorItems, j as usePluginConfig, k as useOptimisticMutation, l as usePluginSettings, m as createColumnConditions, n as downloadBlob, o as uploadPluginEndpoint, p as useWellPlateValidation, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as buildPluginEndpointUrl, v as coordinateToWellId, w as readFileAsText, x as wellIdsInRectangle, y as useWellPainting } from "../composables-D9mexHSW.js";
+export { APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildPluginEndpointUrl, candidateMatchesSearch, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, coordinateToWellId, createColumnConditions, createPluginClient, createPluginResourceClient, createRowConditions, createWellPlateWells, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, detectDelimiter, downloadBlob, downloadPluginEndpoint, durationMinutes, evaluateCondition, extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getPluginPageSelectorItems, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseDelimitedText, parseTime, pluginFormDataFromPayload, rangesOverlap, readFileAsText, requireBioTemplateControlSchema, resolveExperimentCode, resolvePluginBaseUrl, runWellPlateValidation, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, unwrapExperimentDesignData, uploadPluginEndpoint, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useCommandHistory, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSamples, useExperimentSave, useExperimentSelector, useFileImport, useForm, useFormBuilder, useGroupAssignment, useListSelection, useOptimisticMutation, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginSettings, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useResourceCrud, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPainting, useWellPlateAdapter, useWellPlateEditor, useWellPlateValidation, validateImportFile, wellIdToCoordinate, wellIdsInRectangle };

package/dist/composables/useCommandHistory.d.ts

@@ -0,0 +1,29 @@
+import { ComputedRef, Ref } from 'vue';
+export type CommandHistoryResult = void | Promise<void>;
+export interface CommandHistoryCommand {
+    execute: () => CommandHistoryResult;
+    undo: () => CommandHistoryResult;
+    redo?: () => CommandHistoryResult;
+    description?: string;
+}
+export interface CommandHistoryExecuteOptions {
+    skipExecute?: boolean;
+}
+export interface UseCommandHistoryOptions {
+    maxDepth?: number;
+}
+export interface UseCommandHistoryReturn<TCommand extends CommandHistoryCommand = CommandHistoryCommand> {
+    undoStack: Ref<TCommand[]>;
+    redoStack: Ref<TCommand[]>;
+    canUndo: ComputedRef<boolean>;
+    canRedo: ComputedRef<boolean>;
+    undoDescription: ComputedRef<string>;
+    redoDescription: ComputedRef<string>;
+    execute: (command: TCommand, options?: CommandHistoryExecuteOptions) => CommandHistoryResult;
+    push: (command: TCommand) => void;
+    undo: () => CommandHistoryResult;
+    redo: () => CommandHistoryResult;
+    clear: () => void;
+}
+/** Generic command-stack state for plugin editors with undo/redo controls. */
+export declare function useCommandHistory<TCommand extends CommandHistoryCommand = CommandHistoryCommand>(options?: UseCommandHistoryOptions): UseCommandHistoryReturn<TCommand>;

package/dist/composables/useFileImport.d.ts

@@ -0,0 +1,35 @@
+import { Ref, ShallowRef } from 'vue';
+export interface DelimitedTable {
+    columns: string[];
+    rows: Record<string, string>[];
+    rawRows: string[][];
+    delimiter: string;
+}
+export interface ParseDelimitedTextOptions {
+    delimiter?: string;
+    headers?: readonly string[];
+    hasHeaderRow?: boolean;
+    trim?: boolean;
+}
+export interface FileImportValidationOptions {
+    accept?: string | readonly string[];
+    maxSizeBytes?: number;
+}
+export interface FileImportOptions<TResult = string> extends FileImportValidationOptions {
+    encoding?: string;
+    parse?: (text: string, file: File) => TResult | Promise<TResult>;
+}
+export interface UseFileImportReturn<TResult> {
+    loading: ShallowRef<boolean>;
+    error: Ref<string | null>;
+    fileName: Ref<string>;
+    result: Ref<TResult | null>;
+    importFile: (file: File) => Promise<TResult>;
+    clear: () => void;
+}
+/** Stateful file reader for plugin import flows with shared validation and error handling. */
+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>;
+export declare function parseDelimitedText(text: string, options?: ParseDelimitedTextOptions): DelimitedTable;
+export declare function detectDelimiter(text: string): string;

package/dist/composables/useOptimisticMutation.d.ts

@@ -0,0 +1,28 @@
+import { ComputedRef, Ref, ShallowRef } from 'vue';
+export interface OptimisticMutationContext<TVariables, TSnapshot> {
+    variables: TVariables;
+    snapshot: TSnapshot | undefined;
+}
+export interface UseOptimisticMutationOptions<TVariables, TData, TSnapshot = unknown> {
+    mutation: (variables: TVariables) => Promise<TData>;
+    snapshot?: (variables: TVariables) => TSnapshot;
+    apply?: (variables: TVariables, snapshot: TSnapshot | undefined) => void;
+    commit?: (data: TData, context: OptimisticMutationContext<TVariables, TSnapshot>) => void;
+    rollback?: (snapshot: TSnapshot | undefined, variables: TVariables, error: unknown) => void;
+    onSuccess?: (data: TData, context: OptimisticMutationContext<TVariables, TSnapshot>) => void;
+    onError?: (error: unknown, context: OptimisticMutationContext<TVariables, TSnapshot>) => void;
+    onSettled?: (context: OptimisticMutationContext<TVariables, TSnapshot>) => void;
+    readErrorMessage?: (error: unknown) => string;
+}
+export interface UseOptimisticMutationReturn<TVariables, TData, TSnapshot = unknown> {
+    loading: ShallowRef<boolean>;
+    error: Ref<string | null>;
+    data: Ref<TData | null>;
+    lastSnapshot: Ref<TSnapshot | undefined>;
+    isIdle: ComputedRef<boolean>;
+    run: (variables: TVariables) => Promise<TData>;
+    clearError: () => void;
+    reset: () => void;
+}
+/** Run async mutations with optional optimistic local updates and rollback. */
+export declare function useOptimisticMutation<TVariables, TData, TSnapshot = unknown>(options: UseOptimisticMutationOptions<TVariables, TData, TSnapshot>): UseOptimisticMutationReturn<TVariables, TData, TSnapshot>;

package/dist/composables/useResourceCrud.d.ts

@@ -0,0 +1,40 @@
+import { ComputedRef, Ref, ShallowRef } from 'vue';
+export type ResourceKey = string | number;
+export interface ResourceCrudAdapter<TItem, TCreate = Partial<TItem>, TUpdate = Partial<TItem>, TKey extends ResourceKey = ResourceKey> {
+    list: () => Promise<TItem[]>;
+    create?: (payload: TCreate) => Promise<TItem>;
+    update?: (key: TKey, payload: TUpdate) => Promise<TItem>;
+    remove?: (key: TKey) => Promise<void>;
+}
+export interface UseResourceCrudOptions<TItem, TCreate = Partial<TItem>, TUpdate = Partial<TItem>, TKey extends ResourceKey = ResourceKey> {
+    adapter: ResourceCrudAdapter<TItem, TCreate, TUpdate, TKey>;
+    initialItems?: readonly TItem[];
+    getKey?: (item: TItem) => TKey;
+    readErrorMessage?: (error: unknown) => string;
+}
+export interface UseResourceCrudReturn<TItem, TCreate, TUpdate, TKey extends ResourceKey> {
+    items: Ref<TItem[]>;
+    loading: ShallowRef<boolean>;
+    saving: ShallowRef<boolean>;
+    deleting: ShallowRef<boolean>;
+    error: Ref<string | null>;
+    isBusy: ComputedRef<boolean>;
+    load: () => Promise<TItem[]>;
+    createItem: (payload: TCreate) => Promise<TItem>;
+    updateItem: (key: TKey, payload: TUpdate) => Promise<TItem>;
+    deleteItem: (keyOrItem: TKey | TItem) => Promise<void>;
+    setItems: (items: readonly TItem[]) => void;
+    upsertLocal: (item: TItem) => void;
+    removeLocal: (keyOrItem: TKey | TItem) => void;
+    clearError: () => void;
+}
+/** Common list/create/update/delete state wrapper for generated plugin clients. */
+export declare function useResourceCrud<TItem, TCreate = Partial<TItem>, TUpdate = Partial<TItem>, TKey extends ResourceKey = ResourceKey>(options: UseResourceCrudOptions<TItem, TCreate, TUpdate, TKey>): UseResourceCrudReturn<TItem, TCreate, TUpdate, TKey>;
+export interface PluginResourceClientOptions<TClient, TItem, TCreate = Partial<TItem>, TUpdate = Partial<TItem>, TKey extends ResourceKey = ResourceKey> {
+    client: TClient;
+    list: (client: TClient) => Promise<TItem[]>;
+    create?: (client: TClient, payload: TCreate) => Promise<TItem>;
+    update?: (client: TClient, key: TKey, payload: TUpdate) => Promise<TItem>;
+    remove?: (client: TClient, key: TKey) => Promise<void>;
+}
+export declare function createPluginResourceClient<TClient, TItem, TCreate = Partial<TItem>, TUpdate = Partial<TItem>, TKey extends ResourceKey = ResourceKey>(options: PluginResourceClientOptions<TClient, TItem, TCreate, TUpdate, TKey>): ResourceCrudAdapter<TItem, TCreate, TUpdate, TKey>;

package/dist/composables/useWellPainting.d.ts

@@ -0,0 +1,35 @@
+import { ComputedRef, Ref } from 'vue';
+import { WellPlateFormat } from '../types';
+export type WellPlateSource<T> = T | Ref<T> | ComputedRef<T> | (() => T);
+export interface WellCoordinate {
+    row: number;
+    col: number;
+}
+export interface WellPaintResult<TMode extends string = string, TPayload = unknown> {
+    wellIds: string[];
+    mode: TMode;
+    payload?: TPayload;
+}
+export interface UseWellPaintingOptions<TMode extends string = string, TPayload = unknown> {
+    format: WellPlateSource<WellPlateFormat>;
+    initialMode?: TMode;
+    initialPayload?: TPayload;
+    onComplete?: (result: WellPaintResult<TMode, TPayload>) => void;
+}
+export interface UseWellPaintingReturn<TMode extends string = string, TPayload = unknown> {
+    activeMode: Ref<TMode>;
+    activePayload: Ref<TPayload | undefined>;
+    isDragging: Ref<boolean>;
+    previewWellIds: ComputedRef<string[]>;
+    setMode: (mode: TMode, payload?: TPayload) => void;
+    setPayload: (payload: TPayload | undefined) => void;
+    onWellMouseDown: (wellId: string) => void;
+    onWellMouseMove: (wellId: string) => void;
+    onWellMouseUp: () => void;
+    cancel: () => void;
+}
+/** Pointer painting/rectangle selection state for WellPlate-based editors. */
+export declare function useWellPainting<TMode extends string = string, TPayload = unknown>(options: UseWellPaintingOptions<TMode, TPayload>): UseWellPaintingReturn<TMode, TPayload>;
+export declare function wellIdToCoordinate(wellId: string): WellCoordinate | null;
+export declare function coordinateToWellId(coord: WellCoordinate): string;
+export declare function wellIdsInRectangle(start: WellCoordinate, end: WellCoordinate, format: WellPlateFormat): string[];

package/dist/composables/useWellPlateAdapter.d.ts

@@ -0,0 +1,36 @@
+import { ComputedRef, Ref } from 'vue';
+import { ColumnCondition, RowCondition, Well } from '../types';
+export type WellPlateAdapterSource<T> = T | Ref<T> | ComputedRef<T> | (() => T);
+export interface WellPlateEntry {
+    wellId: string;
+    state?: Well['state'];
+    sampleType?: string;
+    value?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface WellPlateAdapterOptions<TEntry> {
+    entries: WellPlateAdapterSource<readonly TEntry[]>;
+    getWellId: (entry: TEntry) => string;
+    getState?: (entry: TEntry) => Well['state'] | undefined;
+    getSampleType?: (entry: TEntry) => string | undefined;
+    getValue?: (entry: TEntry) => number | undefined;
+    getMetadata?: (entry: TEntry) => Record<string, unknown> | undefined;
+}
+export interface UseWellPlateAdapterReturn {
+    wells: ComputedRef<Record<string, Partial<Well>>>;
+}
+/** Convert domain rows into WellPlate's wells prop without hand-written adapters. */
+export declare function useWellPlateAdapter<TEntry>(options: WellPlateAdapterOptions<TEntry>): UseWellPlateAdapterReturn;
+export declare function createWellPlateWells<TEntry>(entries: readonly TEntry[], options: Omit<WellPlateAdapterOptions<TEntry>, 'entries'>): Record<string, Partial<Well>>;
+export interface AxisConditionEntry {
+    label: string;
+    color: string;
+    start: string | number;
+    concentrations: readonly {
+        value: number;
+        replicates?: number;
+    }[];
+    unit?: string;
+}
+export declare function createColumnConditions(entries: readonly AxisConditionEntry[]): ColumnCondition[];
+export declare function createRowConditions(entries: readonly AxisConditionEntry[]): RowCondition[];

package/dist/composables/useWellPlateValidation.d.ts

@@ -0,0 +1,27 @@
+import { ComputedRef, Ref } from 'vue';
+export type WellPlateValidationSeverity = 'error' | 'warning' | 'info';
+export interface WellPlateValidationWarning<TType extends string = string> {
+    type: TType;
+    severity: WellPlateValidationSeverity;
+    message: string;
+    affectedWells?: string[];
+}
+export interface WellPlateValidationRule<TContext, TType extends string = string> {
+    type: TType;
+    severity: WellPlateValidationSeverity;
+    validate: (context: TContext) => false | string | Omit<WellPlateValidationWarning<TType>, 'type' | 'severity'>;
+}
+export type WellPlateValidationSource<T> = T | Ref<T> | ComputedRef<T> | (() => T);
+export interface UseWellPlateValidationOptions<TContext, TType extends string = string> {
+    context: WellPlateValidationSource<TContext>;
+    rules: WellPlateValidationSource<readonly WellPlateValidationRule<TContext, TType>[]>;
+}
+export interface UseWellPlateValidationReturn<TType extends string = string> {
+    warnings: ComputedRef<WellPlateValidationWarning<TType>[]>;
+    hasBlockingIssues: ComputedRef<boolean>;
+    warningCount: ComputedRef<number>;
+    errorCount: ComputedRef<number>;
+}
+/** Rule-driven validation state for WellPlate layout/design screens. */
+export declare function useWellPlateValidation<TContext, TType extends string = string>(options: UseWellPlateValidationOptions<TContext, TType>): UseWellPlateValidationReturn<TType>;
+export declare function runWellPlateValidation<TContext, TType extends string = string>(context: TContext, rules: readonly WellPlateValidationRule<TContext, TType>[]): WellPlateValidationWarning<TType>[];