@rvx/ui 0.1.13 → 0.1.14

package/dist/common/parsers.d.ts

@@ -1,88 +0,0 @@
-import { Signal } from "rvx";
-export interface ValidParseResult<S> {
-    type: "valid";
-    /**
-     * The parsed value.
-     */
-    value: S;
-}
-export interface InvalidParseResult<M> {
-    type: "invalid";
-    /**
-     * The validation message key.
-     */
-    value: M;
-}
-export type ParseResult<S, M> = ValidParseResult<S> | InvalidParseResult<M>;
-export declare class ParserFormatError extends TypeError {
-}
-export interface Parser<S, I, M extends string> {
-    /**
-     * Parse the specified input.
-     */
-    parse(input: I): ParseResult<S, M>;
-    /**
-     * Format the specified source.
-     *
-     * @throws A {@link ParserFormatError} if the source isn't currently formattable.
-     */
-    format(source: S): I;
-    /**
-     * An object with validation message keys and content to display.
-     */
-    messages: Record<M, unknown>;
-}
-/**
- * Utility to get the source type from a parser.
- */
-export type ParserSource<P extends Parser<any, any, any>> = P extends Parser<infer S, any, any> ? S : never;
-/**
- * Utility to get the input type from a parser.
- */
-export type ParserInput<P extends Parser<any, any, any>> = P extends Parser<any, infer I, any> ? I : never;
-/**
- * Utility to get the message keys type from a parser.
- */
-export type ParserMessages<P extends Parser<any, any, any>> = P extends Parser<any, any, infer M> ? M : never;
-/**
- * Create a bi-directional input signal with validation.
- *
- * @param source The source signal.
- * @param parser The parser to use.
- * @param input The initial input signal to use. If not specified, the parser is used to format the current source value.
- *
- * @example
- * ```tsx
- * const value = $(0);
- *
- * // Format the current value as initial value:
- * <TextInput value={
- *   value
- *     .pipe(parse, intParser({ format: "Enter a valid number." }))
- *     .pipe(trim)
- * } />
- * ```
- */
-export declare function parse<S, P extends Parser<S, any, any>>(source: Signal<S>, parser: P, input?: Signal<ParserInput<P>>): Signal<ParserInput<P>>;
-export interface IntParserOptions {
-    /**
-     * A function to check if the parsed value is in a valid range.
-     *
-     * By default, the value must be a safe integer.
-     */
-    testRange?: (value: number) => boolean;
-    /**
-     * A validation message if the format is invalid.
-     */
-    format: unknown;
-    /**
-     * A validation message if the parsed value is out of range.
-     *
-     * By default, the format validation message is used.
-     */
-    range?: unknown;
-}
-/**
- * Create a parser for integers for use with {@link parse}.
- */
-export declare function intParser(options: IntParserOptions): Parser<number, string, "format" | "range">;

package/dist/common/parsers.js

@@ -1,62 +0,0 @@
-import { $, watchUpdates } from "rvx";
-import { Validator } from "../components/validation.js";
-export class ParserFormatError extends TypeError {
-}
-export function parse(source, parser, input) {
-    if (input === undefined) {
-        input = $(parser.format(source.value));
-    }
-    const invalid = $(undefined);
-    watchUpdates(source, value => {
-        try {
-            input.value = parser.format(value);
-        }
-        catch (error) {
-            if (!(error instanceof ParserFormatError)) {
-                throw error;
-            }
-        }
-    });
-    watchUpdates(input, value => {
-        const result = parser.parse(value);
-        if (result.type === "valid") {
-            source.value = result.value;
-            invalid.value = undefined;
-        }
-        else {
-            invalid.value = result.value;
-        }
-    });
-    const validator = Validator.attach(source);
-    validator.attach(input);
-    for (const key in parser.messages) {
-        validator.prependRule({
-            validate: () => invalid.value !== key,
-            message: parser.messages[key],
-        });
-    }
-    return input;
-}
-export function intParser(options) {
-    const range = options.testRange ?? Number.isSafeInteger;
-    return {
-        parse(input) {
-            if (!/^-?\d+$/.test(input)) {
-                return { type: "invalid", value: "format" };
-            }
-            const value = Number(input);
-            if (!range(value)) {
-                return { type: "invalid", value: "range" };
-            }
-            return { type: "valid", value };
-        },
-        format(source) {
-            return String(source);
-        },
-        messages: {
-            format: options.format,
-            range: options.range ?? options.format,
-        },
-    };
-}
-//# sourceMappingURL=parsers.js.map

package/dist/common/parsers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/common/parsers.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAU,YAAY,EAAE,MAAM,KAAK,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAsBxD,MAAM,OAAO,iBAAkB,SAAQ,SAAS;CAAG;AAuDnD,MAAM,UAAU,KAAK,CAAmC,MAAiB,EAAE,MAAS,EAAE,KAA8B;IACnH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,CAAgC,SAAS,CAAC,CAAC;IAE5D,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;QAC5B,IAAI,CAAC;YACJ,KAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAmB,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,CAAC,KAAK,YAAY,iBAAiB,CAAC,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC5B,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;QAC3B,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAA0B,CAAC;QACnD,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAExB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnC,SAAS,CAAC,WAAW,CAAC;YACrB,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,GAAG;YACrC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;SAC7B,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AA0BD,MAAM,UAAU,SAAS,CAAC,OAAyB;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,aAAa,CAAC;IACxD,OAAO;QACN,KAAK,CAAC,KAAK;YACV,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAC7C,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAC5C,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,CAAC,MAAM;YACZ,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,QAAQ,EAAE;YACT,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM;SACtC;KACD,CAAC;AACH,CAAC"}

package/dist/common/trim.d.ts

@@ -1,12 +0,0 @@
-import { Signal } from "rvx";
-/**
- * Create a signal that trims input.
- *
- * This supports validation.
- *
- * @example
- * ```tsx
- * <TextInput value={someSignal.pipe(trim)} />;
- * ```
- */
-export declare function trim(source: Signal<string>): Signal<string>;

package/dist/common/trim.js

@@ -1,16 +0,0 @@
-import { $, watchUpdates } from "rvx";
-import { validatorFor } from "../components/validation.js";
-export function trim(source) {
-    const input = $(source.value);
-    watchUpdates(input, value => {
-        source.value = value.trim();
-    });
-    watchUpdates(source, value => {
-        if (value !== input.value.trim()) {
-            input.value = value;
-        }
-    });
-    validatorFor(source)?.attach(input);
-    return input;
-}
-//# sourceMappingURL=trim.js.map

package/dist/common/trim.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"trim.js","sourceRoot":"","sources":["../../src/common/trim.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAU,YAAY,EAAE,MAAM,KAAK,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAY3D,MAAM,UAAU,IAAI,CAAC,MAAsB;IAC1C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9B,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;QAC3B,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;QAC5B,IAAI,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC;AACd,CAAC"}

package/src/common/debounce.tsx

@@ -1,36 +0,0 @@
-import { $, Signal, teardown, watchUpdates } from "rvx";
-import { validatorFor } from "../components/validation.js";
-
-/**
- * Create a signal that debounces input changes.
- *
- * This supports validation.
- *
- * @example
- * ```tsx
- * <TextInput value={someSignal.pipe(debounce, 500)} />
- * ```
- */
-export function debounce<T>(source: Signal<T>, delay: number): Signal<T> {
-	const input = $(source.value);
-	let timer: number | undefined;
-
-	watchUpdates(input, value => {
-		clearTimeout(timer);
-		if (source.value !== value) {
-			timer = (setTimeout as typeof window.setTimeout)(() => {
-				source.value = value;
-			}, delay);
-			teardown(() => {
-				clearTimeout(timer);
-			});
-		}
-	});
-
-	watchUpdates(source, value => {
-		input.value = value;
-	});
-
-	validatorFor(source)?.attach(input);
-	return input;
-}

package/src/common/parsers.tsx

@@ -1,167 +0,0 @@
-import { $, Signal, watchUpdates } from "rvx";
-
-import { Validator } from "../components/validation.js";
-
-export interface ValidParseResult<S> {
-	type: "valid";
-
-	/**
-	 * The parsed value.
-	 */
-	value: S;
-}
-
-export interface InvalidParseResult<M> {
-	type: "invalid";
-
-	/**
-	 * The validation message key.
-	 */
-	value: M;
-}
-
-export type ParseResult<S, M> = ValidParseResult<S> | InvalidParseResult<M>;
-
-export class ParserFormatError extends TypeError {}
-
-export interface Parser<S, I, M extends string> {
-	/**
-	 * Parse the specified input.
-	 */
-	parse(input: I): ParseResult<S, M>;
-
-	/**
-	 * Format the specified source.
-	 *
-	 * @throws A {@link ParserFormatError} if the source isn't currently formattable.
-	 */
-	format(source: S): I;
-
-	/**
-	 * An object with validation message keys and content to display.
-	 */
-	messages: Record<M, unknown>;
-}
-
-/**
- * Utility to get the source type from a parser.
- */
-export type ParserSource<P extends Parser<any, any, any>> = P extends Parser<infer S, any, any> ? S : never;
-
-/**
- * Utility to get the input type from a parser.
- */
-export type ParserInput<P extends Parser<any, any, any>> = P extends Parser<any, infer I, any> ? I : never;
-
-/**
- * Utility to get the message keys type from a parser.
- */
-export type ParserMessages<P extends Parser<any, any, any>> = P extends Parser<any, any, infer M> ? M : never;
-
-/**
- * Create a bi-directional input signal with validation.
- *
- * @param source The source signal.
- * @param parser The parser to use.
- * @param input The initial input signal to use. If not specified, the parser is used to format the current source value.
- *
- * @example
- * ```tsx
- * const value = $(0);
- *
- * // Format the current value as initial value:
- * <TextInput value={
- *   value
- *     .pipe(parse, intParser({ format: "Enter a valid number." }))
- *     .pipe(trim)
- * } />
- * ```
- */
-export function parse<S, P extends Parser<S, any, any>>(source: Signal<S>, parser: P, input?: Signal<ParserInput<P>>): Signal<ParserInput<P>> {
-	if (input === undefined) {
-		input = $(parser.format(source.value));
-	}
-
-	const invalid = $<undefined | ParserMessages<P>>(undefined);
-
-	watchUpdates(source, value => {
-		try {
-			input!.value = parser.format(value) as ParserInput<P>;
-		} catch (error) {
-			if (!(error instanceof ParserFormatError)) {
-				throw error;
-			}
-		}
-	});
-
-	watchUpdates(input, value => {
-		const result = parser.parse(value);
-		if (result.type === "valid") {
-			source.value = result.value;
-			invalid.value = undefined;
-		} else {
-			invalid.value = result.value as ParserMessages<P>;
-		}
-	});
-
-	const validator = Validator.attach(source);
-	validator.attach(input);
-
-	for (const key in parser.messages) {
-		validator.prependRule({
-			validate: () => invalid.value !== key,
-			message: parser.messages[key],
-		});
-	}
-
-	return input;
-}
-
-export interface IntParserOptions {
-	/**
-	 * A function to check if the parsed value is in a valid range.
-	 *
-	 * By default, the value must be a safe integer.
-	 */
-	testRange?: (value: number) => boolean;
-
-	/**
-	 * A validation message if the format is invalid.
-	 */
-	format: unknown;
-
-	/**
-	 * A validation message if the parsed value is out of range.
-	 *
-	 * By default, the format validation message is used.
-	 */
-	range?: unknown;
-}
-
-/**
- * Create a parser for integers for use with {@link parse}.
- */
-export function intParser(options: IntParserOptions): Parser<number, string, "format" | "range"> {
-	const range = options.testRange ?? Number.isSafeInteger;
-	return {
-		parse(input) {
-			if (!/^-?\d+$/.test(input)) {
-				return { type: "invalid", value: "format" };
-			}
-			const value = Number(input);
-			if (!range(value)) {
-				return { type: "invalid", value: "range" };
-			}
-			return { type: "valid", value };
-		},
-
-		format(source) {
-			return String(source);
-		},
-
-		messages: {
-			format: options.format,
-			range: options.range ?? options.format,
-		},
-	};
-}

package/src/common/trim.tsx

@@ -1,30 +0,0 @@
-import { $, Signal, watchUpdates } from "rvx";
-
-import { validatorFor } from "../components/validation.js";
-
-/**
- * Create a signal that trims input.
- *
- * This supports validation.
- *
- * @example
- * ```tsx
- * <TextInput value={someSignal.pipe(trim)} />;
- * ```
- */
-export function trim(source: Signal<string>): Signal<string> {
-	const input = $(source.value);
-
-	watchUpdates(input, value => {
-		source.value = value.trim();
-	});
-
-	watchUpdates(source, value => {
-		if (value !== input.value.trim()) {
-			input.value = value;
-		}
-	});
-
-	validatorFor(source)?.attach(input);
-	return input;
-}