@morscherlab/mint-sdk 1.0.13 → 1.0.15

package/src/composables/useWellPlateValidation.ts

@@ -0,0 +1,85 @@
+import { computed, toValue, type ComputedRef, type 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 function useWellPlateValidation<TContext, TType extends string = string>(
+  options: UseWellPlateValidationOptions<TContext, TType>,
+): UseWellPlateValidationReturn<TType> {
+  const warnings = computed(() => runWellPlateValidation(
+    toValue(options.context),
+    toValue(options.rules),
+  ))
+  const hasBlockingIssues = computed(() => warnings.value.some(warning => warning.severity === 'error'))
+  const warningCount = computed(() => warnings.value.length)
+  const errorCount = computed(() => warnings.value.filter(warning => warning.severity === 'error').length)
+
+  return {
+    warnings,
+    hasBlockingIssues,
+    warningCount,
+    errorCount,
+  }
+}
+
+export function runWellPlateValidation<TContext, TType extends string = string>(
+  context: TContext,
+  rules: readonly WellPlateValidationRule<TContext, TType>[],
+): WellPlateValidationWarning<TType>[] {
+  const warnings: WellPlateValidationWarning<TType>[] = []
+  for (const rule of rules) {
+    const result = rule.validate(context)
+    if (!result) continue
+    warnings.push(normalizeWarning(rule, result))
+  }
+  return warnings
+}
+
+function normalizeWarning<TContext, TType extends string>(
+  rule: WellPlateValidationRule<TContext, TType>,
+  result: string | Omit<WellPlateValidationWarning<TType>, 'type' | 'severity'>,
+): WellPlateValidationWarning<TType> {
+  if (typeof result === 'string') {
+    return {
+      type: rule.type,
+      severity: rule.severity,
+      message: result,
+    }
+  }
+  return {
+    type: rule.type,
+    severity: rule.severity,
+    ...result,
+  }
+}