dce-reactkit 2.0.12 → 3.0.0-beta.1

package/lib/types/ParamType.d.ts

@@ -1,17 +0,0 @@
-/**
- * API param types
- * @author Gabe Abrams
- */
-declare enum ParamType {
-    Boolean = "boolean",
-    BooleanOptional = "boolean-optional",
-    Float = "float",
-    FloatOptional = "float-optional",
-    Int = "int",
-    IntOptional = "int-optional",
-    JSON = "json",
-    JSONOptional = "json-optional",
-    String = "string",
-    StringOptional = "string-optional"
-}
-export default ParamType;

package/lib/types/ParamType.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * API param types
- * @author Gabe Abrams
- */
-var ParamType;
-(function (ParamType) {
-    ParamType["Boolean"] = "boolean";
-    ParamType["BooleanOptional"] = "boolean-optional";
-    ParamType["Float"] = "float";
-    ParamType["FloatOptional"] = "float-optional";
-    ParamType["Int"] = "int";
-    ParamType["IntOptional"] = "int-optional";
-    ParamType["JSON"] = "json";
-    ParamType["JSONOptional"] = "json-optional";
-    ParamType["String"] = "string";
-    ParamType["StringOptional"] = "string-optional";
-})(ParamType || (ParamType = {}));
-exports.default = ParamType;
-//# sourceMappingURL=ParamType.js.map

package/lib/types/ParamType.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ParamType.js","sourceRoot":"","sources":["../../src/types/ParamType.ts"],"names":[],"mappings":";;AAAA;;;GAGG;AACH,IAAK,SAWJ;AAXD,WAAK,SAAS;IACZ,gCAAmB,CAAA;IACnB,iDAAoC,CAAA;IACpC,4BAAe,CAAA;IACf,6CAAgC,CAAA;IAChC,wBAAW,CAAA;IACX,yCAA4B,CAAA;IAC5B,0BAAa,CAAA;IACb,2CAA8B,CAAA;IAC9B,8BAAiB,CAAA;IACjB,+CAAkC,CAAA;AACpC,CAAC,EAXI,SAAS,KAAT,SAAS,QAWb;AAED,kBAAe,SAAS,CAAC"}

package/lib/types/ReactKitErrorCode.js

@@ -1,18 +0,0 @@
-"use strict";
-// Highest error code = DRK2
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * List of error codes built into the react kit
- * @author Gabe Abrams
- */
-var ReactKitErrorCode;
-(function (ReactKitErrorCode) {
-    ReactKitErrorCode["NoResponse"] = "DRK1";
-    ReactKitErrorCode["NoCode"] = "DRK2";
-    ReactKitErrorCode["SessionExpired"] = "DRK3";
-    ReactKitErrorCode["MissingParameter"] = "DRK4";
-    ReactKitErrorCode["InvalidParameter"] = "DRK5";
-    ReactKitErrorCode["WrongCourse"] = "DRK6";
-})(ReactKitErrorCode || (ReactKitErrorCode = {}));
-exports.default = ReactKitErrorCode;
-//# sourceMappingURL=ReactKitErrorCode.js.map

package/lib/types/ReactKitErrorCode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReactKitErrorCode.js","sourceRoot":"","sources":["../../src/types/ReactKitErrorCode.tsx"],"names":[],"mappings":";AAAA,4BAA4B;;AAE5B;;;GAGG;AACH,IAAK,iBAOJ;AAPD,WAAK,iBAAiB;IACpB,wCAAmB,CAAA;IACnB,oCAAe,CAAA;IACf,4CAAuB,CAAA;IACvB,8CAAyB,CAAA;IACzB,8CAAyB,CAAA;IACzB,yCAAoB,CAAA;AACtB,CAAC,EAPI,iBAAiB,KAAjB,iBAAiB,QAOrB;AAED,kBAAe,iBAAiB,CAAC"}

package/lib/types/Variant.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Bootstrap variants
- * @author Gabe Abrams
- */
-var Variant;
-(function (Variant) {
-    Variant["Primary"] = "primary";
-    Variant["Secondary"] = "secondary";
-    Variant["Success"] = "success";
-    Variant["Warning"] = "warning";
-    Variant["Info"] = "info";
-    Variant["Danger"] = "danger";
-    Variant["Light"] = "light";
-    Variant["Dark"] = "dark";
-})(Variant || (Variant = {}));
-exports.default = Variant;
-//# sourceMappingURL=Variant.js.map

package/lib/types/Variant.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Variant.js","sourceRoot":"","sources":["../../src/types/Variant.tsx"],"names":[],"mappings":";;AAAA;;;GAGG;AACH,IAAK,OASJ;AATD,WAAK,OAAO;IACV,8BAAmB,CAAA;IACnB,kCAAuB,CAAA;IACvB,8BAAmB,CAAA;IACnB,8BAAmB,CAAA;IACnB,wBAAa,CAAA;IACb,4BAAiB,CAAA;IACjB,0BAAe,CAAA;IACf,wBAAa,CAAA;AACf,CAAC,EATI,OAAO,KAAP,OAAO,QASX;AAED,kBAAe,OAAO,CAAC"}

package/src/components/AppWrapper.tsx

@@ -1,369 +0,0 @@
-/**
- * A wrapper for the entire React app that adds global functionality like
- *   handling for fatal error messages
- * @author Gabe Abrams
- */
-
-// Import React
-import React, { useState, useEffect } from 'react';
-
-// Import shared components
-import ErrorBox from './ErrorBox';
-
-// Import helpers
-import { setSessionExpiryHandler } from '../helpers/visitServerEndpoint';
-
-// Import shared types
-import ReactKitErrorCode from '../types/ReactKitErrorCode';
-
-// Import shared components
-import Modal from './Modal';
-
-// Import custom errors
-import ErrorWithCode from '../errors/ErrorWithCode';
-
-/*------------------------------------------------------------------------*/
-/*                                  Props                                 */
-/*------------------------------------------------------------------------*/
-
-type Props = {
-  // The entire app
-  children: React.ReactNode,
-  // True if this app is a dark-themed app
-  dark?: boolean,
-  // Custom session expired message
-  sessionExpiredMessage?: string,
-};
-
-/*------------------------------------------------------------------------*/
-/*                             Static Helpers                             */
-/*------------------------------------------------------------------------*/
-
-/*----------------------------------------*/
-/*                  Alert                 */
-/*----------------------------------------*/
-
-// Stored copies of setters
-let setAlertInfo: (info: { title: string, text: string }) => void;
-let onAlertClosed: () => void;
-
-/**
- * Show an alert modal with an "Okay" button
- * @author Gabe Abrams
- * @param title the title text to display at the top of the alert
- * @param text the text to display in the alert
- */
-export const _alert = async (title: string, text: string) => {
-  // Fallback if alert not available
-  if (!setAlertInfo) {
-    return window.alert(`${title}\n\n${text}`);
-  }
-
-  // Return promise that resolves when alert is closed
-  return new Promise((resolve) => {
-    // Setup handler
-    onAlertClosed = () => {
-      resolve(null);
-    };
-
-    // Show the alert
-    setAlertInfo({
-      title,
-      text,
-    });
-  });
-};
-
-/*----------------------------------------*/
-/*                 Confirm                */
-/*----------------------------------------*/
-
-// Stored copies of setters
-let setConfirmInfo: (info: { title: string, text: string }) => void;
-let onConfirmClosed: (confirmed: boolean) => void;
-
-/**
- * Show a confirmation modal with an "Okay" and a "Cancel" button
- * @author Gabe Abrams
- * @param title the title text to display at the top of the alert
- * @param text the text to display in the alert
- * @returns true if the user confirmed
- */
-export const _confirm = async (
-  title: string,
-  text: string,
-): Promise<boolean> => {
-  // Fallback if confirm is not available
-  if (!setConfirmInfo) {
-    return window.confirm(`${title}\n\n${text}`);
-  }
-
-  // Return promise that resolves with result of confirmation
-  return new Promise((resolve) => {
-    // Setup handler
-    onConfirmClosed = (confirmed: boolean) => {
-      resolve(confirmed)
-    };
-
-    // Show the confirm
-    setConfirmInfo({
-      title,
-      text,
-    });
-  });
-};
-
-/*----------------------------------------*/
-/*               Fatal Error              */
-/*----------------------------------------*/
-
-// Stored copies of setters
-let setFatalErrorMessage: (message: string) => void;
-let setFatalErrorCode: (code: string) => void;
-let setFatalErrorTitle: (title: string) => void;
-
-/**
- * Show a fatal error message
- * @author Gabe Abrams
- * @param error the error to show
- * @param [errorTitle] title of the error box
- */
-export const _showFatalError = (
-  error: any,
-  errorTitle: string = 'An Error Occurred',
-) => {
-  // Determine message and code
-  const message: string = (
-    typeof error === 'string'
-      ? error.trim()
-      : String(error.message ?? 'An unknown error occurred.')
-  );
-  const code: string = (
-    typeof error === 'string'
-      ? ReactKitErrorCode.NoCode
-      : String(error.code ?? ReactKitErrorCode.NoCode)
-  );
-
-  // Handle case where app hasn't loaded
-  if (!setFatalErrorMessage || !setFatalErrorCode) {
-    return _alert(
-      errorTitle,
-      `${message} (code: ${code}). Please contact support.`,
-    );
-  }
-
-  // Use setters
-  setFatalErrorMessage(message);
-  setFatalErrorCode(code);
-  setFatalErrorTitle(errorTitle);
-};
-
-/*------------------------------------------------------------------------*/
-/*                                Component                               */
-/*------------------------------------------------------------------------*/
-
-const AppWrapper = (props: Props): React.ReactElement => {
-  /*------------------------------------------------------------------------*/
-  /*                                  Setup                                 */
-  /*------------------------------------------------------------------------*/
-
-  /* -------------- Props ------------- */
-
-  const {
-    children,
-    dark,
-    sessionExpiredMessage = 'Your session has expired. Please go back to Canvas and start over.',
-  } = props;
-
-  /* -------------- State ------------- */
-
-  // Fatal error
-  const [
-    fatalErrorMessage,
-    setFatalErrorMessageInner,
-  ] = useState<string | undefined>();
-  setFatalErrorMessage = setFatalErrorMessageInner;
-  const [
-    fatalErrorCode,
-    setFatalErrorCodeInner,
-  ] = useState<string | undefined>();
-  setFatalErrorCode = setFatalErrorCodeInner;
-  const [
-    fatalErrorTitle,
-    setFatalErrorTitleInner,
-  ] = useState<string | undefined>();
-  setFatalErrorTitle = setFatalErrorTitleInner;
-
-  // Alert
-  const [
-    alertInfo,
-    setAlertInfoInner,
-  ] = useState<{
-    title: string,
-    text: string
-  }>();
-  setAlertInfo = setAlertInfoInner;
-
-  // Confirm
-  const [
-    confirmInfo,
-    setConfirmInfoInner,
-  ] = useState<{
-    title: string,
-    text: string
-  }>();
-  setConfirmInfo = setConfirmInfoInner;
-
-  // Session expired
-  const [
-    sessionHasExpired,
-    setSessionHasExpired,
-  ] = useState<boolean>(false);
-
-  /*------------------------------------------------------------------------*/
-  /*                           Lifecycle Functions                          */
-  /*------------------------------------------------------------------------*/
-
-  /**
-   * Mount
-   * @author Gabe Abrams
-   */
-  useEffect(
-    () => {
-      // Add session expired handler
-      setSessionExpiryHandler(() => {
-        // Session expired!
-        setSessionHasExpired(true);
-      });
-    },
-    [],
-  );
-
-  /*------------------------------------------------------------------------*/
-  /*                                 Render                                 */
-  /*------------------------------------------------------------------------*/
-
-  /*----------------------------------------*/
-  /*                  Modal                 */
-  /*----------------------------------------*/
-
-  // Modal that may be defined
-  let modal: React.ReactNode;
-
-  /* -------------- Alert ------------- */
-
-  if (alertInfo) {
-    modal = (
-      <Modal
-        title={alertInfo.title}
-        type={Modal.ModalType.Okay}
-        onClose={() => {
-          // Alert closed
-          if (onAlertClosed) {
-            onAlertClosed();
-          }
-        }}
-        onTopOfOtherModals
-      >
-        {alertInfo.text}
-      </Modal>
-    );
-  }
-
-  /* ------------- Confirm ------------ */
-
-  if (confirmInfo) {
-    modal = (
-      <Modal
-        title={confirmInfo.title}
-        type={Modal.ModalType.OkayCancel}
-        onClose={(buttonType) => {
-          if (onConfirmClosed) {
-            onConfirmClosed(buttonType === Modal.ButtonType.Okay);
-          }
-        }}
-        dontAllowBackdropExit
-      >
-
-      </Modal>
-    );
-  }
-
-  /*----------------------------------------*/
-  /*                  Views                 */
-  /*----------------------------------------*/
-
-  // Body that will be filled with the current view
-  let body: React.ReactNode;
-
-  /* ----------- Fatal Error ---------- */
-
-  if (fatalErrorMessage || fatalErrorCode || sessionHasExpired) {
-    // Re-encapsulate in an error
-    const error = (
-      sessionHasExpired
-        ? new ErrorWithCode(
-          fatalErrorMessage,
-          fatalErrorCode,
-        )
-        : new ErrorWithCode(
-          sessionExpiredMessage,
-          ReactKitErrorCode.SessionExpired,
-        )
-    );
-
-    // Build error screen
-    body = (
-      <div
-        style={{
-          display: 'block',
-          width: '100vw',
-          minHeight: '100vh',
-          paddingTop: '10rem',
-          backgroundColor: (
-            dark
-              ? '#222'
-              : '#fff'
-          ),
-        }}
-      >
-        <ErrorBox
-          title={(
-            sessionHasExpired
-              ? 'Session Expired'
-              : fatalErrorTitle
-          )}
-          error={error}
-        />
-      </div>
-    );
-  }
-
-  /* --------------- App -------------- */
-
-  if (!body) {
-    body = (
-      <>
-        {children}
-      </>
-    );
-  }
-
-  /*----------------------------------------*/
-  /*                 Main UI                */
-  /*----------------------------------------*/
-
-  return (
-    <>
-      {modal}
-      {body}
-    </>
-  );
-};
-
-/*------------------------------------------------------------------------*/
-/*                                 Wrap Up                                */
-/*------------------------------------------------------------------------*/
-
-// Export component
-export default AppWrapper;

package/src/components/ErrorBox.tsx

@@ -1,124 +0,0 @@
-/**
- * Displays an error
- * @author Gabe Abrams
- */
-
-// Import React
-import React from 'react';
-
-// Import FontAwesome Icons
-import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
-import { faExclamationTriangle } from '@fortawesome/free-solid-svg-icons';
-
-// Import shared types
-import ReactKitErrorCode from '../types/ReactKitErrorCode';
-
-/*------------------------------------------------------------------------*/
-/*                                  Types                                 */
-/*------------------------------------------------------------------------*/
-
-type Props = {
-  // Error to display
-  error: any,
-  // Customized title of error box
-  title?: string,
-  // Handler for close,
-  onClose?: () => void,
-};
-
-/*------------------------------------------------------------------------*/
-/*                                Component                               */
-/*------------------------------------------------------------------------*/
-
-const ErrorBox: React.FC<Props> = (props) => {
-  /*------------------------------------------------------------------------*/
-  /*                                  Setup                                 */
-  /*------------------------------------------------------------------------*/
-
-  /* -------------- Props ------------- */
-
-  const {
-    error,
-    title = 'An Error Occurred',
-    onClose,
-  } = props;
-
-  /*------------------------------------------------------------------------*/
-  /*                                 Render                                 */
-  /*------------------------------------------------------------------------*/
-
-  // Determine error text
-  const errorText: string = (
-    typeof error === 'string'
-      ? error.trim()
-      : String(error.message || 'An unknown error occurred. Please contact support.')
-  );
-
-  // Error code box
-  let errorCodeBox;
-  if (error && (error as any).code) {
-    errorCodeBox = (
-      <span>
-        {' '}
-        <span
-          style={{
-            backgroundColor: 'white',
-            borderRadius: '5px',
-            paddingLeft: '3px',
-            paddingRight: '3px',
-            color: '#DC4150',
-            fontVariant: 'small-caps',
-            fontSize: '80%',
-            whiteSpace: 'nowrap',
-          }}
-        >
-          code:
-          {' '}
-          {String((error as any).code ?? ReactKitErrorCode.NoCode).toUpperCase()}
-        </span>
-      </span>
-    );
-  }
-
-  // Main UI
-  return (
-    <div
-      className="alert alert-danger text-center"
-      style={{
-        maxWidth: '650px',
-        margin: 'auto',
-      }}
-    >
-      <h4 className="mb-1">
-        <FontAwesomeIcon
-          icon={faExclamationTriangle}
-          className="me-2"
-        />
-        {title}
-      </h4>
-      <div>
-        {errorText}
-        {errorCodeBox}
-      </div>
-      {onClose && (
-        <div className="mt-2">
-          <button
-            type="button"
-            className="btn btn-light"
-            aria-label="dismiss error and close this activity or view"
-            onClick={onClose}
-          >
-            Close
-          </button>
-        </div>
-      )}
-    </div>
-  );
-};
-
-/*------------------------------------------------------------------------*/
-/*                                 Wrap Up                                */
-/*------------------------------------------------------------------------*/
-
-// Export component
-export default ErrorBox;

package/src/components/LoadingSpinner.tsx

@@ -1,105 +0,0 @@
-/**
- * Loading spinner/indicator
- * @author Gabe Abrams
- */
-
-// Import FontAwesome Icons
-import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
-import { faCircle } from '@fortawesome/free-solid-svg-icons';
-
-/*------------------------------------------------------------------------*/
-/*                                  Style                                 */
-/*------------------------------------------------------------------------*/
-
-const style = `
-/* Blips */
-.LoadingSpinner-blip-1,
-.LoadingSpinner-blip-2,
-.LoadingSpinner-blip-3,
-.LoadingSpinner-blip-4 {
-  font-size: 25px;
-  opacity: 0.6;
-  margin-top: 20px;
-  margin-bottom: 20px;
-}
-
-/* First Blip */
-.LoadingSpinner-blip-1 {
-  animation: LoadingSpinner-pop-animation 2s infinite;
-}
-
-/* Second Blip */
-.LoadingSpinner-blip-2 {
-  animation: LoadingSpinner-pop-animation 2s infinite;
-  -webkit-animation-delay: 0.1s;
-  animation-delay: 0.1s;
-}
-
-/* Third Blip */
-.LoadingSpinner-blip-3 {
-  animation: LoadingSpinner-pop-animation 2s infinite;
-  animation-delay: 0.2s;
-}
-
-/* Fourth Blip */
-.LoadingSpinner-blip-4 {
-  animation: LoadingSpinner-pop-animation 2s infinite;
-  animation-delay: 0.3s;
-}
-
-/* Pop Animation for Each Blip */
-@keyframes LoadingSpinner-pop-animation {
-  0%  {
-    transform: scale(1.0);
-  }
-  10% {
-    transform: scale(1.5);
-  }
-  30% {
-    transform: scale(1.0);
-  }
-  100% {
-    transform: scale(1.0);
-  }
-}
-`;
-
-/*------------------------------------------------------------------------*/
-/*                                Component                               */
-/*------------------------------------------------------------------------*/
-
-const LoadingSpinner = () => {
-  /*------------------------------------------------------------------------*/
-  /*                                 Render                                 */
-  /*------------------------------------------------------------------------*/
-
-  // Add all four blips to a container
-  return (
-    <div className="text-center LoadingSpinner LoadingSpinner-container">
-      <style>{style}</style>
-      <FontAwesomeIcon
-        icon={faCircle}
-        className="LoadingSpinner-blip-1 me-1"
-      />
-      <FontAwesomeIcon
-        icon={faCircle}
-        className="LoadingSpinner-blip-2 me-1"
-      />
-      <FontAwesomeIcon
-        icon={faCircle}
-        className="LoadingSpinner-blip-3 me-1"
-      />
-      <FontAwesomeIcon
-        icon={faCircle}
-        className="LoadingSpinner-blip-4"
-      />
-    </div>
-  );
-};
-
-/*------------------------------------------------------------------------*/
-/*                                 Wrap Up                                */
-/*------------------------------------------------------------------------*/
-
-// Export component
-export default LoadingSpinner;