import { InputSpec, LazyBuild } from "./inputSpec" import { List } from "./list" import { Variants } from "./variants" import { FilePath, Pattern, RandomString, ValueSpec, ValueSpecDatetime, ValueSpecHidden, ValueSpecText, ValueSpecTextarea, } from "../inputSpecTypes" import { DefaultString } from "../inputSpecTypes" import { _, once } from "../../../util" import { Parser, any, anyOf, arrayOf, boolean, literal, literals, number, object, string, unknown, } from "ts-matches" export type RequiredDefault = | false | { default: A | null } function requiredLikeToAbove, A>( requiredLike: Input, ) { // prettier-ignore return { required: (typeof requiredLike === 'object' ? true : requiredLike) as ( Input extends { default: unknown} ? true: Input extends true ? true : false ), default:(typeof requiredLike === 'object' ? requiredLike.default : null) as ( Input extends { default: infer Default } ? Default : null ) }; } type AsRequired = MaybeRequiredType extends | { default: unknown } | never ? Type : Type | null | undefined const testForAsRequiredParser = once( () => object({ required: object({ default: unknown }) }).test, ) function asRequiredParser< Type, Input, Return extends | Parser | Parser, >(parser: Parser, input: Input): Return { if (testForAsRequiredParser()(input)) return parser as any return parser.optional() as any } export class Value { protected constructor( public build: LazyBuild, public validator: Parser, ) {} static toggle(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null default: boolean /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }) { return new Value( async () => ({ description: null, warning: null, type: "toggle" as const, disabled: false, immutable: a.immutable ?? false, ...a, }), boolean, ) } static dynamicToggle( a: LazyBuild< Store, { name: string description?: string | null warning?: string | null default: boolean disabled?: false | string } >, ) { return new Value( async (options) => ({ description: null, warning: null, type: "toggle" as const, disabled: false, immutable: false, ...(await a(options)), }), boolean, ) } static text>(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description Determines if the field is required. If so, optionally provide a default value. * @type { false | { default: string | RandomString | null } } * @example required: false * @example required: { default: null } * @example required: { default: 'World' } * @example required: { default: { charset: 'abcdefg', len: 16 } } */ required: Required /** * @description Mask (aka camouflage) text input with dots: ● ● ● * @default false */ masked?: boolean placeholder?: string | null minLength?: number | null maxLength?: number | null /** * @description A list of regular expressions to which the text must conform to pass validation. A human readable description is provided in case the validation fails. * @default [] * @example * ``` [ { regex: "[a-z]", description: "May only contain lower case letters from the English alphabet." } ] * ``` */ patterns?: Pattern[] /** * @description Informs the browser how to behave and which keyboard to display on mobile * @default "text" */ inputmode?: ValueSpecText["inputmode"] /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean /** * @description Displays a button that will generate a random string according to the provided charset and len attributes. */ generate?: RandomString | null }) { return new Value, never>( async () => ({ type: "text" as const, description: null, warning: null, masked: false, placeholder: null, minLength: null, maxLength: null, patterns: [], inputmode: "text", disabled: false, immutable: a.immutable ?? false, generate: a.generate ?? null, ...a, ...requiredLikeToAbove(a.required), }), asRequiredParser(string, a), ) } static dynamicText( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null required: RequiredDefault masked?: boolean placeholder?: string | null minLength?: number | null maxLength?: number | null patterns?: Pattern[] inputmode?: ValueSpecText["inputmode"] disabled?: string | false generate?: null | RandomString } >, ) { return new Value(async (options) => { const a = await getA(options) return { type: "text" as const, description: null, warning: null, masked: false, placeholder: null, minLength: null, maxLength: null, patterns: [], inputmode: "text", disabled: false, immutable: false, generate: a.generate ?? null, ...a, ...requiredLikeToAbove(a.required), } }, string.optional()) } static textarea(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description Unlike other "required" fields, for textarea this is a simple boolean. */ required: boolean minLength?: number | null maxLength?: number | null placeholder?: string | null /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }) { return new Value(async () => { const built: ValueSpecTextarea = { description: null, warning: null, minLength: null, maxLength: null, placeholder: null, type: "textarea" as const, disabled: false, immutable: a.immutable ?? false, ...a, } return built }, string) } static dynamicTextarea( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null required: boolean minLength?: number | null maxLength?: number | null placeholder?: string | null disabled?: false | string } >, ) { return new Value(async (options) => { const a = await getA(options) return { description: null, warning: null, minLength: null, maxLength: null, placeholder: null, type: "textarea" as const, disabled: false, immutable: false, ...a, } }, string) } static number>(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description Determines if the field is required. If so, optionally provide a default value. * @type { false | { default: number | null } } * @example required: false * @example required: { default: null } * @example required: { default: 7 } */ required: Required min?: number | null max?: number | null /** * @description How much does the number increase/decrease when using the arrows provided by the browser. * @default 1 */ step?: number | null /** * @description Requires the number to be an integer. */ integer: boolean /** * @description Optionally display units to the right of the input box. */ units?: string | null placeholder?: string | null /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }) { return new Value, never>( () => ({ type: "number" as const, description: null, warning: null, min: null, max: null, step: null, units: null, placeholder: null, disabled: false, immutable: a.immutable ?? false, ...a, ...requiredLikeToAbove(a.required), }), asRequiredParser(number, a), ) } static dynamicNumber( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null required: RequiredDefault min?: number | null max?: number | null step?: number | null integer: boolean units?: string | null placeholder?: string | null disabled?: false | string } >, ) { return new Value(async (options) => { const a = await getA(options) return { type: "number" as const, description: null, warning: null, min: null, max: null, step: null, units: null, placeholder: null, disabled: false, immutable: false, ...a, ...requiredLikeToAbove(a.required), } }, number.optional()) } static color>(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description Determines if the field is required. If so, optionally provide a default value. * @type { false | { default: string | null } } * @example required: false * @example required: { default: null } * @example required: { default: 'ffffff' } */ required: Required /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }) { return new Value, never>( () => ({ type: "color" as const, description: null, warning: null, disabled: false, immutable: a.immutable ?? false, ...a, ...requiredLikeToAbove(a.required), }), asRequiredParser(string, a), ) } static dynamicColor( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null required: RequiredDefault disabled?: false | string } >, ) { return new Value(async (options) => { const a = await getA(options) return { type: "color" as const, description: null, warning: null, disabled: false, immutable: false, ...a, ...requiredLikeToAbove(a.required), } }, string.optional()) } static datetime>(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description Determines if the field is required. If so, optionally provide a default value. * @type { false | { default: string | null } } * @example required: false * @example required: { default: null } * @example required: { default: '1985-12-16 18:00:00.000' } */ required: Required /** * @description Informs the browser how to behave and which date/time component to display. * @default "datetime-local" */ inputmode?: ValueSpecDatetime["inputmode"] min?: string | null max?: string | null /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }) { return new Value, never>( () => ({ type: "datetime" as const, description: null, warning: null, inputmode: "datetime-local", min: null, max: null, step: null, disabled: false, immutable: a.immutable ?? false, ...a, ...requiredLikeToAbove(a.required), }), asRequiredParser(string, a), ) } static dynamicDatetime( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null required: RequiredDefault inputmode?: ValueSpecDatetime["inputmode"] min?: string | null max?: string | null disabled?: false | string } >, ) { return new Value(async (options) => { const a = await getA(options) return { type: "datetime" as const, description: null, warning: null, inputmode: "datetime-local", min: null, max: null, disabled: false, immutable: false, ...a, ...requiredLikeToAbove(a.required), } }, string.optional()) } static select< Required extends RequiredDefault, Values extends Record, >(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description Determines if the field is required. If so, optionally provide a default value from the list of values. * @type { false | { default: string | null } } * @example required: false * @example required: { default: null } * @example required: { default: 'radio1' } */ required: Required /** * @description A mapping of unique radio options to their human readable display format. * @example * ``` { radio1: "Radio 1" radio2: "Radio 2" radio3: "Radio 3" } * ``` */ values: Values /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }) { return new Value, never>( () => ({ description: null, warning: null, type: "select" as const, disabled: false, immutable: a.immutable ?? false, ...a, ...requiredLikeToAbove(a.required), }), asRequiredParser( anyOf( ...Object.keys(a.values).map((x: keyof Values & string) => literal(x), ), ), a, ) as any, ) } static dynamicSelect( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null required: RequiredDefault values: Record disabled?: false | string | string[] } >, ) { return new Value(async (options) => { const a = await getA(options) return { description: null, warning: null, type: "select" as const, disabled: false, immutable: false, ...a, ...requiredLikeToAbove(a.required), } }, string.optional()) } static multiselect>(a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description A simple list of which options should be checked by default. */ default: string[] /** * @description A mapping of checkbox options to their human readable display format. * @example * ``` { option1: "Option 1" option2: "Option 2" option3: "Option 3" } * ``` */ values: Values minLength?: number | null maxLength?: number | null /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }) { return new Value<(keyof Values)[], never>( () => ({ type: "multiselect" as const, minLength: null, maxLength: null, warning: null, description: null, disabled: false, immutable: a.immutable ?? false, ...a, }), arrayOf( literals(...(Object.keys(a.values) as any as [keyof Values & string])), ), ) } static dynamicMultiselect( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null default: string[] values: Record minLength?: number | null maxLength?: number | null disabled?: false | string | string[] } >, ) { return new Value(async (options) => { const a = await getA(options) return { type: "multiselect" as const, minLength: null, maxLength: null, warning: null, description: null, disabled: false, immutable: false, ...a, } }, arrayOf(string)) } static object, Store>( a: { name: string description?: string | null }, spec: InputSpec, ) { return new Value(async (options) => { const built = await spec.build(options as any) return { type: "object" as const, description: null, warning: null, ...a, spec: built, } }, spec.validator) } // static file(a: { // name: string // description?: string | null // extensions: string[] // required: boolean // }) { // const buildValue = { // type: "file" as const, // description: null, // warning: null, // ...a, // } // return new Value( // () => ({ // ...buildValue, // }), // asRequiredParser(object({ filePath: string }), a), // ) // } // static dynamicFile( // a: LazyBuild< // Store, // { // name: string // description?: string | null // warning?: string | null // extensions: string[] // required: Required // } // >, // ) { // return new Value( // async (options) => ({ // type: "file" as const, // description: null, // warning: null, // ...(await a(options)), // }), // string.optional(), // ) // } static union, Type, Store>( a: { name: string description?: string | null /** Presents a warning prompt before permitting the value to change. */ warning?: string | null /** * @description Determines if the field is required. If so, optionally provide a default value from the list of variants. * @type { false | { default: string | null } } * @example required: false * @example required: { default: null } * @example required: { default: 'variant1' } */ required: Required /** * @description Once set, the value can never be changed. * @default false */ immutable?: boolean }, aVariants: Variants, ) { return new Value, Store>( async (options) => ({ type: "union" as const, description: null, warning: null, disabled: false, ...a, variants: await aVariants.build(options as any), ...requiredLikeToAbove(a.required), immutable: a.immutable ?? false, }), asRequiredParser(aVariants.validator, a), ) } static filteredUnion< Required extends RequiredDefault, Type extends Record, Store = never, >( getDisabledFn: LazyBuild, a: { name: string description?: string | null warning?: string | null required: Required }, aVariants: Variants | Variants, ) { return new Value, Store>( async (options) => ({ type: "union" as const, description: null, warning: null, ...a, variants: await aVariants.build(options as any), ...requiredLikeToAbove(a.required), disabled: (await getDisabledFn(options)) || false, immutable: false, }), asRequiredParser(aVariants.validator, a), ) } static dynamicUnion< Required extends RequiredDefault, Type extends Record, Store = never, >( getA: LazyBuild< Store, { name: string description?: string | null warning?: string | null required: Required disabled: string[] | false | string } >, aVariants: Variants | Variants, ) { return new Value(async (options) => { const newValues = await getA(options) return { type: "union" as const, description: null, warning: null, ...newValues, variants: await aVariants.build(options as any), ...requiredLikeToAbove(newValues.required), immutable: false, } }, aVariants.validator.optional()) } static list(a: List) { return new Value((options) => a.build(options), a.validator) } static hidden(parser: Parser = any) { return new Value(async () => { const built: ValueSpecHidden = { type: "hidden" as const, } return built }, parser) } /** * Use this during the times that the input needs a more specific type. * Used in types that the value/ variant/ list/ inputSpec is constructed somewhere else. ```ts const a = InputSpec.text({ name: "a", required: false, }) return InputSpec.of()({ myValue: a.withStore(), }) ``` */ withStore() { return this as any as Value } }