@sprawlify/react 0.0.1 → 0.0.3

package/dist/factory-B_Ye-J6y.mjs

@@ -0,0 +1,499 @@
+import { t as createContext$1 } from "./create-context-fSIoyq0R.mjs";
+import { INIT_STATE, MachineStatus, createScope, mergeProps, mergeProps as mergeProps$1 } from "@sprawlify/primitives/core";
+import { compact, ensure, identity, isFunction, isString, toArray, warn } from "@sprawlify/primitives/utils";
+import * as React$1 from "react";
+import { Children, cloneElement, createElement, forwardRef, isValidElement, memo, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { createPortal, flushSync } from "react-dom";
+import { createNormalizer } from "@sprawlify/primitives/types";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { getDocument, getWindow } from "@sprawlify/primitives/dom-query";
+import { createCollator, createFilter, isRTL } from "@sprawlify/primitives/i18n-utils";
+
+//#region src/core/use-layout-effect.ts
+const useSafeLayoutEffect = typeof globalThis.document !== "undefined" ? useLayoutEffect : useEffect;
+
+//#endregion
+//#region src/core/bindable.ts
+function useBindable(props) {
+	const initial = props().value ?? props().defaultValue;
+	const eq = props().isEqual ?? Object.is;
+	const [initialValue] = useState(initial);
+	const [value, setValue] = useState(initialValue);
+	const controlled = props().value !== void 0;
+	const valueRef = useRef(value);
+	valueRef.current = controlled ? props().value : value;
+	const prevValue = useRef(valueRef.current);
+	useSafeLayoutEffect(() => {
+		prevValue.current = valueRef.current;
+	}, [value, props().value]);
+	const setFn = (value$1) => {
+		const prev = prevValue.current;
+		const next = isFunction(value$1) ? value$1(prev) : value$1;
+		if (props().debug) console.log(`[bindable > ${props().debug}] setValue`, {
+			next,
+			prev
+		});
+		if (!controlled) setValue(next);
+		if (!eq(next, prev)) props().onChange?.(next, prev);
+	};
+	function get() {
+		return controlled ? props().value : value;
+	}
+	return {
+		initial: initialValue,
+		ref: valueRef,
+		get,
+		set(value$1) {
+			(props().sync ? flushSync : identity)(() => setFn(value$1));
+		},
+		invoke(nextValue, prevValue$1) {
+			props().onChange?.(nextValue, prevValue$1);
+		},
+		hash(value$1) {
+			return props().hash?.(value$1) ?? String(value$1);
+		}
+	};
+}
+useBindable.cleanup = (fn) => {
+	useEffect(() => fn, []);
+};
+useBindable.ref = (defaultValue) => {
+	const value = useRef(defaultValue);
+	return {
+		get: () => value.current,
+		set: (next) => {
+			value.current = next;
+		}
+	};
+};
+
+//#endregion
+//#region src/core/refs.ts
+function useRefs(refs) {
+	const ref = useRef(refs);
+	return {
+		get(key) {
+			return ref.current[key];
+		},
+		set(key, value) {
+			ref.current[key] = value;
+		}
+	};
+}
+
+//#endregion
+//#region src/core/track.ts
+const useTrack = (deps, effect) => {
+	const render = useRef(false);
+	const called = useRef(false);
+	useEffect(() => {
+		if (render.current && called.current) return effect();
+		called.current = true;
+	}, [...(deps ?? []).map((d) => typeof d === "function" ? d() : d)]);
+	useEffect(() => {
+		render.current = true;
+		return () => {
+			render.current = false;
+		};
+	}, []);
+};
+
+//#endregion
+//#region src/core/machine.ts
+function useMachine(machine, userProps = {}) {
+	const scope = useMemo(() => {
+		const { id, ids, getRootNode } = userProps;
+		return createScope({
+			id,
+			ids,
+			getRootNode
+		});
+	}, [userProps]);
+	const debug = (...args) => {
+		if (machine.debug) console.log(...args);
+	};
+	const prop = useProp(machine.props?.({
+		props: compact(userProps),
+		scope
+	}) ?? userProps);
+	const context = machine.context?.({
+		prop,
+		bindable: useBindable,
+		scope,
+		flush,
+		getContext() {
+			return ctx;
+		},
+		getComputed() {
+			return computed;
+		},
+		getRefs() {
+			return refs;
+		},
+		getEvent() {
+			return getEvent();
+		}
+	});
+	const contextRef = useLiveRef(context);
+	const ctx = {
+		get(key) {
+			return contextRef.current?.[key].ref.current;
+		},
+		set(key, value) {
+			contextRef.current?.[key].set(value);
+		},
+		initial(key) {
+			return contextRef.current?.[key].initial;
+		},
+		hash(key) {
+			const current = contextRef.current?.[key].get();
+			return contextRef.current?.[key].hash(current);
+		}
+	};
+	const effects = useRef(/* @__PURE__ */ new Map());
+	const transitionRef = useRef(null);
+	const previousEventRef = useRef(null);
+	const eventRef = useRef({ type: "" });
+	const getEvent = () => ({
+		...eventRef.current,
+		current() {
+			return eventRef.current;
+		},
+		previous() {
+			return previousEventRef.current;
+		}
+	});
+	const getState = () => ({
+		...state,
+		matches(...values) {
+			return values.includes(state.ref.current);
+		},
+		hasTag(tag) {
+			return !!machine.states[state.ref.current]?.tags?.includes(tag);
+		}
+	});
+	const refs = useRefs(machine.refs?.({
+		prop,
+		context: ctx
+	}) ?? {});
+	const getParams = () => ({
+		state: getState(),
+		context: ctx,
+		event: getEvent(),
+		prop,
+		send,
+		action,
+		guard,
+		track: useTrack,
+		refs,
+		computed,
+		flush,
+		scope,
+		choose
+	});
+	const action = (keys) => {
+		const strs = isFunction(keys) ? keys(getParams()) : keys;
+		if (!strs) return;
+		const fns = strs.map((s) => {
+			const fn = machine.implementations?.actions?.[s];
+			if (!fn) warn(`[sprawlify-js] No implementation found for action "${JSON.stringify(s)}"`);
+			return fn;
+		});
+		for (const fn of fns) fn?.(getParams());
+	};
+	const guard = (str) => {
+		if (isFunction(str)) return str(getParams());
+		return machine.implementations?.guards?.[str](getParams());
+	};
+	const effect = (keys) => {
+		const strs = isFunction(keys) ? keys(getParams()) : keys;
+		if (!strs) return;
+		const fns = strs.map((s) => {
+			const fn = machine.implementations?.effects?.[s];
+			if (!fn) warn(`[sprawlify-js] No implementation found for effect "${JSON.stringify(s)}"`);
+			return fn;
+		});
+		const cleanups = [];
+		for (const fn of fns) {
+			const cleanup = fn?.(getParams());
+			if (cleanup) cleanups.push(cleanup);
+		}
+		return () => cleanups.forEach((fn) => fn?.());
+	};
+	const choose = (transitions) => {
+		return toArray(transitions).find((t) => {
+			let result = !t.guard;
+			if (isString(t.guard)) result = !!guard(t.guard);
+			else if (isFunction(t.guard)) result = t.guard(getParams());
+			return result;
+		});
+	};
+	const computed = (key) => {
+		ensure(machine.computed, () => `[sprawlify-js] No computed object found on machine`);
+		const fn = machine.computed[key];
+		return fn({
+			context: ctx,
+			event: getEvent(),
+			prop,
+			refs,
+			scope,
+			computed
+		});
+	};
+	const state = useBindable(() => ({
+		defaultValue: machine.initialState({ prop }),
+		onChange(nextState, prevState) {
+			if (prevState) {
+				effects.current.get(prevState)?.();
+				effects.current.delete(prevState);
+			}
+			if (prevState) action(machine.states[prevState]?.exit);
+			action(transitionRef.current?.actions);
+			const cleanup = effect(machine.states[nextState]?.effects);
+			if (cleanup) effects.current.set(nextState, cleanup);
+			if (prevState === INIT_STATE) {
+				action(machine.entry);
+				const cleanup$1 = effect(machine.effects);
+				if (cleanup$1) effects.current.set(INIT_STATE, cleanup$1);
+			}
+			action(machine.states[nextState]?.entry);
+		}
+	}));
+	const hydratedStateRef = useRef(void 0);
+	const statusRef = useRef(MachineStatus.NotStarted);
+	useSafeLayoutEffect(() => {
+		queueMicrotask(() => {
+			const started = statusRef.current === MachineStatus.Started;
+			statusRef.current = MachineStatus.Started;
+			debug(started ? "rehydrating..." : "initializing...");
+			const initialState = hydratedStateRef.current ?? state.initial;
+			state.invoke(initialState, started ? state.get() : INIT_STATE);
+		});
+		const fns = effects.current;
+		const currentState = state.ref.current;
+		return () => {
+			debug("unmounting...");
+			hydratedStateRef.current = currentState;
+			statusRef.current = MachineStatus.Stopped;
+			fns.forEach((fn) => fn?.());
+			effects.current = /* @__PURE__ */ new Map();
+			transitionRef.current = null;
+			queueMicrotask(() => {
+				action(machine.exit);
+			});
+		};
+	}, []);
+	const getCurrentState = () => {
+		if ("ref" in state) return state.ref.current;
+		return state.get();
+	};
+	const send = (event) => {
+		queueMicrotask(() => {
+			if (statusRef.current !== MachineStatus.Started) return;
+			previousEventRef.current = eventRef.current;
+			eventRef.current = event;
+			const currentState = getCurrentState();
+			const transition = choose(machine.states[currentState].on?.[event.type] ?? machine.on?.[event.type]);
+			if (!transition) return;
+			transitionRef.current = transition;
+			const target = transition.target ?? currentState;
+			debug("transition", event.type, transition.target || currentState, `(${transition.actions})`);
+			const changed = target !== currentState;
+			if (changed) flushSync(() => state.set(target));
+			else if (transition.reenter && !changed) state.invoke(currentState, currentState);
+			else action(transition.actions ?? []);
+		});
+	};
+	machine.watch?.(getParams());
+	return {
+		state: getState(),
+		send,
+		context: ctx,
+		prop,
+		scope,
+		refs,
+		computed,
+		event: getEvent(),
+		getStatus: () => statusRef.current
+	};
+}
+function useLiveRef(value) {
+	const ref = useRef(value);
+	ref.current = value;
+	return ref;
+}
+function useProp(value) {
+	const ref = useLiveRef(value);
+	return function get(key) {
+		return ref.current[key];
+	};
+}
+function flush(fn) {
+	queueMicrotask(() => {
+		flushSync(() => fn());
+	});
+}
+
+//#endregion
+//#region src/core/normalize-props.ts
+const normalizeProps = createNormalizer((v) => v);
+
+//#endregion
+//#region src/core/portal.tsx
+const Portal = (props) => {
+	const { children, container, disabled, getRootNode } = props;
+	if (typeof window === "undefined" || disabled) return /* @__PURE__ */ jsx(React$1.Fragment, { children });
+	const doc = getRootNode?.().ownerDocument ?? document;
+	const mountNode = container?.current ?? doc.body;
+	return /* @__PURE__ */ jsx(React$1.Fragment, { children: React$1.Children.map(children, (child) => createPortal(child, mountNode)) });
+};
+
+//#endregion
+//#region src/utils/run-if-fn.ts
+const isFunction$1 = (value) => typeof value === "function";
+const runIfFn = (valueOrFn, ...args) => isFunction$1(valueOrFn) ? valueOrFn(...args) : valueOrFn;
+
+//#endregion
+//#region src/providers/environment/use-environment-context.ts
+const [EnvironmentContextProvider, useEnvironmentContext] = createContext$1({
+	name: "EnvironmentContext",
+	hookName: "useEnvironmentContext",
+	providerName: "<EnvironmentProvider />",
+	strict: false,
+	defaultValue: {
+		getRootNode: () => document,
+		getDocument: () => document,
+		getWindow: () => window
+	}
+});
+
+//#endregion
+//#region src/providers/environment/environment-provider.tsx
+const EnvironmentProvider = (props) => {
+	const { value, children } = props;
+	const [spanRef, setSpanRef] = useState();
+	const getRootNode = useMemo(() => {
+		return () => runIfFn(value) ?? spanRef?.getRootNode() ?? document;
+	}, [value, spanRef]);
+	return /* @__PURE__ */ jsxs(EnvironmentContextProvider, {
+		value: useMemo(() => ({
+			getRootNode,
+			getWindow: () => getWindow(getRootNode()),
+			getDocument: () => getDocument(getRootNode())
+		}), [getRootNode]),
+		children: [children, !value && /* @__PURE__ */ jsx("span", {
+			hidden: true,
+			ref: setSpanRef
+		})]
+	});
+};
+
+//#endregion
+//#region src/providers/locale/use-locale-context.ts
+const [LocaleContextProvider, useLocaleContext] = createContext$1({
+	name: "LocaleContext",
+	hookName: "useLocaleContext",
+	providerName: "<LocaleProvider />",
+	strict: false,
+	defaultValue: {
+		dir: "ltr",
+		locale: "en-US"
+	}
+});
+
+//#endregion
+//#region src/providers/locale/locale-provider.tsx
+const LocaleProvider = (props) => {
+	const { children, locale } = props;
+	return /* @__PURE__ */ jsx(LocaleContextProvider, {
+		value: {
+			locale,
+			dir: isRTL(locale) ? "rtl" : "ltr"
+		},
+		children
+	});
+};
+
+//#endregion
+//#region src/providers/locale/use-collator.ts
+function useCollator(props = {}) {
+	const env = useLocaleContext();
+	const locale = props.locale ?? env.locale;
+	return useMemo(() => {
+		const { locale: _, ...options } = props;
+		return createCollator(locale, options);
+	}, [locale, props]);
+}
+
+//#endregion
+//#region src/providers/locale/use-filter.ts
+function useFilter(props) {
+	const env = useLocaleContext();
+	const locale = props.locale ?? env.locale;
+	return useMemo(() => createFilter({
+		...props,
+		locale
+	}), [locale, props]);
+}
+
+//#endregion
+//#region src/utils/compose-refs.ts
+function composeRefs(...refs) {
+	return (node) => {
+		const cleanUps = [];
+		for (const ref of refs) if (typeof ref === "function") {
+			const cb = ref(node);
+			if (typeof cb === "function") cleanUps.push(cb);
+		} else if (ref) ref.current = node;
+		if (cleanUps.length) return () => {
+			for (const cleanUp of cleanUps) cleanUp();
+		};
+	};
+}
+
+//#endregion
+//#region src/components/factory.ts
+function getRef(element) {
+	let getter = Object.getOwnPropertyDescriptor(element.props, "ref")?.get;
+	let mayWarn = getter && "isReactWarning" in getter && getter.isReactWarning;
+	if (mayWarn) return element.ref;
+	getter = Object.getOwnPropertyDescriptor(element, "ref")?.get;
+	mayWarn = getter && "isReactWarning" in getter && getter.isReactWarning;
+	if (mayWarn) return element.props.ref;
+	return element.props.ref || element.ref;
+}
+const withAsChild = (Component) => {
+	const Comp = memo(forwardRef((props, ref) => {
+		const { asChild, children, ...restProps } = props;
+		if (!asChild) return createElement(Component, {
+			...restProps,
+			ref
+		}, children);
+		if (!isValidElement(children)) return null;
+		const onlyChild = Children.only(children);
+		const childRef = getRef(onlyChild);
+		return cloneElement(onlyChild, {
+			...mergeProps(restProps, onlyChild.props),
+			ref: ref ? composeRefs(ref, childRef) : childRef
+		});
+	}));
+	Comp.displayName = typeof Component === "string" ? Component : Component.displayName || Component.name;
+	return Comp;
+};
+const jsxFactory = () => {
+	const cache = /* @__PURE__ */ new Map();
+	return new Proxy(withAsChild, {
+		apply(_target, _thisArg, argArray) {
+			return withAsChild(argArray[0]);
+		},
+		get(_, element) {
+			const asElement = element;
+			if (!cache.has(asElement)) cache.set(asElement, withAsChild(asElement));
+			return cache.get(asElement);
+		}
+	});
+};
+const sprawlify = jsxFactory();
+
+//#endregion
+export { LocaleProvider as a, useEnvironmentContext as c, normalizeProps as d, useMachine as f, useCollator as i, mergeProps$1 as l, sprawlify as n, useLocaleContext as o, useFilter as r, EnvironmentProvider as s, jsxFactory as t, Portal as u };