@planet-matrix/mobius-model 0.6.0 → 0.9.0

package/src/form/inputor-controller/boolean.ts

@@ -0,0 +1,39 @@
+import type { BaseInputorContext, BaseInputorControllerOptions, BaseInputorSchema } from "./base.ts"
+import { BaseInputorController } from "./base.ts"
+
+export const BOOLEAN_INPUTOR_TYPE_NAME = "boolean" as const
+export type BooleanInputorTypeName = typeof BOOLEAN_INPUTOR_TYPE_NAME
+
+export type BooleanInputorExternalValue = boolean | undefined
+export type BooleanInputorInternalValue = boolean | undefined
+export interface BooleanInputorSchema extends BaseInputorSchema<BooleanInputorExternalValue> {
+  inputorTypeName: BooleanInputorTypeName
+}
+export interface BooleanInputorContext extends BaseInputorContext<BooleanInputorExternalValue, BooleanInputorInternalValue> {
+}
+
+export interface BooleanInputorControllerOptions extends BaseInputorControllerOptions<
+  BooleanInputorExternalValue,
+  BooleanInputorSchema
+> {
+}
+export class BooleanInputorController extends BaseInputorController<
+  BooleanInputorExternalValue,
+  BooleanInputorInternalValue,
+  BooleanInputorSchema,
+  BooleanInputorContext
+> {
+  declare schemaType: BooleanInputorSchema
+  declare optionsType: BooleanInputorControllerOptions
+  declare constructorType: typeof BooleanInputorController
+
+  static inputorTypeName: BooleanInputorTypeName = BOOLEAN_INPUTOR_TYPE_NAME
+
+  inputorTypeName: BooleanInputorTypeName = BOOLEAN_INPUTOR_TYPE_NAME
+  voidExternalValue = undefined
+  voidInternalValue = undefined
+
+  constructor(options: BooleanInputorControllerOptions) {
+    super(options)
+  }
+}

package/src/form/inputor-controller/file.ts

@@ -0,0 +1,39 @@
+import type { BaseInputorContext, BaseInputorControllerOptions, BaseInputorSchema } from "./base.ts"
+import { BaseInputorController } from "./base.ts"
+
+export const FILE_INPUTOR_TYPE_NAME = "file" as const
+export type FileInputorTypeName = typeof FILE_INPUTOR_TYPE_NAME
+
+export type FileInputorExternalValue = File | undefined
+export type FileInputorInternalValue = File | undefined
+export interface FileInputorSchema extends BaseInputorSchema<FileInputorExternalValue> {
+  inputorTypeName: FileInputorTypeName
+}
+export interface FileInputorContext extends BaseInputorContext<FileInputorExternalValue, FileInputorInternalValue> {
+}
+
+export interface FileInputorControllerOptions extends BaseInputorControllerOptions<
+  FileInputorExternalValue,
+  FileInputorSchema
+> {
+}
+export class FileInputorController extends BaseInputorController<
+  FileInputorExternalValue,
+  FileInputorInternalValue,
+  FileInputorSchema,
+  FileInputorContext
+> {
+  declare schemaType: FileInputorSchema
+  declare optionsType: FileInputorControllerOptions
+  declare constructorType: typeof FileInputorController
+
+  static inputorTypeName: FileInputorTypeName = FILE_INPUTOR_TYPE_NAME
+
+  inputorTypeName: FileInputorTypeName = FILE_INPUTOR_TYPE_NAME
+  voidExternalValue = undefined
+  voidInternalValue = undefined
+
+  constructor(options: FileInputorControllerOptions) {
+    super(options)
+  }
+}

package/src/form/inputor-controller/form.ts

@@ -0,0 +1,181 @@
+import type { BaseInputorContext, BaseInputorControllerOptions, BaseInputorSchema, InputorControllerInitializeHooks } from "./base.ts"
+import { BaseInputorController } from "./base.ts"
+
+import type * as Boolean from "./boolean.ts"
+import type * as Number from "./number.ts"
+import type * as Text from "./text.ts"
+import type * as File from "./file.ts"
+import type * as Select from "./select.ts"
+import type * as MultiSelect from "./multi-select.ts"
+
+interface InternalInputorControllerDict {
+  [FormInputorController.inputorTypeName]: FormInputorController
+  [Boolean.BooleanInputorController.inputorTypeName]: Boolean.BooleanInputorController
+  [Number.NumberInputorController.inputorTypeName]: Number.NumberInputorController
+  [Text.TextInputorController.inputorTypeName]: Text.TextInputorController
+  [File.FileInputorController.inputorTypeName]: File.FileInputorController
+  [Select.SelectInputorController.inputorTypeName]: Select.SelectInputorController
+  [MultiSelect.MultiSelectInputorController.inputorTypeName]: MultiSelect.MultiSelectInputorController
+  // Year
+  // Month
+  // Day
+  // Hour
+  // Minute
+  // Second
+  // Week
+  // Time
+  // TimeRange
+  // Url
+  // Color
+}
+type InternalInputorControllerUnion = InternalInputorControllerDict[keyof InternalInputorControllerDict]
+
+// 下面是 Form Inputor Controller 的实现
+
+export const FORM_INPUTOR_TYPE_NAME = "form" as const
+export type FormInputorTypeName = typeof FORM_INPUTOR_TYPE_NAME
+
+export type FormInputorInternalValue = Record<string, unknown> | undefined
+export interface FormInputorSchema<ExternalValue = unknown> extends BaseInputorSchema<ExternalValue> {
+  inputorTypeName: FormInputorTypeName
+}
+export interface FormInputorContext<ExternalValue = unknown, InternalValue = unknown> extends BaseInputorContext<ExternalValue, InternalValue> {
+}
+
+export type FormInputorControllerItems = Record<string, InternalInputorControllerUnion>
+type GetSchema<Item extends InternalInputorControllerUnion> = Item["schemaType"]
+type GetSchemaDict<Items extends FormInputorControllerItems> = {
+  [Key in keyof Items]: GetSchema<Items[Key]>
+}
+// type GetSchemaUnion<Items extends InputorControllerItems> = GetSchemaDict<Items>[keyof GetSchemaDict<Items>]
+type GetValue<Item extends InternalInputorControllerUnion> = GetSchema<Item>["value"]
+type GetValueDict<Items extends FormInputorControllerItems> = {
+  [Key in keyof Items]: GetValue<Items[Key]>
+}
+type GetValueUnion<Items extends FormInputorControllerItems> = GetValueDict<Items>[keyof GetValueDict<Items>]
+type GeneralUpdateValue<Items extends FormInputorControllerItems> = (value: GetValueUnion<Items>) => Promise<void>
+
+export interface FormInputorControllerOptions<
+  // NOTE: use any to avoid contravariance error
+  // oxlint-disable-next-line typescript/no-explicit-any
+  ExternalValue = any,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Items extends FormInputorControllerItems = any,
+> extends BaseInputorControllerOptions<ExternalValue, FormInputorSchema<ExternalValue>> {
+  voidExternalValue?: ExternalValue
+  items: Items
+  encodeValue: (schemaDict: GetSchemaDict<Items>) => ExternalValue
+  decodeValue: (value: ExternalValue) => GetValueDict<Items>
+}
+
+const VOID_EXTERNAL_VALUE = Symbol("voidExternalValue")
+
+export class FormInputorController<
+  // ! Use `any` to avoid contravariance error
+  // oxlint-disable-next-line typescript/no-explicit-any
+  ExternalValue = any,
+  // ! Use `any` to avoid circular reference error
+  // ! Use `any` to avoid contravariance error
+  // oxlint-disable-next-line typescript/no-explicit-any
+  Items extends FormInputorControllerItems = any,
+> extends BaseInputorController<
+  ExternalValue,
+  FormInputorInternalValue,
+  FormInputorSchema<ExternalValue>,
+  FormInputorContext<ExternalValue, FormInputorInternalValue>
+> {
+  declare schemaType: FormInputorSchema<ExternalValue>
+  declare optionsType: FormInputorControllerOptions<ExternalValue, Items>
+  declare constructorType: typeof FormInputorController<ExternalValue, Items>
+
+  static inputorTypeName: FormInputorTypeName = FORM_INPUTOR_TYPE_NAME
+
+  inputorTypeName: FormInputorTypeName = FORM_INPUTOR_TYPE_NAME
+  voidExternalValue!: ExternalValue
+  voidInternalValue = undefined
+
+  protected items!: Record<string, InternalInputorControllerUnion>
+  protected encodeValue!: FormInputorControllerOptions<ExternalValue, Items>["encodeValue"]
+  protected decodeValue!: FormInputorControllerOptions<ExternalValue, Items>["decodeValue"]
+
+  constructor(options: FormInputorControllerOptions<ExternalValue, Items>) {
+    super(options)
+  }
+
+  protected override async initialize(
+    options: FormInputorControllerOptions<ExternalValue, Items>,
+    hooks?: InputorControllerInitializeHooks,
+  ): Promise<void> {
+    await super.initialize(options, {
+      ...hooks,
+      onSchemaReady: async () => {
+        if ("voidExternalValue" in options) {
+          this.voidExternalValue = options.voidExternalValue
+        }
+        else {
+          // oxlint-disable-next-line typescript/no-unsafe-type-assertion
+          this.voidExternalValue = VOID_EXTERNAL_VALUE as unknown as ExternalValue
+        }
+        this.items = options.items
+        this.encodeValue = options.encodeValue
+        this.decodeValue = options.decodeValue
+        this.subscribeItemSchemaChange()
+        await hooks?.onSchemaReady?.()
+      },
+    })
+  }
+
+  /**
+   * 订阅所有子 Inputor 的 Schema，当子 Inputor 的 Schema 发生变化时，更新自己。
+   *  1. 当子项 value 发生变化时，更新自己的 value；
+   *  2. 待遇到实际情况再补充……
+   */
+  protected subscribeItemSchemaChange(): void {
+    Object.values(this.items).forEach((item) => {
+      item.subscribeSchemaChange(() => {
+        void this.updateValueFromItems()
+      })
+    })
+  }
+
+  protected async getSchemaDict(): Promise<GetSchemaDict<Items>> {
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion
+    const schemaDict = {} as GetSchemaDict<Items>
+    await Promise.all(Object.entries(this.items).map(async ([key, item]) => {
+      Object.assign(schemaDict, {
+        [key]: await item.getSchema(),
+      })
+    }))
+    return schemaDict
+  }
+
+  protected async updateValueFromItems(): Promise<void> {
+    const schemaDict = await this.getSchemaDict()
+    const value = this.encodeValue(schemaDict)
+    await this.updateValue(value)
+  }
+
+  protected override async isVoidExternalValue(value: ExternalValue): Promise<boolean> {
+    if (this.voidExternalValue === VOID_EXTERNAL_VALUE && value === VOID_EXTERNAL_VALUE) {
+      return true
+    }
+    else {
+      return await super.isVoidExternalValue(value)
+    }
+  }
+
+  /**
+   * 在更新自己之前会先更新所有子 Inputor。
+   */
+  override async updateValue(value: ExternalValue): Promise<void> {
+    await this.updateItemsFromValue(value)
+    await super.updateValue(value)
+  }
+
+  protected async updateItemsFromValue(value: ExternalValue): Promise<void> {
+    const valueDict = this.decodeValue(value)
+    await Promise.all(Object.entries(this.items).map(async ([key, item]) => {
+      await (item.updateValue as GeneralUpdateValue<Items>)(valueDict[key])
+    }))
+  }
+}

package/src/form/inputor-controller/helper.ts

@@ -0,0 +1,117 @@
+import * as Boolean from "./boolean.ts"
+import * as Number from "./number.ts"
+import * as Text from "./text.ts"
+import * as File from "./file.ts"
+import * as Select from "./select.ts"
+import * as MultiSelect from "./multi-select.ts"
+import * as Form from "./form.ts"
+
+interface InternalInputorControllerDict {
+  [Form.FormInputorController.inputorTypeName]: Form.FormInputorController
+  [Boolean.BooleanInputorController.inputorTypeName]: Boolean.BooleanInputorController
+  [Number.NumberInputorController.inputorTypeName]: Number.NumberInputorController
+  [Text.TextInputorController.inputorTypeName]: Text.TextInputorController
+  [File.FileInputorController.inputorTypeName]: File.FileInputorController
+  [Select.SelectInputorController.inputorTypeName]: Select.SelectInputorController
+  [MultiSelect.MultiSelectInputorController.inputorTypeName]: MultiSelect.MultiSelectInputorController
+  // Year
+  // Month
+  // Day
+  // Hour
+  // Minute
+  // Second
+  // Week
+  // Time
+  // TimeRange
+  // Url
+  // Color
+}
+export type InputorControllerUnion = InternalInputorControllerDict[keyof InternalInputorControllerDict]
+
+export type InputorSchemaUnion = InputorControllerUnion["schemaType"]
+export type InputorControllerOptionsUnion = InputorControllerUnion["optionsType"]
+export type InputorControllerConstructorUnion = InputorControllerUnion["constructorType"]
+
+export type GeneralUpdateSchema<Controller extends InputorControllerUnion> = (
+  schema: Controller["schemaType"],
+) => Promise<void>
+export type GeneralUpdateValue<Controller extends InputorControllerUnion> = (
+  value: Controller["schemaType"]["value"],
+) => Promise<void>
+
+export interface SupportInputor<Controller extends InputorControllerUnion> {
+  controller?: Controller | undefined
+  controllerOptions?: Controller["optionsType"] | undefined
+}
+
+export interface SupportBoolean {
+  controller?: Boolean.BooleanInputorController | undefined
+  controllerOptions?: Boolean.BooleanInputorControllerOptions | undefined
+}
+export const boolean = (
+  options: Boolean.BooleanInputorControllerOptions,
+): Boolean.BooleanInputorController => {
+  return new Boolean.BooleanInputorController(options)
+}
+
+export interface SupportNumber {
+  controller?: Number.NumberInputorController | undefined
+  controllerOptions?: Number.NumberInputorControllerOptions | undefined
+}
+export const number = (
+  options: Number.NumberInputorControllerOptions,
+): Number.NumberInputorController => {
+  return new Number.NumberInputorController(options)
+}
+
+export interface SupportText {
+  controller?: Text.TextInputorController | undefined
+  controllerOptions?: Text.TextInputorControllerOptions | undefined
+}
+export const text = (
+  options: Text.TextInputorControllerOptions,
+): Text.TextInputorController => {
+  return new Text.TextInputorController(options)
+}
+
+export interface SupportFile {
+  controller?: File.FileInputorController | undefined
+  controllerOptions?: File.FileInputorControllerOptions | undefined
+}
+export const file = (
+  options: File.FileInputorControllerOptions,
+): File.FileInputorController => {
+  return new File.FileInputorController(options)
+}
+
+export interface SupportSelect<Value> {
+  controller?: Select.SelectInputorController<Value> | undefined
+  controllerOptions?: Select.SelectInputorControllerOptions<Value> | undefined
+}
+export const select = <Value = unknown>(
+  options: Select.SelectInputorControllerOptions<Value>,
+): Select.SelectInputorController<Value> => {
+  return new Select.SelectInputorController(options)
+}
+
+export interface SupportMultiSelect<Value> {
+  controller?: MultiSelect.MultiSelectInputorController<Value> | undefined
+  controllerOptions?: MultiSelect.MultiSelectInputorControllerOptions<Value> | undefined
+}
+export const multiSelect = <Value = unknown>(
+  options: MultiSelect.MultiSelectInputorControllerOptions<Value>,
+): MultiSelect.MultiSelectInputorController<Value> => {
+  return new MultiSelect.MultiSelectInputorController(options)
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export interface SupportForm<ExternalValue = any, Items extends Form.FormInputorControllerItems = any> {
+  controller?: Form.FormInputorController<ExternalValue, Items> | undefined
+  controllerOptions?: Form.FormInputorControllerOptions<ExternalValue, Items> | undefined
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const form = <ExternalValue = any, Items extends Form.FormInputorControllerItems = any>(
+  options: Form.FormInputorControllerOptions<ExternalValue, Items>,
+): Form.FormInputorController<ExternalValue, Items> => {
+  return new Form.FormInputorController(options)
+}

package/src/form/inputor-controller/index.ts

@@ -0,0 +1,17 @@
+/**
+ * 关于 Inputor：
+ *   1. Inputor 的定位是输入的原子，所有输入都可以由 Inputor 组合而成。
+ *   2. 为了方便，Inputor 之间不必互不依赖或互不重合。
+ *   3. 可以借助 Inputor 快速实现输入组件，将对应的 Inputor 作为组件的核心逻辑即可。
+ */
+
+export * from "./base.ts"
+export * from "./boolean.ts"
+export * from "./number.ts"
+export * from "./text.ts"
+export * from "./file.ts"
+export * from "./select.ts"
+export * from "./multi-select.ts"
+export * from "./form.ts"
+
+export * from "./helper.ts"

package/src/form/inputor-controller/multi-select.ts

@@ -0,0 +1,99 @@
+// oxlint-disable typescript/no-explicit-any
+
+import type { BaseInputorContext, BaseInputorControllerOptions, BaseInputorSchema, InputorControllerInitializeHooks } from "./base.ts"
+import { BaseInputorController } from "./base.ts"
+
+export const MULTI_SELECT_INPUTOR_TYPE_NAME = "multi-select" as const
+export type MultiSelectInputorTypeName = typeof MULTI_SELECT_INPUTOR_TYPE_NAME
+
+export interface MultiSelectOption<Value = any> {
+  name: string
+  label: string
+  value: Value
+  isSelected: boolean
+  description?: string | undefined
+  isDisabled?: boolean | undefined
+}
+export type MultiSelectOptions<Value = any> = Array<MultiSelectOption<Value>>
+export type MultiSelectInputorExternalValue<Value = any> = MultiSelectOptions<Value>
+export type MultiSelectInputorInternalValue<Value = any> = MultiSelectOptions<Value>
+export interface MultiSelectInputorSchema<Value = any> extends BaseInputorSchema<MultiSelectInputorExternalValue<Value>> {
+  inputorTypeName: MultiSelectInputorTypeName
+}
+export interface MultiSelectInputorContext<Value = any> extends BaseInputorContext<MultiSelectInputorExternalValue<Value>, MultiSelectInputorInternalValue<Value>> {
+}
+
+export interface MultiSelectInputorControllerOptions<Value = any> extends BaseInputorControllerOptions<
+  MultiSelectInputorExternalValue<Value>,
+  MultiSelectInputorSchema<Value>
+> {
+  minSelectCount?: number | undefined
+  maxSelectCount?: number | undefined
+}
+export class MultiSelectInputorController<Value = any> extends BaseInputorController<
+  MultiSelectInputorExternalValue<Value>,
+  MultiSelectInputorInternalValue<Value>,
+  MultiSelectInputorSchema<Value>,
+  MultiSelectInputorContext<Value>
+> {
+  declare schemaType: MultiSelectInputorSchema<Value>
+  declare optionsType: MultiSelectInputorControllerOptions<Value>
+  declare constructorType: typeof MultiSelectInputorController<Value>
+
+  static inputorTypeName: MultiSelectInputorTypeName = MULTI_SELECT_INPUTOR_TYPE_NAME
+
+  inputorTypeName: MultiSelectInputorTypeName = MULTI_SELECT_INPUTOR_TYPE_NAME
+  voidExternalValue = [] as MultiSelectInputorExternalValue<Value>
+  voidInternalValue = [] as MultiSelectInputorInternalValue<Value>
+
+  private minSelectCount!: number
+  private maxSelectCount!: number
+
+  constructor(options: MultiSelectInputorControllerOptions<Value>) {
+    super(options)
+  }
+
+  protected override async initialize(
+    options: MultiSelectInputorControllerOptions<Value>,
+    hooks?: InputorControllerInitializeHooks,
+  ): Promise<void> {
+    await super.initialize(options, {
+      ...hooks,
+      onSchemaReady: async () => {
+        this.minSelectCount = options.minSelectCount ?? 0
+        this.maxSelectCount = options.maxSelectCount ?? Infinity
+        await hooks?.onSchemaReady?.()
+      },
+    })
+  }
+
+  async select(name: string): Promise<void> {
+    const internalValue = this.getInternalValue()
+    const selectedCount = internalValue.filter(option => option.isSelected).length
+    const hasReachedMaxSelectCount = selectedCount >= this.maxSelectCount
+    const updatedInternalValue = internalValue.map((option) => {
+      const { name: optionName, isSelected, isDisabled } = option
+
+      if (isDisabled === true) {
+        return option
+      }
+
+      if (optionName !== name) {
+        return option
+      }
+
+      const targetIsSelected = !isSelected
+
+      if (targetIsSelected === true && hasReachedMaxSelectCount === true) {
+        return option
+      }
+      else {
+        return {
+          ...option,
+          isSelected: targetIsSelected,
+        }
+      }
+    })
+    await this.updateInternalValue(updatedInternalValue)
+  }
+}

package/src/form/inputor-controller/number.ts

@@ -0,0 +1,116 @@
+import type { BaseInputorContext, BaseInputorControllerOptions, BaseInputorSchema, InputorControllerInitializeHooks } from "./base.ts"
+import { BaseInputorController } from "./base.ts"
+
+interface InternalNumberConstraints {
+  min?: number | undefined
+  max?: number | undefined
+  step?: number | undefined
+}
+const internalConstrainNumber = (value: number, constraints: InternalNumberConstraints): number => {
+  let constrainedValue = value
+  if (constraints.step !== undefined) {
+    constrainedValue = Math.round(constrainedValue / constraints.step) * constraints.step
+  }
+  if (constraints.min !== undefined) {
+    constrainedValue = Math.max(constraints.min, constrainedValue)
+  }
+  if (constraints.max !== undefined) {
+    constrainedValue = Math.min(constraints.max, constrainedValue)
+  }
+  return constrainedValue
+}
+
+export const NUMBER_INPUTOR_TYPE_NAME = "number" as const
+export type NumberInputorTypeName = typeof NUMBER_INPUTOR_TYPE_NAME
+
+export type NumberInputorExternalValue = number | undefined
+export type NumberInputorInternalValue = number | undefined
+export interface NumberInputorSchema extends BaseInputorSchema<NumberInputorExternalValue> {
+  inputorTypeName: NumberInputorTypeName
+  min?: number | undefined
+  max?: number | undefined
+  step?: number | undefined
+}
+export interface NumberInputorContext extends BaseInputorContext<NumberInputorExternalValue, NumberInputorInternalValue> {
+}
+
+export interface NumberInputorControllerOptions extends BaseInputorControllerOptions<
+  NumberInputorExternalValue,
+  NumberInputorSchema
+> {
+  min?: number | undefined
+  max?: number | undefined
+  step?: number | undefined
+}
+export class NumberInputorController extends BaseInputorController<
+  NumberInputorExternalValue,
+  NumberInputorInternalValue,
+  NumberInputorSchema,
+  NumberInputorContext
+> {
+  declare schemaType: NumberInputorSchema
+  declare optionsType: NumberInputorControllerOptions
+  declare constructorType: typeof NumberInputorController
+
+  static inputorTypeName: NumberInputorTypeName = NUMBER_INPUTOR_TYPE_NAME
+
+  inputorTypeName: NumberInputorTypeName = NUMBER_INPUTOR_TYPE_NAME
+  voidExternalValue = undefined
+  voidInternalValue = undefined
+
+  private min: number | undefined
+  private max: number | undefined
+  private step: number | undefined
+
+  constructor(options: NumberInputorControllerOptions) {
+    super(options)
+  }
+
+  protected override async initialize(
+    options: NumberInputorControllerOptions,
+    hooks?: InputorControllerInitializeHooks,
+  ): Promise<void> {
+    await super.initialize(options, {
+      ...hooks,
+      onSchemaReady: async () => {
+        this.min = options.min
+        this.max = options.max
+        this.step = options.step
+        await hooks?.onSchemaReady?.()
+      },
+    })
+  }
+
+  override async getSchema(): Promise<NumberInputorSchema> {
+    return {
+      ...await super.getSchema(),
+      min: this.min,
+      max: this.max,
+      step: this.step,
+    }
+  }
+
+  override async constrainExternalValue(externalValue: NumberInputorExternalValue): Promise<NumberInputorExternalValue> {
+    if (externalValue === undefined) {
+      return await Promise.resolve(undefined)
+    }
+    const constrainedValue = internalConstrainNumber(externalValue, {
+      min: this.min,
+      max: this.max,
+      step: this.step,
+    })
+    return await Promise.resolve(constrainedValue)
+  }
+
+  override async constrainInternalValue(internalValue: NumberInputorInternalValue): Promise<NumberInputorInternalValue> {
+    if (internalValue === undefined) {
+      return await Promise.resolve(undefined)
+    }
+    const constrainedValue = internalConstrainNumber(internalValue, {
+      min: this.min,
+      max: this.max,
+      step: this.step,
+    })
+    return await Promise.resolve(constrainedValue)
+  }
+}