@okta/odyssey-react-mui 1.32.0 → 1.33.0

package/src/FileUploader/FileUploader.tsx

@@ -1,311 +0,0 @@
-/*!
- * Copyright (c) 2022-present, Okta, Inc. and/or its affiliates. All rights reserved.
- * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
- *
- * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
- * See the License for the specific language governing permissions and limitations under the License.
- */
-
-import {
-  memo,
-  ChangeEvent,
-  useCallback,
-  useEffect,
-  useRef,
-  useState,
-} from "react";
-import styled from "@emotion/styled";
-import { useTranslation } from "react-i18next";
-
-import { Button } from "../Buttons/index.js";
-import { UploadIcon } from "../icons.generated/index.js";
-import { Field, RenderFieldComponentProps } from "../Field.js";
-import { FieldComponentProps } from "../FieldComponentProps.js";
-import { FileUploadPreview } from "./FileUploadPreview.js";
-import { FileUploadIllustration } from "./FileUploadIllustration.js";
-import {
-  useOdysseyDesignTokens,
-  DesignTokens,
-} from "../OdysseyDesignTokensContext.js";
-import { Support } from "../Typography.js";
-
-export const fileUploadTypes = ["single", "multiple"] as const;
-export const fileUploadVariants = [
-  "button",
-  "dragAndDrop",
-  "dragAndDropWithIcon",
-] as const;
-
-const BaseInputWrapper = styled.div({
-  position: "relative",
-  alignSelf: "flex-start",
-
-  input: {
-    position: "absolute",
-    width: "100%",
-    height: "100%",
-    opacity: 0,
-  },
-});
-
-const InputContainer = styled(BaseInputWrapper)<{
-  odysseyDesignTokens: DesignTokens;
-  hasError: boolean;
-}>(
-  {
-    display: "flex",
-    alignSelf: "unset",
-    alignItems: "center",
-    justifyContent: "center",
-
-    "&:has(input:focus)": {
-      borderStyle: "solid",
-    },
-  },
-  ({ hasError, odysseyDesignTokens }) => ({
-    padding: `${odysseyDesignTokens.Spacing6} ${odysseyDesignTokens.Spacing3}`,
-    border: hasError
-      ? `1px solid ${odysseyDesignTokens.PaletteDangerMain}`
-      : `1px dashed ${odysseyDesignTokens.HueNeutral300}`,
-    borderRadius: odysseyDesignTokens.BorderRadiusMain,
-    transition: `border-color ${odysseyDesignTokens.TransitionTimingMain}, box-shadow ${odysseyDesignTokens.TransitionTimingMain}`,
-
-    "&:hover": {
-      borderColor: odysseyDesignTokens.HueNeutral700,
-    },
-
-    "&:has(input:focus)": {
-      borderColor: odysseyDesignTokens.FocusOutlineColorPrimary,
-      boxShadow: `0 0 0 1px ${odysseyDesignTokens.FocusOutlineColorPrimary}`,
-      outline: `${odysseyDesignTokens.FocusOutlineWidthMain} ${odysseyDesignTokens.FocusOutlineStyle} transparent`,
-      outlineOffset: odysseyDesignTokens.FocusOutlineOffsetTight,
-    },
-
-    "&:has(input:disabled)": {
-      backgroundColor: odysseyDesignTokens.HueNeutral50,
-      border: `1px solid ${odysseyDesignTokens.BorderColorDisabled}`,
-      color: odysseyDesignTokens.TypographyColorDisabled,
-
-      "&:hover": {
-        borderColor: odysseyDesignTokens.BorderColorDisabled,
-      },
-    },
-  }),
-);
-
-const ButtonAndInfoContainer = styled.div({
-  display: "flex",
-  flexDirection: "column",
-  alignItems: "center",
-  justifyContent: "center",
-});
-
-const CenterAlignedSupportText = styled.div({
-  textAlign: "center",
-});
-
-export type FileUploaderProps = {
-  /**
-   * an array of file types the user is able to upload. @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/accept#unique_file_type_specifiers for examples
-   */
-  acceptedFileTypes?: string[];
-  /**
-   * The label for the `input` element.
-   */
-  label: string;
-  /**
-   * Function that is called when the list of ifles to upload is changed
-   */
-  onChange: (files: File[]) => void;
-  /**
-   * Either `single` or `multiple`. If `multiple`, multiple files can be uploaded
-   */
-  type?: (typeof fileUploadTypes)[number];
-  /**
-   * Either `button`, `dragAndDrop` or `dragAndDropWithIcon`. Will determine how component appears visually
-   */
-  variant: (typeof fileUploadVariants)[number];
-} & Pick<
-  FieldComponentProps,
-  | "errorMessage"
-  | "hint"
-  | "HintLinkComponent"
-  | "id"
-  | "isDisabled"
-  | "isFullWidth"
-  | "isOptional"
->;
-
-const FileUploader = ({
-  acceptedFileTypes,
-  errorMessage,
-  id,
-  isDisabled = false,
-  isFullWidth,
-  isOptional,
-  hint,
-  HintLinkComponent,
-  label,
-  onChange,
-  type,
-  variant,
-}: FileUploaderProps) => {
-  const odysseyDesignTokens = useOdysseyDesignTokens();
-  const { t } = useTranslation();
-  const inputRef = useRef<HTMLInputElement>(null);
-  const [filesToUpload, setFilesToUpload] = useState<File[]>([]);
-
-  useEffect(() => {
-    onChange(filesToUpload);
-  }, [filesToUpload, onChange]);
-
-  const updateFilesToUpload = useCallback(
-    (event: ChangeEvent<HTMLInputElement>) => {
-      const { files } = event.target;
-
-      if (files && files.length > 0) {
-        const mergedFiles =
-          type === "multiple"
-            ? filesToUpload.concat(Array.from(files))
-            : Array.from(files).slice();
-
-        setFilesToUpload(mergedFiles);
-      }
-
-      // reset input value to allow re-upload of a file with the same name
-      event.target.value = "";
-    },
-    [type, filesToUpload],
-  );
-
-  const triggerFileInputClick = useCallback(() => {
-    inputRef.current?.click();
-  }, [inputRef]);
-
-  const removeFileFromFilesToUploadList = useCallback<(name: string) => void>(
-    (name) => {
-      const deletedFileFilteredOut = filesToUpload.filter(
-        (file) => file.name !== name,
-      );
-      setFilesToUpload(deletedFileFilteredOut);
-    },
-    [filesToUpload],
-  );
-
-  const renderFileInput = useCallback(
-    ({
-      ariaDescribedBy,
-      errorMessageElementId,
-      id,
-      labelElementId,
-    }: RenderFieldComponentProps) => {
-      const acceptedFileTypesAsString = acceptedFileTypes?.join(",");
-
-      const Input = () => (
-        <input
-          accept={acceptedFileTypesAsString}
-          aria-describedby={ariaDescribedBy}
-          aria-errormessage={errorMessageElementId}
-          aria-labelledby={labelElementId}
-          disabled={isDisabled}
-          id={id}
-          multiple={type === "multiple"}
-          onChange={updateFilesToUpload}
-          ref={inputRef}
-          title=""
-          type="file"
-        />
-      );
-
-      if (variant === "button") {
-        return (
-          <>
-            <BaseInputWrapper>
-              <Input />
-              <Button
-                isDisabled={isDisabled}
-                label={t("fileupload.button.text")}
-                onClick={triggerFileInputClick}
-                startIcon={<UploadIcon />}
-                variant="secondary"
-              />
-            </BaseInputWrapper>
-          </>
-        );
-      }
-
-      return (
-        <>
-          <InputContainer
-            hasError={Boolean(errorMessage)}
-            odysseyDesignTokens={odysseyDesignTokens}
-          >
-            <Input />
-            <ButtonAndInfoContainer>
-              {variant === "dragAndDropWithIcon" && <FileUploadIllustration />}
-              <CenterAlignedSupportText>
-                <Support color="textSecondary">
-                  {t("fileupload.prompt.text")}
-                </Support>
-              </CenterAlignedSupportText>
-              <Button
-                isDisabled={isDisabled}
-                label={t("fileupload.button.text")}
-                onClick={triggerFileInputClick}
-                startIcon={<UploadIcon />}
-                variant="secondary"
-              />
-            </ButtonAndInfoContainer>
-          </InputContainer>
-        </>
-      );
-    },
-    [
-      acceptedFileTypes,
-      errorMessage,
-      isDisabled,
-      inputRef,
-      odysseyDesignTokens,
-      triggerFileInputClick,
-      t,
-      type,
-      updateFilesToUpload,
-      variant,
-    ],
-  );
-
-  return (
-    <>
-      <Field
-        errorMessage={errorMessage}
-        fieldType="single"
-        hasVisibleLabel
-        hint={hint}
-        HintLinkComponent={HintLinkComponent}
-        id={id}
-        isDisabled={isDisabled}
-        isFullWidth={isFullWidth && variant !== "button"}
-        isOptional={isOptional}
-        label={label}
-        renderFieldComponent={renderFileInput}
-      />
-      {filesToUpload.length > 0 && (
-        <FileUploadPreview
-          fileNames={filesToUpload.map((file) => file.name)}
-          onFileRemove={removeFileFromFilesToUploadList}
-          isDisabled={isDisabled}
-        />
-      )}
-    </>
-  );
-};
-
-const MemoizedFileUploader = memo(FileUploader);
-MemoizedFileUploader.displayName = "FileUploader";
-
-export { MemoizedFileUploader as FileUpload };
-export { MemoizedFileUploader as FileUploader };

package/src/FileUploader/index.ts

@@ -1,13 +0,0 @@
-/*!
- * Copyright (c) 2022-present, Okta, Inc. and/or its affiliates. All rights reserved.
- * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
- *
- * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
- * See the License for the specific language governing permissions and limitations under the License.
- */
-
-export * from "./FileUploader.js";

package/src/Form.tsx

@@ -1,185 +0,0 @@
-/*!
- * Copyright (c) 2022-present, Okta, Inc. and/or its affiliates. All rights reserved.
- * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
- *
- * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
- * See the License for the specific language governing permissions and limitations under the License.
- */
-
-import { FormEventHandler, memo, ReactElement } from "react";
-import styled from "@emotion/styled";
-
-import { Button } from "./Buttons/index.js";
-import { Callout } from "./Callout.js";
-import { FieldComponentProps } from "./FieldComponentProps.js";
-import type { HtmlProps } from "./HtmlProps.js";
-import { Heading4, Support } from "./Typography.js";
-import { useUniqueId } from "./useUniqueId.js";
-import {
-  useOdysseyDesignTokens,
-  DesignTokens,
-} from "./OdysseyDesignTokensContext.js";
-
-export const formEncodingTypeValues = [
-  "application/x-www-form-urlencoded",
-  "application/json",
-  "multipart/form-data",
-  "text/plain",
-] as const;
-export const formAutoCompleteTypeValues = ["on", "off"] as const;
-export const formMethodValues = ["post", "get", "dialog"] as const;
-
-const StyledForm = styled.form<{
-  isFullWidth?: boolean;
-  odysseyDesignTokens: DesignTokens;
-}>(({ isFullWidth, odysseyDesignTokens }) => ({
-  maxWidth: isFullWidth ? "100%" : odysseyDesignTokens.TypographyLineLengthMax,
-  margin: 0,
-  padding: 0,
-}));
-
-const TitleContainer = styled.div<{
-  odysseyDesignTokens: DesignTokens;
-}>(({ odysseyDesignTokens }) => ({
-  marginBlockEnd: odysseyDesignTokens.Spacing4,
-}));
-
-const FormActionContainer = styled.div<{
-  odysseyDesignTokens: DesignTokens;
-}>(
-  {
-    display: "flex",
-    justifyContent: "flex-end",
-  },
-  ({ odysseyDesignTokens }) => ({
-    gap: odysseyDesignTokens.Spacing1,
-    marginBlockStart: odysseyDesignTokens.Spacing7,
-  }),
-);
-
-export type FormProps = {
-  /**
-   * A Callout indicating a Form-wide error or status update.
-   */
-  alert?: ReactElement<typeof Callout>;
-  /**
-   * Indicates whether input elements can by default have their values automatically completed by the browser.
-   * `autocomplete` attributes on form elements override it on <form>
-   */
-  autoCompleteType?: (typeof formAutoCompleteTypeValues)[number];
-  /**
-   * The Field or FieldSet components within the Form
-   */
-  children: ReactElement | Array<ReactElement>;
-  /**
-   * A supplementary description
-   */
-  description?: string;
-  /**
-   * If the value of the method attribute is post, enctype is the MIME type of the form submission.
-   * This value can be overridden by formenctype attributes on <button>, <input type="submit">, or <input type="image"> elements.
-   */
-  encodingType?: (typeof formEncodingTypeValues)[number];
-  /**
-   * The Field or FieldGroup components within the Form
-   */
-  formActions?:
-    | ReactElement<typeof Button>
-    | Array<ReactElement<typeof Button>>;
-  /**
-   * Defines a unique identifier (ID) which must be unique in the whole document.
-   */
-  id?: string;
-  /**
-   * The HTTP method to submit the form with.
-   * This value is overridden by formmethod attributes on <button>, <input type="submit">, or <input type="image"> elements.
-   */
-  method?: (typeof formMethodValues)[number];
-  /**
-   * The name of the form. The value must not be the empty string, and must be unique among the form elements in the forms collection that it is in, if any.
-   */
-  name: string;
-  /**
-   * This Boolean attribute indicates that the form shouldn't be validated when submitted.
-   * If this attribute is not set (and therefore the form is validated),
-   * it can be overridden by a formnovalidate attribute on a <button>, <input type="submit">, or <input type="image"> element belonging to the form.
-   */
-  noValidate?: boolean;
-  /**
-   * Callback that passes the submit event to the consumer
-   */
-  onSubmit?: FormEventHandler<HTMLFormElement>;
-  /**
-   * Indicates where to display the response after submitting the form. It is a name/keyword for a browsing context (for example, tab, window, or iframe).
-   * This value can be overridden by a formtarget attribute on a <button>, <input type="submit">, or <input type="image"> element.
-   */
-  target?: string;
-  /**
-   * The title of the Form
-   */
-  title?: string;
-} & Pick<FieldComponentProps, "isFullWidth"> &
-  Pick<HtmlProps, "testId" | "translate">;
-
-const Form = ({
-  alert,
-  autoCompleteType,
-  children,
-  description,
-  encodingType,
-  formActions,
-  id: idOverride,
-  isFullWidth,
-  method,
-  name,
-  noValidate = false,
-  onSubmit,
-  target,
-  testId,
-  title,
-  translate,
-}: FormProps) => {
-  const id = useUniqueId(idOverride);
-  const odysseyDesignTokens = useOdysseyDesignTokens();
-
-  return (
-    <StyledForm
-      autoComplete={autoCompleteType}
-      data-se={testId}
-      encType={encodingType}
-      id={id}
-      isFullWidth={isFullWidth}
-      method={method}
-      name={name}
-      noValidate={noValidate}
-      odysseyDesignTokens={odysseyDesignTokens}
-      onSubmit={onSubmit}
-      target={target}
-    >
-      <TitleContainer odysseyDesignTokens={odysseyDesignTokens}>
-        {title && (
-          <Heading4 component="h1" translate={translate}>
-            {title}
-          </Heading4>
-        )}
-        {description && <Support translate={translate}>{description}</Support>}
-        {alert}
-      </TitleContainer>
-      <div>{children}</div>
-      {formActions && (
-        <FormActionContainer odysseyDesignTokens={odysseyDesignTokens}>
-          {formActions}
-        </FormActionContainer>
-      )}
-    </StyledForm>
-  );
-};
-
-const MemoizedForm = memo(Form);
-MemoizedForm.displayName = "Form";
-
-export { MemoizedForm as Form };

package/src/FormCheckedProps.ts

@@ -1,59 +0,0 @@
-/*!
- * Copyright (c) 2023-present, Okta, Inc. and/or its affiliates. All rights reserved.
- * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
- *
- * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
- * See the License for the specific language governing permissions and limitations under the License.
- */
-
-import { SwitchBaseProps } from "@mui/material/internal/SwitchBase.js";
-
-type SwitchOnChangeProp = Pick<SwitchBaseProps, "onChange">;
-
-export type ControlledCheckedFieldProps<
-  TogglableInputElement extends SwitchOnChangeProp,
-> = {
-  /**
-   * Sets the checked state of the Checkbox
-   */
-  isChecked: boolean;
-  /**
-   * Determines whether the Checkbox is checked
-   * Should not be used if `isChecked` is used
-   */
-  isDefaultChecked?: never;
-  /**
-   * The change event handler for the Checkbox
-   * Must be used if `isChecked` is used
-   */
-  onChange: TogglableInputElement["onChange"];
-};
-
-export type UncontrolledCheckedFieldProps<
-  TogglableInputElement extends SwitchOnChangeProp,
-> = {
-  /**
-   * Sets the checked state of the Checkbox
-   */
-  isChecked?: never;
-  /**
-   * Determines whether the Checkbox is checked
-   * Should not be used if `isChecked` is used
-   */
-  isDefaultChecked?: boolean;
-  /**
-   * The change event handler for the Checkbox
-   * Must be used if `isChecked` is used
-   */
-  onChange?: TogglableInputElement["onChange"];
-};
-
-export type CheckedFieldProps<
-  TogglableInputElement extends SwitchOnChangeProp,
-> =
-  | ControlledCheckedFieldProps<TogglableInputElement>
-  | UncontrolledCheckedFieldProps<TogglableInputElement>;

package/src/HintLink.tsx

@@ -1,28 +0,0 @@
-/*!
- * Copyright (c) 2022-present, Okta, Inc. and/or its affiliates. All rights reserved.
- * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
- *
- * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
- * See the License for the specific language governing permissions and limitations under the License.
- */
-
-import { memo } from "react";
-
-import { Link, LinkProps } from "./Link.js";
-
-const HintLink = (
-  props: Pick<
-    LinkProps,
-    "children" | "href" | "onClick" | "rel" | "target" | "testId"
-  >,
-) => <Link {...props} variant="default" />;
-
-const MemoizedHintLink = memo(HintLink);
-
-MemoizedHintLink.displayName = "HintLink";
-
-export { MemoizedHintLink as HintLink };