@pie-lib/mask-markup 0.1.0

package/src/drag-in-the-blank.tsx

@@ -0,0 +1,251 @@
+// @ts-nocheck
+/**
+ * @synced-from pie-lib/packages/mask-markup/src/drag-in-the-blank.jsx
+ * @auto-generated
+ *
+ * This file is automatically synced from pie-elements and converted to TypeScript.
+ * Manual edits will be overwritten on next sync.
+ * To make changes, edit the upstream JavaScript file and run sync again.
+ */
+
+import React from 'react';
+import PropTypes from 'prop-types';
+import { DragProvider } from '@pie-lib/drag';
+import { DragOverlay, rectIntersection } from '@dnd-kit/core';
+import Choices from './choices/index.js';
+import Choice from './choices/choice.js';
+import Blank from './components/blank.js';
+import { withMask } from './with-mask.js';
+
+const Masked = withMask('blank', (props) => (node, data, onChange) => {
+  const dataset = node.data?.dataset || {};
+  if (dataset.component === 'blank') {
+    // eslint-disable-next-line react/prop-types
+    const {
+      disabled,
+      duplicates,
+      correctResponse,
+      feedback,
+      showCorrectAnswer,
+      emptyResponseAreaWidth,
+      emptyResponseAreaHeight,
+      instanceId,
+      isDragging,
+    } = props;
+    const choiceId = showCorrectAnswer ? correctResponse[dataset.id] : data[dataset.id];
+    // eslint-disable-next-line react/prop-types
+    const choice = choiceId && props.choices.find((c) => c.id === choiceId);
+
+    return (
+      <Blank
+        key={`${node.type}-${dataset.id}`}
+        correct={showCorrectAnswer || (feedback && feedback[dataset.id])}
+        disabled={disabled}
+        duplicates={duplicates}
+        choice={choice}
+        id={dataset.id}
+        emptyResponseAreaWidth={emptyResponseAreaWidth}
+        emptyResponseAreaHeight={emptyResponseAreaHeight}
+        onChange={(id, choiceId) => {
+          const newData = { ...data };
+          if (choiceId === undefined) {
+            delete newData[id];
+          } else {
+            newData[id] = choiceId;
+          }
+          onChange(newData);
+        }}
+        instanceId={instanceId}
+        isDragging={isDragging}
+      />
+    );
+  }
+});
+
+export default class DragInTheBlank extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = {
+      activeDragItem: null,
+      dropAnimation: undefined,
+    };
+  }
+
+  static propTypes = {
+    markup: PropTypes.string,
+    layout: PropTypes.object,
+    choicesPosition: PropTypes.string,
+    choices: PropTypes.array,
+    value: PropTypes.object,
+    onChange: PropTypes.func,
+    duplicates: PropTypes.bool,
+    disabled: PropTypes.bool,
+    feedback: PropTypes.object,
+    correctResponse: PropTypes.object,
+    showCorrectAnswer: PropTypes.bool,
+    emptyResponseAreaWidth: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+    emptyResponseAreaHeight: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+    instanceId: PropTypes.string,
+  };
+
+  static defaultProps = {
+    instanceId: 'drag-in-the-blank',
+  };
+
+  handleDragStart: any = (event) => {
+    const { active } = event;
+
+    if (active?.data?.current) {
+      this.setState({
+        activeDragItem: active.data.current,
+        dropAnimation: undefined, // default during drag
+      });
+    }
+  };
+
+  renderDragOverlay: any = () => {
+    const { activeDragItem } = this.state;
+    if (!activeDragItem) return null;
+
+    if (activeDragItem.type === 'MaskBlank') {
+      return (
+        <Choice
+          disabled={activeDragItem.disabled}
+          choice={activeDragItem.choice}
+          instanceId={activeDragItem.instanceId}
+        />
+      );
+    }
+
+    return null;
+  };
+
+  handleDragEnd: any = (event) => {
+    const { active, over } = event;
+    const { onChange, value } = this.props;
+
+    const draggedData = active?.data?.current;
+    const dropData = over?.data?.current;
+
+    const isValidDrop =
+      !!active && !!over && draggedData?.type === 'MaskBlank' && dropData?.accepts?.includes('MaskBlank');
+
+    // Only animate back when drop is invalid
+    this.setState({
+      activeDragItem: null,
+      dropAnimation: isValidDrop ? null : undefined,
+    });
+
+    if (!isValidDrop || !onChange) return;
+
+    const draggedItem = draggedData;
+    const targetId = dropData.id;
+
+    if (dropData.toChoiceBoard === true) {
+      if (!draggedItem.fromChoice && draggedItem.id) {
+        const newValue = { ...value };
+        delete newValue[draggedItem.id];
+        onChange(newValue);
+      }
+    } else if (draggedItem.fromChoice === true) {
+      if (targetId && targetId !== 'drag-in-the-blank-droppable') {
+        const newValue = { ...value };
+        newValue[targetId] = draggedItem.choice.id;
+        onChange(newValue);
+      }
+    } else if (draggedItem.id && draggedItem.id !== targetId) {
+      const newValue = { ...value };
+      newValue[targetId] = draggedItem.choice.id;
+      delete newValue[draggedItem.id];
+      onChange(newValue);
+    }
+  };
+
+  getPositionDirection: any = (choicePosition) => {
+    let flexDirection;
+    let justifyContent;
+    let alignItems;
+
+    switch (choicePosition) {
+      case 'left':
+        flexDirection = 'row';
+        alignItems = 'center';
+        break;
+      case 'right':
+        flexDirection = 'row-reverse';
+        justifyContent = 'flex-end';
+        alignItems = 'center';
+        break;
+      case 'below':
+        flexDirection = 'column-reverse';
+        break;
+      default:
+        // above
+        flexDirection = 'column';
+        break;
+    }
+
+    return { flexDirection, justifyContent, alignItems };
+  };
+
+  render() {
+    const {
+      markup,
+      duplicates,
+      value,
+      onChange,
+      choicesPosition,
+      choices,
+      correctResponse,
+      disabled,
+      feedback,
+      showCorrectAnswer,
+      emptyResponseAreaWidth,
+      emptyResponseAreaHeight,
+      layout,
+      instanceId,
+    } = this.props;
+
+    const choicePosition = choicesPosition || 'below';
+    const style = { display: 'flex', minWidth: '100px', ...this.getPositionDirection(choicePosition) };
+
+    return (
+      <DragProvider
+        onDragStart={this.handleDragStart}
+        onDragEnd={this.handleDragEnd}
+        collisionDetection={rectIntersection}
+      >
+        <div ref={(ref) => (this.rootRef = ref)} style={style}>
+          <Choices
+            choicePosition={choicePosition}
+            choices={choices}
+            value={value}
+            duplicates={duplicates}
+            disabled={disabled}
+            instanceId={instanceId}
+          />
+          <Masked
+            elementType="drag-in-the-blank"
+            markup={markup}
+            layout={layout}
+            value={value}
+            choices={choices}
+            onChange={onChange}
+            disabled={disabled}
+            duplicates={duplicates}
+            feedback={feedback}
+            correctResponse={correctResponse}
+            showCorrectAnswer={showCorrectAnswer}
+            emptyResponseAreaWidth={emptyResponseAreaWidth}
+            emptyResponseAreaHeight={emptyResponseAreaHeight}
+            instanceId={instanceId}
+            isDragging={!!this.state.activeDragItem}
+          />
+          <DragOverlay style={{ pointerEvents: 'none' }} dropAnimation={this.state.dropAnimation}>
+            {this.renderDragOverlay()}
+          </DragOverlay>
+        </div>
+      </DragProvider>
+    );
+  }
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+// @ts-nocheck
+/**
+ * @synced-from pie-lib/packages/mask-markup/src/index.js
+ * @auto-generated
+ *
+ * This file is automatically synced from pie-elements and converted to TypeScript.
+ * Manual edits will be overwritten on next sync.
+ * To make changes, edit the upstream JavaScript file and run sync again.
+ */
+
+import { buildLayoutFromMarkup, withMask } from './with-mask.js';
+import DragInTheBlank from './drag-in-the-blank.js';
+import ConstructedResponse from './constructed-response.js';
+import Customizable from './customizable.js';
+import InlineDropdown from './inline-dropdown.js';
+import componentize from './componentize.js';
+
+export {
+  withMask,
+  buildLayoutFromMarkup,
+  DragInTheBlank,
+  ConstructedResponse,
+  InlineDropdown,
+  componentize,
+  Customizable,
+};

package/src/inline-dropdown.tsx

@@ -0,0 +1,39 @@
+// @ts-nocheck
+/**
+ * @synced-from pie-lib/packages/mask-markup/src/inline-dropdown.jsx
+ * @auto-generated
+ *
+ * This file is automatically synced from pie-elements and converted to TypeScript.
+ * Manual edits will be overwritten on next sync.
+ * To make changes, edit the upstream JavaScript file and run sync again.
+ */
+
+import React from 'react';
+import Dropdown from './components/dropdown.js';
+import { withMask } from './with-mask.js';
+
+// eslint-disable-next-line react/display-name
+export default withMask('dropdown', (props) => (node, data, onChange) => {
+  const dataset = node.data ? node.data.dataset || {} : {};
+  if (dataset.component === 'dropdown') {
+    // eslint-disable-next-line react/prop-types
+    const { choices, disabled, feedback, showCorrectAnswer } = props;
+    const correctAnswer = choices && choices[dataset.id] && choices[dataset.id].find((c) => c.correct);
+    const finalChoice = showCorrectAnswer ? correctAnswer && correctAnswer.value : data[dataset.id];
+
+    return (
+      <Dropdown
+        key={`${node.type}-dropdown-${dataset.id}`}
+        correct={feedback && feedback[dataset.id] && feedback[dataset.id] === 'correct'}
+        disabled={disabled || showCorrectAnswer}
+        value={finalChoice}
+        correctValue={showCorrectAnswer ? correctAnswer && correctAnswer.label : undefined}
+        id={dataset.id}
+        onChange={onChange}
+        choices={choices[dataset.id]}
+        showCorrectAnswer={showCorrectAnswer}
+        singleQuery={Object.keys(choices).length == 1}
+      />
+    );
+  }
+});

package/src/mask.tsx

@@ -0,0 +1,178 @@
+// @ts-nocheck
+/**
+ * @synced-from pie-lib/packages/mask-markup/src/mask.jsx
+ * @auto-generated
+ *
+ * This file is automatically synced from pie-elements and converted to TypeScript.
+ * Manual edits will be overwritten on next sync.
+ * To make changes, edit the upstream JavaScript file and run sync again.
+ */
+
+import React from 'react';
+import PropTypes from 'prop-types';
+import { get } from 'lodash-es';
+import { styled } from '@mui/material/styles';
+import { renderMath } from '@pie-element/shared-math-rendering-mathjax';
+import { MARK_TAGS } from './serialization.js';
+
+const Paragraph: any = styled('div')(({ theme }) => ({
+  paddingTop: theme.spacing(0.5),
+  paddingBottom: theme.spacing(0.5),
+}));
+
+const Spacer: any = styled('span')(() => ({
+  display: 'inline-block',
+  width: '.75em',
+}));
+
+const restrictWhitespaceTypes = ['tbody', 'tr'];
+
+const addText = (parentNode, text) => {
+  const isWhitespace = text.trim() === '';
+  const parentType = parentNode && parentNode.type;
+
+  if (isWhitespace && restrictWhitespaceTypes.includes(parentType)) {
+    return undefined;
+  } else {
+    return text;
+  }
+};
+
+const getMark = (n) => {
+  const mark = n.leaves.find((leave) => get(leave, 'marks', []).length);
+
+  if (mark) {
+    return mark.marks[0];
+  }
+
+  return null;
+};
+
+export const renderChildren = (layout, value, onChange, rootRenderChildren, parentNode, elementType) => {
+  if (!value) {
+    return null;
+  }
+
+  const children = [];
+
+  (layout.nodes || []).forEach((n, index) => {
+    const key = n.type ? `${n.type}-${index}` : `${index}`;
+
+    if (n.isMath) {
+      children.push(
+        <span
+          dangerouslySetInnerHTML={{
+            __html: `<math displaystyle="true">${n.nodes[0].innerHTML}</math>`,
+          }}
+        />,
+      );
+      return children;
+    }
+
+    if (rootRenderChildren) {
+      const c = rootRenderChildren(n, value, onChange);
+      if (c) {
+        children.push(c);
+        if (parentNode?.type !== 'td' && elementType === 'drag-in-the-blank') {
+          children.push(<Spacer key={`spacer-${index}`} />);
+        }
+        return;
+      }
+    }
+
+    if (n.object === 'text') {
+      const content = n.leaves.reduce((acc, l) => {
+        const t = l.text;
+        const extraText = addText(parentNode, t);
+        return extraText ? acc + extraText : acc;
+      }, '');
+      const mark = getMark(n);
+
+      if (mark) {
+        let markKey;
+
+        for (markKey in MARK_TAGS) {
+          if (MARK_TAGS[markKey] === mark.type) {
+            const Tag = markKey;
+
+            children.push(<Tag key={key}>{content}</Tag>);
+            break;
+          }
+        }
+      } else if (content.length > 0) {
+        children.push(content);
+        if (parentNode?.type !== 'td' && elementType === 'drag-in-the-blank') {
+          children.push(<Spacer key={`spacer-${index}`} />);
+        }
+      }
+    } else {
+      const subNodes = renderChildren(n, value, onChange, rootRenderChildren, n, elementType);
+      if (n.type === 'p' || n.type === 'paragraph') {
+        children.push(<Paragraph key={key}>{subNodes}</Paragraph>);
+      } else {
+        const Tag = n.type;
+        if (n.nodes && n.nodes.length > 0) {
+          children.push(
+            <Tag key={key} {...n.data.attributes}>
+              {subNodes}
+            </Tag>,
+          );
+        } else {
+          children.push(<Tag key={key} {...n.data.attributes} />);
+        }
+      }
+    }
+  });
+  return children;
+};
+
+const MaskContainer: any = styled('div')(() => ({
+  display: 'initial',
+  '&:not(.MathJax) table': {
+    borderCollapse: 'collapse',
+  },
+  // align table content to left as per STAR requirement PD-3687
+  '&:not(.MathJax) table td, &:not(.MathJax) table th': {
+    padding: '8px 12px',
+    textAlign: 'left',
+  },
+}));
+
+/**
+ * Renders a layout that uses the slate.js Value model structure.
+ */
+export default class Mask extends React.Component {
+  constructor(props) {
+    super(props);
+    this.internalContainerRef = React.createRef();
+  }
+
+  static propTypes = {
+    renderChildren: PropTypes.func,
+    layout: PropTypes.object,
+    value: PropTypes.object,
+    onChange: PropTypes.func,
+    elementType: PropTypes.string,
+    containerRef: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({ current: PropTypes.instanceOf(Element) })]),
+  };
+
+  componentDidMount() {
+    const containerRef = this.props.containerRef || this.internalContainerRef;
+    if (containerRef.current && typeof renderMath === 'function') {
+      renderMath(containerRef.current);
+    }
+  }
+
+  handleChange: any = (id, value) => {
+    const data = { ...this.props.value, [id]: value };
+    this.props.onChange(data);
+  };
+
+  render() {
+    const { value, layout, elementType, containerRef } = this.props;
+    const children = renderChildren(layout, value, this.handleChange, this.props.renderChildren, null, elementType);
+    const ref = containerRef || this.internalContainerRef;
+
+    return <MaskContainer ref={ref}>{children}</MaskContainer>;
+  }
+}