@octanejs/hook-form 0.1.0

package/src/utils/deepMerge.ts

@@ -0,0 +1,27 @@
+// Vendored from react-hook-form@7.81.0 src/utils/deepMerge.ts (octane port).
+import isObject from './isObject';
+import isPrimitive from './isPrimitive';
+
+export default function deepMerge<T extends Record<keyof T, any>, U extends Record<keyof U, any>>(
+	target: T,
+	source: U,
+): T & U {
+	if (isPrimitive(target) || isPrimitive(source)) {
+		return source;
+	}
+
+	for (const key in source) {
+		const targetValue = target[key];
+		const sourceValue = source[key];
+
+		try {
+			target[key] =
+				(isObject(targetValue) && isObject(sourceValue)) ||
+				(Array.isArray(targetValue) && Array.isArray(sourceValue))
+					? deepMerge(targetValue, sourceValue)
+					: sourceValue;
+		} catch {}
+	}
+
+	return target;
+}

package/src/utils/extractFormValues.ts

@@ -0,0 +1,28 @@
+// Vendored from react-hook-form@7.81.0 src/utils/extractFormValues.ts (octane port).
+import isObject from './isObject';
+
+export default function extractFormValues<T extends object, K extends Record<string, unknown>>(
+	fieldsState: T,
+	formValues: K,
+) {
+	const values: Record<string, unknown> = {};
+
+	for (const key in fieldsState) {
+		if (fieldsState.hasOwnProperty(key)) {
+			const fieldState = fieldsState[key];
+			const fieldValue = formValues[key];
+
+			if (fieldState && isObject(fieldState) && fieldValue) {
+				const nestedFieldsState = extractFormValues(fieldState, fieldValue as K);
+
+				if (isObject(nestedFieldsState)) {
+					values[key] = nestedFieldsState;
+				}
+			} else if (fieldsState[key]) {
+				values[key] = fieldValue;
+			}
+		}
+	}
+
+	return values;
+}

package/src/utils/fillEmptyArray.ts

@@ -0,0 +1,3 @@
+// Vendored from react-hook-form@7.81.0 src/utils/fillEmptyArray.ts (octane port).
+export default <T>(value: T | T[]): undefined[] | undefined =>
+	Array.isArray(value) ? value.map(() => undefined) : undefined;

package/src/utils/flatten.ts

@@ -0,0 +1,23 @@
+// Vendored from react-hook-form@7.81.0 src/utils/flatten.ts (octane port).
+import type { FieldValues } from '../types';
+
+import isDateObject from './isDateObject';
+import { isObjectType } from './isObject';
+
+export const flatten = (obj: FieldValues) => {
+	const output: FieldValues = {};
+
+	for (const key of Object.keys(obj)) {
+		if (isObjectType(obj[key]) && obj[key] !== null && !isDateObject(obj[key])) {
+			const nested = flatten(obj[key]);
+
+			for (const nestedKey of Object.keys(nested)) {
+				output[`${key}.${nestedKey}`] = nested[nestedKey];
+			}
+		} else {
+			output[key] = obj[key];
+		}
+	}
+
+	return output;
+};

package/src/utils/get.ts

@@ -0,0 +1,29 @@
+// Vendored from react-hook-form@7.81.0 src/utils/get.ts (octane port).
+import { PROTOTYPE_KEYWORDS } from '../constants';
+
+import isKey from './isKey';
+import isNullOrUndefined from './isNullOrUndefined';
+import isObject from './isObject';
+import isUndefined from './isUndefined';
+import stringToPath from './stringToPath';
+
+export default <T>(object: T, path?: string | null, defaultValue?: unknown): any => {
+	if (!path || !isObject(object)) {
+		return defaultValue;
+	}
+
+	const paths = isKey(path) ? [path] : stringToPath(path);
+	if (paths.some((key) => PROTOTYPE_KEYWORDS.includes(key))) {
+		return defaultValue;
+	}
+
+	const result = paths.reduce<any>((result, key) => {
+		return isNullOrUndefined(result) ? undefined : result[key];
+	}, object);
+
+	return isUndefined(result) || result === object
+		? isUndefined(object[path as keyof T])
+			? defaultValue
+			: object[path as keyof T]
+		: result;
+};

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+// Vendored from react-hook-form@7.81.0 src/utils/index.ts (octane port).
+export { default as get } from './get';
+export { default as set } from './set';

package/src/utils/insert.ts

@@ -0,0 +1,8 @@
+// Vendored from react-hook-form@7.81.0 src/utils/insert.ts (octane port).
+import convertToArrayPayload from './convertToArrayPayload';
+
+export default function insert<T>(data: T[], index: number): (T | undefined)[];
+export default function insert<T>(data: T[], index: number, value: T | T[]): T[];
+export default function insert<T>(data: T[], index: number, value?: T | T[]): (T | undefined)[] {
+	return [...data.slice(0, index), ...convertToArrayPayload(value), ...data.slice(index)];
+}

package/src/utils/isBoolean.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isBoolean.ts (octane port).
+export default (value: unknown): value is boolean => typeof value === 'boolean';

package/src/utils/isCheckBoxInput.ts

@@ -0,0 +1,4 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isCheckBoxInput.ts (octane port).
+import type { FieldElement } from '../types';
+
+export default (element: FieldElement): element is HTMLInputElement => element.type === 'checkbox';

package/src/utils/isDateObject.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isDateObject.ts (octane port).
+export default (value: unknown): value is Date => value instanceof Date;

package/src/utils/isEmptyObject.ts

@@ -0,0 +1,7 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isEmptyObject.ts (octane port).
+import type { EmptyObject } from '../types';
+
+import isObject from './isObject';
+
+export default (value: unknown): value is EmptyObject =>
+	isObject(value) && !Object.keys(value).length;

package/src/utils/isFileInput.ts

@@ -0,0 +1,4 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isFileInput.ts (octane port).
+import type { FieldElement } from '../types';
+
+export default (element: FieldElement): element is HTMLInputElement => element.type === 'file';

package/src/utils/isFunction.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isFunction.ts (octane port).
+export default (value: unknown): value is Function => typeof value === 'function';

package/src/utils/isHTMLElement.ts

@@ -0,0 +1,13 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isHTMLElement.ts (octane port).
+import isWeb from './isWeb';
+
+export default (value: unknown): value is HTMLElement => {
+	if (!isWeb) {
+		return false;
+	}
+
+	const owner = value ? ((value as HTMLElement).ownerDocument as Document) : 0;
+	return (
+		value instanceof (owner && owner.defaultView ? owner.defaultView.HTMLElement : HTMLElement)
+	);
+};

package/src/utils/isKey.ts

@@ -0,0 +1,4 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isKey.ts (octane port).
+const IS_KEY_RE = /^\w*$/;
+
+export default (value: string) => IS_KEY_RE.test(value);

package/src/utils/isMultipleSelect.ts

@@ -0,0 +1,5 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isMultipleSelect.ts (octane port).
+import type { FieldElement } from '../types';
+
+export default (element: FieldElement): element is HTMLSelectElement =>
+	element.type === `select-multiple`;

package/src/utils/isNullOrUndefined.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isNullOrUndefined.ts (octane port).
+export default (value: unknown): value is null | undefined => value == null;

package/src/utils/isObject.ts

@@ -0,0 +1,8 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isObject.ts (octane port).
+import isDateObject from './isDateObject';
+import isNullOrUndefined from './isNullOrUndefined';
+
+export const isObjectType = (value: unknown): value is object => typeof value === 'object';
+
+export default <T extends object>(value: unknown): value is T =>
+	!isNullOrUndefined(value) && !Array.isArray(value) && isObjectType(value) && !isDateObject(value);

package/src/utils/isPlainObject.ts

@@ -0,0 +1,8 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isPlainObject.ts (octane port).
+import isObject from './isObject';
+
+export default (tempObject: object) => {
+	const prototypeCopy = tempObject.constructor && tempObject.constructor.prototype;
+
+	return isObject(prototypeCopy) && prototypeCopy.hasOwnProperty('isPrototypeOf');
+};

package/src/utils/isPrimitive.ts

@@ -0,0 +1,8 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isPrimitive.ts (octane port).
+import type { Primitive } from '../types';
+
+import isNullOrUndefined from './isNullOrUndefined';
+import { isObjectType } from './isObject';
+
+export default (value: unknown): value is Primitive =>
+	isNullOrUndefined(value) || !isObjectType(value);

package/src/utils/isRadioInput.ts

@@ -0,0 +1,4 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isRadioInput.ts (octane port).
+import type { FieldElement } from '../types';
+
+export default (element: FieldElement): element is HTMLInputElement => element.type === 'radio';

package/src/utils/isRadioOrCheckbox.ts

@@ -0,0 +1,8 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isRadioOrCheckbox.ts (octane port).
+import type { FieldElement } from '../types';
+
+import isCheckBoxInput from './isCheckBoxInput';
+import isRadioInput from './isRadioInput';
+
+export default (ref: FieldElement): ref is HTMLInputElement =>
+	isRadioInput(ref) || isCheckBoxInput(ref);

package/src/utils/isRegex.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isRegex.ts (octane port).
+export default (value: unknown): value is RegExp => value instanceof RegExp;

package/src/utils/isString.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isString.ts (octane port).
+export default (value: unknown): value is string => typeof value === 'string';

package/src/utils/isUndefined.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isUndefined.ts (octane port).
+export default (val: unknown): val is undefined => val === undefined;

package/src/utils/isWeb.ts

@@ -0,0 +1,4 @@
+// Vendored from react-hook-form@7.81.0 src/utils/isWeb.ts (octane port).
+export default typeof window !== 'undefined' &&
+	typeof window.HTMLElement !== 'undefined' &&
+	typeof document !== 'undefined';

package/src/utils/live.ts

@@ -0,0 +1,6 @@
+// Vendored from react-hook-form@7.81.0 src/utils/live.ts (octane port).
+import type { Ref } from '../types';
+
+import isHTMLElement from './isHTMLElement';
+
+export default (ref: Ref) => isHTMLElement(ref) && ref.isConnected;

package/src/utils/move.ts

@@ -0,0 +1,15 @@
+// Vendored from react-hook-form@7.81.0 src/utils/move.ts (octane port).
+import isUndefined from './isUndefined';
+
+export default <T>(data: (T | undefined)[], from: number, to: number): (T | undefined)[] => {
+	if (!Array.isArray(data)) {
+		return [];
+	}
+
+	if (isUndefined(data[to])) {
+		data[to] = undefined;
+	}
+	data.splice(to, 0, data.splice(from, 1)[0]);
+
+	return data;
+};

package/src/utils/noop.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/noop.ts (octane port).
+export default function noop() {}

package/src/utils/objectHasFunction.ts

@@ -0,0 +1,11 @@
+// Vendored from react-hook-form@7.81.0 src/utils/objectHasFunction.ts (octane port).
+import isFunction from './isFunction';
+
+export default <T>(data: T): boolean => {
+	for (const key in data) {
+		if (isFunction(data[key])) {
+			return true;
+		}
+	}
+	return false;
+};

package/src/utils/prepend.ts

@@ -0,0 +1,7 @@
+// Vendored from react-hook-form@7.81.0 src/utils/prepend.ts (octane port).
+import convertToArrayPayload from './convertToArrayPayload';
+
+export default <T>(data: T[], value: T | T[]): T[] => [
+	...convertToArrayPayload(value),
+	...convertToArrayPayload(data),
+];

package/src/utils/remove.ts

@@ -0,0 +1,24 @@
+// Vendored from react-hook-form@7.81.0 src/utils/remove.ts (octane port).
+import compact from './compact';
+import convertToArrayPayload from './convertToArrayPayload';
+import isUndefined from './isUndefined';
+
+function removeAtIndexes<T>(data: T[], indexes: number[]): T[] {
+	let i = 0;
+	const temp = [...data];
+
+	for (const index of indexes) {
+		temp.splice(index - i, 1);
+		i++;
+	}
+
+	return compact(temp).length ? temp : [];
+}
+
+export default <T>(data: T[], index?: number | number[]): T[] =>
+	isUndefined(index)
+		? []
+		: removeAtIndexes(
+				data,
+				(convertToArrayPayload(index) as number[]).sort((a, b) => a - b),
+			);

package/src/utils/set.ts

@@ -0,0 +1,36 @@
+// Vendored from react-hook-form@7.81.0 src/utils/set.ts (octane port).
+import { PROTOTYPE_KEYWORDS } from '../constants';
+import type { FieldPath, FieldValues } from '../types';
+
+import isKey from './isKey';
+import isObject from './isObject';
+import stringToPath from './stringToPath';
+
+export default (object: FieldValues, path: FieldPath<FieldValues>, value?: unknown) => {
+	let index = -1;
+	const tempPath = isKey(path) ? [path] : stringToPath(path);
+	const length = tempPath.length;
+	const lastIndex = length - 1;
+
+	while (++index < length) {
+		const key = tempPath[index];
+		let newValue = value;
+
+		if (index !== lastIndex) {
+			const objValue = object[key];
+			newValue =
+				isObject(objValue) || Array.isArray(objValue)
+					? objValue
+					: !isNaN(+tempPath[index + 1])
+						? []
+						: {};
+		}
+
+		if (PROTOTYPE_KEYWORDS.includes(key)) {
+			return;
+		}
+
+		object[key] = newValue;
+		object = object[key];
+	}
+};

package/src/utils/sleep.ts

@@ -0,0 +1,2 @@
+// Vendored from react-hook-form@7.81.0 src/utils/sleep.ts (octane port).
+export default (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));

package/src/utils/stringToPath.ts

@@ -0,0 +1,4 @@
+// Vendored from react-hook-form@7.81.0 src/utils/stringToPath.ts (octane port).
+const FIELD_PATH_RE = /[.[\]'"]/;
+
+export default (input: string): string[] => input.split(FIELD_PATH_RE).filter(Boolean);

package/src/utils/swap.ts

@@ -0,0 +1,4 @@
+// Vendored from react-hook-form@7.81.0 src/utils/swap.ts (octane port).
+export default <T>(data: T[], indexA: number, indexB: number): void => {
+	[data[indexA], data[indexB]] = [data[indexB], data[indexA]];
+};

package/src/utils/unset.ts

@@ -0,0 +1,65 @@
+// Vendored from react-hook-form@7.81.0 src/utils/unset.ts (octane port).
+import { PROTOTYPE_KEYWORDS } from '../constants';
+
+import isEmptyObject from './isEmptyObject';
+import isKey from './isKey';
+import isNullOrUndefined from './isNullOrUndefined';
+import isObject from './isObject';
+import isString from './isString';
+import isUndefined from './isUndefined';
+import stringToPath from './stringToPath';
+
+function baseGet(object: any, updatePath: (string | number)[]) {
+	const length = updatePath.slice(0, -1).length;
+	let index = 0;
+
+	while (index < length) {
+		if (isNullOrUndefined(object)) {
+			object = undefined;
+			break;
+		}
+		object = object[updatePath[index]];
+		index++;
+	}
+
+	return object;
+}
+
+function isEmptyArray(obj: unknown[]) {
+	for (const key in obj) {
+		if (obj.hasOwnProperty(key) && !isUndefined(obj[key])) {
+			return false;
+		}
+	}
+	return true;
+}
+
+export default function unset(object: any, path: string | (string | number)[]) {
+	if (isString(path) && Object.prototype.hasOwnProperty.call(object, path)) {
+		delete object[path];
+		return object;
+	}
+
+	const paths = Array.isArray(path) ? path : isKey(path) ? [path] : stringToPath(path);
+	if (paths.some((segment) => PROTOTYPE_KEYWORDS.includes(String(segment)))) {
+		return object;
+	}
+	const childObject = paths.length === 1 ? object : baseGet(object, paths);
+
+	const index = paths.length - 1;
+	const key = paths[index];
+
+	if (childObject) {
+		delete childObject[key];
+	}
+
+	if (
+		index !== 0 &&
+		((isObject(childObject) && isEmptyObject(childObject)) ||
+			(Array.isArray(childObject) && isEmptyArray(childObject)))
+	) {
+		unset(object, paths.slice(0, -1));
+	}
+
+	return object;
+}

package/src/utils/update.ts

@@ -0,0 +1,5 @@
+// Vendored from react-hook-form@7.81.0 src/utils/update.ts (octane port).
+export default <T>(fieldValues: T[], index: number, value: T) => {
+	fieldValues[index] = value;
+	return fieldValues;
+};

package/src/watch.tsrx

@@ -0,0 +1,7 @@
+// Vendored from react-hook-form@7.81.0 src/watch.tsx (octane port).
+// Watch component — subscribes to form field changes and re-renders when the
+// watched fields update. Authored as .tsrx (full compile) so the useWatch call
+// is slot-wrapped (see controller.tsrx note).
+import { useWatch } from './useWatch.ts';
+
+export const Watch = (props) => props.render(useWatch({ name: props.names, ...props }));

package/src/watch.tsrx.d.ts

@@ -0,0 +1,42 @@
+// Type declaration for the .tsrx component (resolved by relative path).
+import type { FieldPath, FieldValues, WatchProps } from './types';
+
+/**
+ * Watch component that subscribes to form field changes and re-renders when watched fields update.
+ *
+ * @param control - The form control object from useForm
+ * @param name - Can be field name, array of field names, or undefined to watch the entire form
+ * @param disabled - Disable subscription
+ * @param exact - Whether to watch exact field names or not
+ * @param defaultValue - The default value to use if the field is not yet set
+ * @param compute - Function to compute derived values from watched fields
+ * @param render - The function that receives watched values and returns a renderable
+ * @returns The result of calling render function with watched values
+ *
+ * @example
+ * The `Watch` component only re-renders when the values of `foo`, `bar`, and `baz.qux` change.
+ *
+ * ```tsx
+ * const { control } = useForm();
+ *
+ * <Watch
+ *   control={control}
+ *   names={['foo', 'bar', 'baz.qux']}
+ *   render={([foo, bar, baz_qux]) => <div>{foo}{bar}{baz_qux}</div>}
+ * />
+ * ```
+ */
+export declare const Watch: <
+	TFieldValues extends FieldValues = FieldValues,
+	TFieldName extends
+		| FieldPath<TFieldValues>
+		| readonly [FieldPath<TFieldValues>, ...FieldPath<TFieldValues>[]]
+		| FieldPath<TFieldValues>[]
+		| readonly FieldPath<TFieldValues>[]
+		| undefined = undefined,
+	TContext = any,
+	TTransformedValues = TFieldValues,
+	TComputeValue = undefined,
+>(
+	props: WatchProps<TFieldName, TFieldValues, TContext, TTransformedValues, TComputeValue>,
+) => unknown;