powell-react 1.0.0

package/components/Checkbox/Checkbox.tsx

@@ -0,0 +1,136 @@
+import {ChangeEvent, ReactNode, useCallback, useRef, useState} from "react";
+import {FixLabelPosition} from "@powell/models";
+import {PrimeCheckbox, PrimeCheckboxProps, primeClassNames, PrimeUniqueComponentId} from "@powell/api";
+import {transformer} from "@powell/utils";
+import {Field, FieldProps} from "formik";
+import {useApplyConfig, useFormContext} from "@powell/hooks";
+import {SafeAny} from "@powell/models/common";
+import {ErrorMessage} from "@powell/components/ErrorMessage";
+import './Checkbox.scss';
+
+interface CheckboxProps extends Omit<PrimeCheckboxProps, 'checked'> {
+  checked?: boolean;
+  name?: string;
+  parseError?: (error: string) => ReactNode;
+  transform?: {
+    input?: (value: SafeAny) => string;
+    output?: (event: ChangeEvent<HTMLInputElement>) => SafeAny;
+  };
+  showRequiredStar?: boolean;
+  rtl?: boolean;
+  label?: string;
+  hint?: string;
+  labelPosition?: FixLabelPosition;
+}
+
+export const Checkbox = (props: CheckboxProps) => {
+  props = useApplyConfig(props, {sizable: false, isFixLabel: true});
+  const {
+    parseError,
+    name,
+    transform = {},
+    labelPosition,
+    rtl,
+    showRequiredStar,
+    variant,
+    ...rest
+  } = props;
+
+  const inputId = useRef(PrimeUniqueComponentId());
+
+  // Check if we're in Formik context
+  const formContext = useFormContext();
+  const withinForm = !!formContext && !!name;
+  const isRequired = withinForm && formContext.validationSchema?.fields?.[name].tests?.some((t: SafeAny) => t.OPTIONS.name === 'required');
+
+  // Internal state for non-Formik usage
+  const [internalValue, setInternalValue] = useState(rest.checked);
+
+  const rootEl = useCallback(() => {
+    const commonProps = {
+      ...rest,
+      variant,
+      inputId: inputId.current,
+      name,
+    };
+
+    if (withinForm) {
+      // if in Formik context
+      return (
+          <Field name={name}>
+            {({field, meta}: FieldProps) => {
+              const {value, onChange} = transformer({
+                value: field.value,
+                onChange: (event: boolean) => formContext.setFieldValue(name, event),
+                transform: {
+                  input: transform.input ?? (value => value),
+                  output: transform.output ?? (event => event.target.checked)
+                }
+              });
+
+              return (
+                  <>
+                    <PrimeCheckbox
+                        {...commonProps}
+                        checked={value}
+                        onChange={(event) => {
+                          onChange(event);
+                          rest.onChange?.(event);
+                        }}
+                        invalid={!!meta.error}
+                    />
+                    <ErrorMessage message={meta.error} parseError={parseError} hint={rest.hint}/>
+                  </>
+              );
+            }}
+          </Field>
+      );
+    } else {
+      // if outside Formik context
+      const {value, onChange} = transformer({
+        value: internalValue,
+        onChange: (event: boolean) => setInternalValue(event),
+        transform: {
+          input: transform.input ?? (value => value),
+          output: transform.output ?? (event => event.target.checked)
+        }
+      });
+
+      return (
+          <PrimeCheckbox
+              {...commonProps}
+              checked={value}
+              onChange={(event) => {
+                onChange(event);
+                rest.onChange?.(event);
+              }}
+              onBlur={rest.onBlur}
+          />
+      );
+    }
+  }, [internalValue, props]);
+
+  const labelEl = rest.label && (
+      <label htmlFor={inputId.current}>
+        {rest.label}
+        {isRequired && showRequiredStar ? '*' : ''}
+      </label>
+  );
+
+  return (
+      <div className={primeClassNames('checkbox-wrapper',
+          `variant-${variant}`,
+          {
+            [`label-${labelPosition}`]: rest.label,
+            'is-rtl': rtl,
+            'is-ltr': !rtl,
+          })}>
+        <div className="field">
+          {labelEl}
+          <div className={primeClassNames('field-inner')}>
+            {rootEl()}
+          </div>
+        </div>
+      </div>
+  );
+};

package/components/Checkbox/index.ts

@@ -0,0 +1 @@
+export * from "./Checkbox";

package/components/Dropdown/Dropdown.scss

@@ -0,0 +1,126 @@
+.dropdown-wrapper {
+  .field {
+    display: flex;
+    gap: 0.25rem 1rem;
+
+    > div {
+      flex-grow: 1;
+    }
+  }
+
+  :where(.p-inputtext, .p-dropdown) {
+    width: 100%;
+  }
+
+  .p-icon-field {
+    .p-input-icon {
+      z-index: 5;
+      color: var(--text-color-secondary);
+    }
+
+    &.p-icon-field-right {
+      :where(.p-dropdown) {
+        padding-right: 2.5rem;
+      }
+
+      .p-input-icon {
+        right: 0.75rem;
+        left: auto;
+      }
+    }
+
+    &.p-icon-field-left {
+      :where(.p-dropdown) {
+        padding-left: 2.5rem;
+      }
+
+      .p-input-icon {
+        left: 0.75rem;
+        right: auto;
+      }
+    }
+  }
+
+  &.label-fix-side .field {
+    flex-direction: row;
+    align-items: center;
+  }
+
+  &.label-fix-top .field {
+    flex-direction: column;
+
+    label {
+      margin-bottom: 0.25rem;
+    }
+  }
+
+  &.addon-before {
+    [class*="icon-"] {
+      :where(.p-inputtext, .p-dropdown) {
+        border-radius: 0 var(--border-radius) var(--border-radius) 0;
+      }
+    }
+  }
+
+  &.addon-after {
+    &.label-float {
+      .p-inputgroup-addon {
+        border-left: 0;
+      }
+    }
+
+    [class*="icon-"] {
+      :where(.p-inputtext, .p-dropdown) {
+        border-radius: var(--border-radius) 0 0 var(--border-radius);
+      }
+    }
+  }
+
+  &[class*="addon-"] {
+    .p-inputgroup {
+      .p-icon-field,
+      .p-float-label {
+        flex-grow: 1;
+      }
+    }
+
+    &.addon-before :where(.p-inputtext, .p-dropdown) {
+      border-radius: 0 var(--border-radius) var(--border-radius) 0;
+    }
+
+    &.addon-after :where(.p-inputtext, .p-dropdown) {
+      border-radius: var(--border-radius) 0 0 var(--border-radius);
+    }
+  }
+
+  &.is-ltr {
+    direction: ltr;
+
+    &.label-float {
+      &.icon-left .field label {
+        left: 2.5rem;
+      }
+    }
+  }
+
+  &.is-rtl {
+    direction: rtl;
+
+    &.label-float {
+      label {
+        left: auto;
+        right: 0.75rem;
+      }
+
+      &.icon-right .field label {
+        right: 2.5rem;
+      }
+    }
+
+    &[class*="addon-"] {
+      .p-inputgroup {
+        flex-direction: row-reverse;
+      }
+    }
+  }
+}

package/components/Dropdown/Dropdown.tsx

@@ -0,0 +1,184 @@
+import {ChangeEvent, ReactNode, useCallback, useRef, useState} from "react";
+import {Addon, LabelPosition, Size} from "@powell/models";
+import {
+  primeClassNames,
+  PrimeFloatLabel,
+  PrimeIconField,
+  PrimeIconFieldProps,
+  PrimeInputIcon,
+  PrimeDropdown,
+  PrimeDropdownProps,
+  PrimeUniqueComponentId
+} from "@powell/api";
+import {getAddonTemplate, transformer} from "@powell/utils";
+import {Field, FieldProps} from "formik";
+import {useApplyConfig, useFormContext} from "@powell/hooks";
+import {SafeAny} from "@powell/models/common";
+import {ErrorMessage} from "@powell/components/ErrorMessage";
+import './Dropdown.scss';
+
+interface DropdownProps extends PrimeDropdownProps {
+  name?: string;
+  parseError?: (error: string) => ReactNode;
+  transform?: {
+    input?: (value: SafeAny) => string;
+    output?: (event: ChangeEvent<HTMLInputElement>) => SafeAny;
+  };
+  showRequiredStar?: boolean;
+  rtl?: boolean;
+  label?: string;
+  icon?: string | ReactNode;
+  hint?: string;
+  inputSize?: Size;
+  addon?: Addon;
+  iconPosition?: PrimeIconFieldProps["iconPosition"];
+  labelPosition?: LabelPosition;
+}
+
+export const Dropdown = (props: DropdownProps) => {
+  props = useApplyConfig(props);
+  const {
+    parseError,
+    name,
+    transform = {},
+    iconPosition = 'left',
+    labelPosition,
+    addon,
+    icon,
+    rtl,
+    showRequiredStar,
+    variant,
+    inputSize,
+    ...rest
+  } = props;
+
+  const inputId = useRef(PrimeUniqueComponentId());
+
+  // Check if we're in Formik context
+  const formContext = useFormContext();
+  const withinForm = !!formContext && !!name;
+  const isRequired = withinForm && formContext.validationSchema?.fields?.[name].tests?.some((t: SafeAny) => t.OPTIONS.name === 'required');
+
+  // Internal state for non-Formik usage
+  const [internalValue, setInternalValue] = useState(rest.value || '');
+
+  const rootEl = useCallback(() => {
+    const commonProps = {
+      ...rest,
+      variant,
+      id: inputId.current,
+      name,
+    };
+
+    if (withinForm) {
+      // if in Formik context
+      return (
+          <Field name={name}>
+            {({field, meta}: FieldProps) => {
+              const {value, onChange} = transformer({
+                value: field.value,
+                onChange: (event: string) => formContext.setFieldValue(name, event),
+                transform: {
+                  input: transform.input ?? (value => value),
+                  output: transform.output ?? (event => event.target.value)
+                }
+              });
+
+              return (
+                  <>
+                    <PrimeDropdown
+                        {...commonProps}
+                        value={value}
+                        onChange={(event) => {
+                          onChange(event);
+                          rest.onChange?.(event);
+                        }}
+                        onBlur={(event) => {
+                          field.onBlur(event);
+                          rest.onBlur?.(event);
+                        }}
+                        invalid={!!meta.error}
+                    />
+                    <ErrorMessage message={meta.error} parseError={parseError} hint={rest.hint}/>
+                  </>
+              );
+            }}
+          </Field>
+      );
+    } else {
+      // if outside Formik context
+      const {value, onChange} = transformer({
+        value: internalValue,
+        onChange: (event: string) => setInternalValue(event),
+        transform: {
+          input: transform.input ?? (value => value),
+          output: transform.output ?? (event => event.target.value)
+        }
+      });
+
+      return (
+          <PrimeDropdown
+              {...commonProps}
+              value={value}
+              onChange={(event) => {
+                onChange(event);
+                rest.onChange?.(event);
+              }}
+              onBlur={rest.onBlur}
+          />
+      );
+    }
+  }, [internalValue, props]);
+
+  const labelEl = rest.label && (
+      <label htmlFor={inputId.current}>
+        {rest.label}
+        {isRequired && showRequiredStar ? '*' : ''}
+      </label>
+  );
+
+  const iconEl = icon && (
+      typeof icon === 'string'
+          ? <PrimeInputIcon className={icon}></PrimeInputIcon>
+          : <PrimeInputIcon>{icon}</PrimeInputIcon>
+  );
+
+  const withIcon = (
+      <PrimeIconField iconPosition={iconPosition}>
+        {iconEl}
+        {rootEl()}
+      </PrimeIconField>
+  );
+
+  return (
+      <div className={primeClassNames('dropdown-wrapper',
+          `variant-${variant}`,
+          `p-inputtext-${inputSize}`,
+          {
+            [`label-${labelPosition}`]: rest.label,
+            [`icon-${iconPosition}`]: iconEl,
+            'is-rtl': rtl,
+            'is-ltr': !rtl,
+            'addon-before': addon?.before,
+            'addon-after': addon?.after,
+          })}>
+        <div className="field">
+          {labelPosition !== 'float' && labelEl}
+          <div className={primeClassNames('field-inner', {"p-inputgroup": addon})}>
+            {getAddonTemplate(addon?.before)}
+            {
+              labelPosition === 'float' ? (
+                  <PrimeFloatLabel>
+                    {icon ? withIcon : rootEl()}
+                    {labelEl}
+                  </PrimeFloatLabel>
+              ) : (
+                  icon ? withIcon : rootEl()
+              )
+            }
+            {getAddonTemplate(addon?.after)}
+          </div>
+        </div>
+      </div>
+  );
+};

package/components/Dropdown/index.ts

@@ -0,0 +1 @@
+export * from "./Dropdown";

package/components/ErrorMessage/ErrorMessage.scss

@@ -0,0 +1,7 @@
+.error {
+  color: rgb(185, 28, 28);
+}
+
+.hint {
+  color: rgb(156, 163, 175);
+}

package/components/ErrorMessage/ErrorMessage.tsx

@@ -0,0 +1,23 @@
+import {ReactNode} from "react";
+import "./ErrorMessage.scss";
+
+interface ErrorMessageProps {
+  message?: string;
+  parseError?: (message: string) => ReactNode;
+  hint?: string;
+}
+
+export const ErrorMessage = (props: ErrorMessageProps) => {
+  const {parseError, message, hint} = props;
+  return (
+      <>
+        {
+          message
+              ?
+              parseError?.(message) || <small className="error">{message}</small>
+              :
+              <small className="hint">{hint}</small>
+        }
+      </>
+  )
+}

package/components/ErrorMessage/index.ts

@@ -0,0 +1 @@
+export * from "./ErrorMessage";

package/components/FormContainer/FormContainer.tsx

@@ -0,0 +1,49 @@
+import {Form, Formik, FormikConfig, FormikContextType, FormikValues, useFormikContext} from "formik";
+import {ForwardedRef, forwardRef, PropsWithChildren, useEffect, useRef} from "react";
+import {FormProvider} from "@powell/components/FormContainer";
+
+interface FormContainerProps<T extends FormikValues> extends FormikConfig<T> {
+  onInit?: (context: FormikContextType<T>) => void;
+  className?: string;
+}
+
+const FormContent = <T extends FormikValues>(props: PropsWithChildren<{onInit: FormContainerProps<T>['onInit']}>) => {
+  const {children, onInit} = props;
+  const formikContext: FormikContextType<T> = useFormikContext();
+  const initialized = useRef(false);
+
+  useEffect(() => {
+    if (!initialized.current) {
+      onInit?.(formikContext);
+      initialized.current = true;
+    }
+  }, [formikContext, onInit]);
+
+  return (
+      <>
+        {children}
+      </>
+  );
+}
+
+export const FormContainer = forwardRef(<T extends FormikValues>(props: FormContainerProps<T>, ref: ForwardedRef<HTMLFormElement>) => {
+  const {children, onInit, className, ...rest} = props;
+
+  return (
+      <Formik {...rest}>
+        {
+          (context) => (
+              <FormProvider {...rest}>
+                <Form ref={ref} className={className}>
+                  {
+                    <FormContent<T> onInit={onInit}>
+                      {typeof children === 'function' ? children(context) : children}
+                    </FormContent>
+                  }
+                </Form>
+              </FormProvider>
+          )
+        }
+      </Formik>
+  )
+})

package/components/FormContainer/FormContext.tsx

@@ -0,0 +1,17 @@
+import {createContext, PropsWithChildren} from "react";
+import {FormikConfig, FormikValues} from "formik";
+
+export const FormContext = createContext<FormikConfig<FormikValues> | undefined>(undefined);
+
+export const FormProvider = <T extends FormikValues>(props: PropsWithChildren<FormikConfig<T>>) => {
+  const {children, ...rest} = props;
+
+  return (
+      <FormContext.Provider value={rest}>
+        <>
+          {children}
+        </>
+      </FormContext.Provider>
+  );
+};
+

package/components/FormContainer/index.ts

@@ -0,0 +1,2 @@
+export * from "./FormContainer";
+export * from "./FormContext";

package/components/InputText/InputText.scss

@@ -0,0 +1,126 @@
+.input-text-wrapper {
+  .field {
+    display: flex;
+    gap: 0.25rem 1rem;
+
+    > .field-inner {
+      flex-grow: 1;
+    }
+  }
+
+  :where(.p-inputtext) {
+    width: 100%;
+  }
+
+  .p-icon-field {
+    .p-input-icon {
+      z-index: 5;
+      color: var(--text-color-secondary);
+    }
+
+    &.p-icon-field-right {
+      :where(.p-inputtext) {
+        padding-right: 2.5rem;
+      }
+
+      .p-input-icon {
+        right: 0.75rem;
+        left: auto;
+      }
+    }
+
+    &.p-icon-field-left {
+      :where(.p-inputtext) {
+        padding-left: 2.5rem;
+      }
+
+      .p-input-icon {
+        left: 0.75rem;
+        right: auto;
+      }
+    }
+  }
+
+  &.label-fix-side .field {
+    flex-direction: row;
+    align-items: center;
+  }
+
+  &.label-fix-top .field {
+    flex-direction: column;
+
+    label {
+      margin-bottom: 0.25rem;
+    }
+  }
+
+  &.addon-before {
+    [class*="icon-"] {
+      :where(.p-inputtext) {
+        border-radius: 0 var(--border-radius) var(--border-radius) 0;
+      }
+    }
+  }
+
+  &.addon-after {
+    &.label-float {
+      .p-inputgroup-addon {
+        border-left: 0;
+      }
+    }
+
+    [class*="icon-"] {
+      :where(.p-inputtext) {
+        border-radius: var(--border-radius) 0 0 var(--border-radius);
+      }
+    }
+  }
+
+  &[class*="addon-"] {
+    .p-inputgroup {
+      .p-icon-field,
+      .p-float-label {
+        flex-grow: 1;
+      }
+    }
+
+    &.addon-before :where(.p-inputtext) {
+      border-radius: 0 var(--border-radius) var(--border-radius) 0;
+    }
+
+    &.addon-after :where(.p-inputtext) {
+      border-radius: var(--border-radius) 0 0 var(--border-radius);
+    }
+  }
+
+  &.is-ltr {
+    direction: ltr;
+
+    &.label-float {
+      &.icon-left .field label {
+        left: 2.5rem;
+      }
+    }
+  }
+
+  &.is-rtl {
+    direction: rtl;
+
+    &.label-float {
+      label {
+        left: auto;
+        right: 0.75rem;
+      }
+
+      &.icon-right .field label {
+        right: 2.5rem;
+      }
+    }
+
+    &[class*="addon-"] {
+      .p-inputgroup {
+        flex-direction: row-reverse;
+      }
+    }
+  }
+}