@jsenv/navi 0.0.1 → 0.1.1

package/src/components/field/checkbox_list.jsx

@@ -0,0 +1,184 @@
+// TOFIX: select in data then reset, it reset to red/blue instead of red/blue/green
+
+import { forwardRef } from "preact/compat";
+import {
+  useContext,
+  useImperativeHandle,
+  useRef,
+  useState,
+} from "preact/hooks";
+
+import { useActionStatus } from "../../use_action_status.js";
+import { requestAction } from "../../validation/custom_constraint_validation.js";
+import { renderActionableComponent } from "../action_execution/render_actionable_component.jsx";
+import { useActionBoundToOneArrayParam } from "../action_execution/use_action.js";
+import { useExecuteAction } from "../action_execution/use_execute_action.js";
+import { InputCheckbox } from "./input_checkbox.jsx";
+import { useActionEvents } from "./use_action_events.js";
+import {
+  DisabledContext,
+  FieldNameContext,
+  LoadingContext,
+  LoadingElementContext,
+  ParentUIStateControllerContext,
+  ReadOnlyContext,
+  RequiredContext,
+  UIStateContext,
+  UIStateControllerContext,
+  useUIGroupStateController,
+  useUIState,
+} from "./use_ui_state_controller.js";
+
+import.meta.css = /* css */ `
+  .navi_checkbox_list {
+    display: flex;
+    flex-direction: column;
+  }
+`;
+
+export const CheckboxList = forwardRef((props, ref) => {
+  const uiStateController = useUIGroupStateController(props, "checkbox_list", {
+    childComponentType: "checkbox",
+    aggregateChildStates: (childUIStateControllers) => {
+      const values = [];
+      for (const childUIStateController of childUIStateControllers) {
+        if (childUIStateController.uiState) {
+          values.push(childUIStateController.uiState);
+        }
+      }
+      return values.length === 0 ? undefined : values;
+    },
+  });
+  const uiState = useUIState(uiStateController);
+
+  const checkboxList = renderActionableComponent(props, ref, {
+    Basic: CheckboxListBasic,
+    WithAction: CheckboxListWithAction,
+    InsideForm: CheckboxListInsideForm,
+  });
+  return (
+    <UIStateControllerContext.Provider value={uiStateController}>
+      <UIStateContext.Provider value={uiState}>
+        {checkboxList}
+      </UIStateContext.Provider>
+    </UIStateControllerContext.Provider>
+  );
+});
+export const Checkbox = InputCheckbox;
+
+const CheckboxListBasic = forwardRef((props, ref) => {
+  const contextReadOnly = useContext(ReadOnlyContext);
+  const contextDisabled = useContext(DisabledContext);
+  const contextLoading = useContext(LoadingContext);
+  const uiStateController = useContext(UIStateControllerContext);
+  const { name, readOnly, disabled, required, loading, children, ...rest } =
+    props;
+  const innerRef = useRef();
+  useImperativeHandle(ref, () => innerRef.current);
+
+  const innerLoading = loading || contextLoading;
+  const innerReadOnly =
+    readOnly || contextReadOnly || innerLoading || uiStateController.readOnly;
+  const innerDisabled = disabled || contextDisabled;
+
+  return (
+    <div
+      {...rest}
+      ref={innerRef}
+      name={name}
+      className="navi_checkbox_list"
+      data-checkbox-list
+      // eslint-disable-next-line react/no-unknown-property
+      onresetuistate={(e) => {
+        uiStateController.resetUIState(e);
+      }}
+    >
+      <ParentUIStateControllerContext.Provider value={uiStateController}>
+        <FieldNameContext.Provider value={name}>
+          <ReadOnlyContext.Provider value={innerReadOnly}>
+            <DisabledContext.Provider value={innerDisabled}>
+              <RequiredContext.Provider value={required}>
+                <LoadingContext.Provider value={innerLoading}>
+                  {children}
+                </LoadingContext.Provider>
+              </RequiredContext.Provider>
+            </DisabledContext.Provider>
+          </ReadOnlyContext.Provider>
+        </FieldNameContext.Provider>
+      </ParentUIStateControllerContext.Provider>
+    </div>
+  );
+});
+
+const CheckboxListWithAction = forwardRef((props, ref) => {
+  const uiStateController = useContext(UIStateControllerContext);
+  const uiState = useContext(UIStateContext);
+  const {
+    action,
+    actionErrorEffect,
+    onCancel,
+    onActionPrevented,
+    onActionStart,
+    onActionAbort,
+    onActionError,
+    onActionEnd,
+    loading,
+    children,
+    ...rest
+  } = props;
+  const innerRef = useRef();
+  useImperativeHandle(ref, () => innerRef.current);
+  const [boundAction] = useActionBoundToOneArrayParam(action, uiState);
+  const { loading: actionLoading } = useActionStatus(boundAction);
+  const executeAction = useExecuteAction(innerRef, {
+    errorEffect: actionErrorEffect,
+  });
+  const [actionRequester, setActionRequester] = useState(null);
+
+  useActionEvents(innerRef, {
+    onCancel: (e, reason) => {
+      uiStateController.resetUIState(e);
+      onCancel?.(e, reason);
+    },
+    onPrevented: onActionPrevented,
+    onAction: (actionEvent) => {
+      setActionRequester(actionEvent.detail.requester);
+      executeAction(actionEvent);
+    },
+    onStart: onActionStart,
+    onAbort: (e) => {
+      uiStateController.resetUIState(e);
+      onActionAbort?.(e);
+    },
+    onError: (e) => {
+      uiStateController.resetUIState(e);
+      onActionError?.(e);
+    },
+    onEnd: (e) => {
+      onActionEnd?.(e);
+    },
+  });
+
+  return (
+    <CheckboxListBasic
+      data-action={boundAction.name}
+      {...rest}
+      ref={innerRef}
+      onChange={(event) => {
+        const checkboxList = innerRef.current;
+        const checkbox = event.target;
+        requestAction(checkboxList, boundAction, {
+          event,
+          requester: checkbox,
+          actionOrigin: "action_prop",
+        });
+      }}
+      loading={loading || actionLoading}
+    >
+      <LoadingElementContext.Provider value={actionRequester}>
+        {children}
+      </LoadingElementContext.Provider>
+    </CheckboxListBasic>
+  );
+});
+const CheckboxListInsideForm = CheckboxListBasic;

package/src/components/{collect_form_element_values.js → field/collect_form_element_values.js}

@@ -72,8 +72,11 @@ const getFormElementValue = (formElement) => {
 };
 
 const getValue = (formElement) => {
-  const hasDataFormValueAttribute = formElement.hasAttribute("data-form-value");
-  return hasDataFormValueAttribute
-    ? formElement.getAttribute("data-form-value")
-    : formElement.value;
+  const hasDataValueAttribute = formElement.hasAttribute("data-value");
+  if (hasDataValueAttribute) {
+    // happens for "datetime-local" inputs to keep the timezone
+    // consistent when sending to the server
+    return formElement.getAttribute("data-value");
+  }
+  return formElement.value;
 };

package/src/components/{input → field}/field_css.js

@@ -112,7 +112,10 @@ import.meta.css = /* css */ `
   [data-field-with-hover]:disabled:hover,
   [data-field-with-hover][data-disabled]:hover {
     outline-color: var(--field-disabled-border-color);
-    background-color: var(--field-disabled-background-color);
     color: var(--field-disabled-text-color);
   }
+  [data-field-with-background]:disabled,
+  [data-field-with-background][disabled] {
+    background-color: var(--field-disabled-background-color);
+  }
 `;

package/src/components/field/form.jsx

@@ -0,0 +1,211 @@
+/**
+ *
+ * Here we want the same behaviour as web standards:
+ *
+ * 1. When submitting the form URL does not change
+ * 2. When form submission id done user is redirected (by default the current one)
+ *    (we can configure this using target)
+ *    So for example user might be reidrect to a page with the resource he just created
+ *    I could create an example where we would put a link on the page to let user see what he created
+ *    but by default user stays on the form allowing to create multiple resources at once
+ *    And an other where he is redirected to the resource he created
+ * 3. If form submission fails ideally we should display this somewhere on the UI
+ *    right now it's just logged to the console I need to see how we can achieve this
+ */
+
+import { forwardRef } from "preact/compat";
+import { useContext, useImperativeHandle, useMemo, useRef } from "preact/hooks";
+
+import { requestAction } from "../../validation/custom_constraint_validation.js";
+import { useConstraints } from "../../validation/hooks/use_constraints.js";
+import { FormContext } from "../action_execution/form_context.js";
+import { renderActionableComponent } from "../action_execution/render_actionable_component.jsx";
+import { useActionBoundToOneParam } from "../action_execution/use_action.js";
+import { useExecuteAction } from "../action_execution/use_execute_action.js";
+import { collectFormElementValues } from "./collect_form_element_values.js";
+import {
+  useActionEvents,
+  useRequestedActionStatus,
+} from "./use_action_events.js";
+import {
+  LoadingContext,
+  LoadingElementContext,
+  ParentUIStateControllerContext,
+  ReadOnlyContext,
+  UIStateContext,
+  UIStateControllerContext,
+  useUIGroupStateController,
+  useUIState,
+} from "./use_ui_state_controller.js";
+
+export const Form = forwardRef((props, ref) => {
+  const uiStateController = useUIGroupStateController(props, "form", {
+    childComponentType: "*",
+    aggregateChildStates: (childUIStateControllers) => {
+      const formValues = {};
+      for (const childUIStateController of childUIStateControllers) {
+        const { name, uiState } = childUIStateController;
+        if (!name) {
+          console.warn(
+            "A form child component is missing a name property, its state won't be included in the form state",
+            childUIStateController,
+          );
+          continue;
+        }
+        formValues[name] = uiState;
+      }
+      return formValues;
+    },
+  });
+  const uiState = useUIState(uiStateController);
+
+  const form = renderActionableComponent(props, ref, {
+    Basic: FormBasic,
+    WithAction: FormWithAction,
+  });
+  return (
+    <UIStateControllerContext.Provider value={uiStateController}>
+      <UIStateContext.Provider value={uiState}>{form}</UIStateContext.Provider>
+    </UIStateControllerContext.Provider>
+  );
+});
+
+const FormBasic = forwardRef((props, ref) => {
+  const uiStateController = useContext(UIStateControllerContext);
+  const { readOnly, loading, children, ...rest } = props;
+  const innerRef = useRef();
+  useImperativeHandle(ref, () => innerRef.current);
+
+  // instantiation validation to:
+  // - receive "requestsubmit" custom event ensure submit is prevented
+  // (and also execute action without validation if form.submit() is ever called)
+  useConstraints(innerRef, []);
+
+  const innerReadOnly = readOnly || loading;
+
+  const formContextValue = useMemo(() => {
+    return { loading };
+  }, [loading]);
+
+  return (
+    <form
+      {...rest}
+      ref={innerRef}
+      onReset={(e) => {
+        // browser would empty all fields to their default values (likely empty/unchecked)
+        // we want to reset to the last known external state instead
+        e.preventDefault();
+        uiStateController.resetUIState(e);
+      }}
+    >
+      <ParentUIStateControllerContext.Provider value={uiStateController}>
+        <ReadOnlyContext.Provider value={innerReadOnly}>
+          <LoadingContext.Provider value={loading}>
+            <FormContext.Provider value={formContextValue}>
+              {children}
+            </FormContext.Provider>
+          </LoadingContext.Provider>
+        </ReadOnlyContext.Provider>
+      </ParentUIStateControllerContext.Provider>
+    </form>
+  );
+});
+
+const FormWithAction = forwardRef((props, ref) => {
+  const uiStateController = useContext(UIStateControllerContext);
+  const uiState = useContext(UIStateContext);
+  const {
+    action,
+    method,
+    actionErrorEffect = "show_validation_message", // "show_validation_message" or "throw"
+    onActionPrevented,
+    onActionStart,
+    onActionAbort,
+    onActionError,
+    onActionEnd,
+    loading,
+    children,
+    ...rest
+  } = props;
+  const innerRef = useRef();
+  useImperativeHandle(ref, () => innerRef.current);
+  const [actionBoundToUIState] = useActionBoundToOneParam(action, uiState);
+  const executeAction = useExecuteAction(innerRef, {
+    errorEffect: actionErrorEffect,
+  });
+  const { actionPending, actionRequester: formActionRequester } =
+    useRequestedActionStatus(innerRef);
+
+  useActionEvents(innerRef, {
+    onPrevented: onActionPrevented,
+    onRequested: (e) => {
+      const form = innerRef.current;
+      requestAction(form, actionBoundToUIState, {
+        requester: e.detail?.requester,
+        event: e.detail?.event || e,
+        meta: e.detail?.meta,
+        actionOrigin: e.detail?.actionOrigin,
+      });
+    },
+    onAction: (e) => {
+      const form = innerRef.current;
+      const formElementValues = collectFormElementValues(form);
+      uiStateController.setUIState(formElementValues, e);
+      executeAction(e);
+    },
+    onStart: onActionStart,
+    onAbort: (e) => {
+      // user might want to re-submit as is
+      // or change the ui state before re-submitting
+      // we can't decide for him
+      onActionAbort?.(e);
+    },
+    onError: (e) => {
+      // user might want to re-submit as is
+      // or change the ui state before re-submitting
+      // we can't decide for him
+      onActionError?.(e);
+    },
+    onEnd: (e) => {
+      // form side effect is a success
+      // we can get rid of the nav state
+      // that was keeping the ui state in case user navigates away without submission
+      uiStateController.actionEnd(e);
+      onActionEnd?.(e);
+    },
+  });
+  const innerLoading = loading || actionPending;
+
+  return (
+    <FormBasic
+      data-action={actionBoundToUIState.name}
+      data-method={action.meta?.httpVerb || method || "GET"}
+      {...rest}
+      ref={innerRef}
+      loading={innerLoading}
+      onrequestsubmit={(e) => {
+        // prevent "submit" event that would be dispatched by the browser after form.requestSubmit()
+        // (not super important because our <form> listen the "action" and do does preventDefault on "submit")
+        e.preventDefault();
+        requestAction(e.target, actionBoundToUIState, {
+          event: e,
+          actionOrigin: "action_prop",
+        });
+      }}
+    >
+      <LoadingElementContext.Provider value={formActionRequester}>
+        {children}
+      </LoadingElementContext.Provider>
+    </FormBasic>
+  );
+});
+
+// const dispatchCustomEventOnFormAndFormElements = (type, options) => {
+//   const form = innerRef.current;
+//   const customEvent = new CustomEvent(type, options);
+//   // https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/elements
+//   for (const element of form.elements) {
+//     element.dispatchEvent(customEvent);
+//   }
+//   form.dispatchEvent(customEvent);
+// };

package/src/components/{input → field}/input.jsx

@@ -1,4 +1,5 @@
 import { forwardRef } from "preact/compat";
+
 import { InputCheckbox } from "./input_checkbox.jsx";
 import { InputRadio } from "./input_radio.jsx";
 import { InputTextual } from "./input_textual.jsx";