@instructure/ui-source-code-editor 11.6.0 → 11.6.1-snapshot-129

package/lib/SourceCodeEditor/v2/index.js

@@ -0,0 +1,541 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.SourceCodeEditor = void 0;
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = require("react");
+var _deepEqual = require("@instructure/ui-utils/lib/deepEqual.js");
+var _state = require("@codemirror/state");
+var _view = require("@codemirror/view");
+var _autocomplete = require("@codemirror/autocomplete");
+var _search = require("@codemirror/search");
+var _commands = require("@codemirror/commands");
+var _lint = require("@codemirror/lint");
+var _language = require("@codemirror/language");
+var _langJavascript = require("@codemirror/lang-javascript");
+var _langHtml = require("@codemirror/lang-html");
+var _langCss = require("@codemirror/lang-css");
+var _langMarkdown = require("@codemirror/lang-markdown");
+var _langJson = require("@codemirror/lang-json");
+var _shell = require("@codemirror/legacy-modes/mode/shell");
+var _yaml = require("@codemirror/legacy-modes/mode/yaml");
+var _omitProps = require("@instructure/ui-react-utils/lib/omitProps.js");
+var _passthroughProps = require("@instructure/ui-react-utils/lib/passthroughProps.js");
+var _withDeterministicId = require("@instructure/ui-react-utils/lib/DeterministicIdContext/withDeterministicId.js");
+var _requestAnimationFrame = require("@instructure/ui-dom-utils/lib/requestAnimationFrame.js");
+var _ScreenReaderContent = require("@instructure/ui-a11y-content/lib/ScreenReaderContent");
+var _textDirectionContextConsumer = require("@instructure/ui-i18n/lib/textDirectionContextConsumer.js");
+var _emotion = require("@instructure/emotion");
+var _SearchPanel = _interopRequireDefault(require("./SearchPanel"));
+var _styles = _interopRequireDefault(require("./styles"));
+var _customKeybinding = require("./customKeybinding");
+var _props = require("./props");
+var _jsxRuntime = require("@emotion/react/jsx-runtime");
+const _excluded = ["label", "styles"];
+var _dec, _dec2, _dec3, _class, _SourceCodeEditor;
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+// import { oneDarkTheme, oneDarkHighlightStyle } from '@codemirror/theme-one-dark'
+/**
+---
+category: components
+---
+**/
+let SourceCodeEditor = exports.SourceCodeEditor = (_dec = (0, _withDeterministicId.withDeterministicId)(), _dec2 = (0, _emotion.withStyle)(_styles.default), _dec3 = (0, _textDirectionContextConsumer.textDirectionContextConsumer)(), _dec(_class = _dec2(_class = _dec3(_class = (_SourceCodeEditor = class SourceCodeEditor extends _react.Component {
+  addAnimationFrame(callback) {
+    if (typeof callback === 'function') {
+      this._raf.push((0, _requestAnimationFrame.requestAnimationFrame)(callback));
+    }
+  }
+  cancelAnimationFrames() {
+    this._raf.forEach(request => request.cancel());
+    this._raf = [];
+  }
+  focus() {
+    this.addAnimationFrame(() => {
+      var _this$_editorView;
+      (_this$_editorView = this._editorView) === null || _this$_editorView === void 0 ? void 0 : _this$_editorView.focus();
+    });
+  }
+  get hasFocus() {
+    var _this$_editorView2;
+    return (_this$_editorView2 = this._editorView) === null || _this$_editorView2 === void 0 ? void 0 : _this$_editorView2.hasFocus;
+  }
+  selectAll() {
+    if (this._editorView) {
+      this.addAnimationFrame(() => {
+        var _this$currentDocValue;
+        this.dispatchViewSelection({
+          anchor: 0,
+          head: (_this$currentDocValue = this.currentDocValue) === null || _this$currentDocValue === void 0 ? void 0 : _this$currentDocValue.length
+        });
+      });
+    }
+  }
+  deselectAll() {
+    if (this._editorView) {
+      this.addAnimationFrame(() => {
+        this.dispatchViewSelection({
+          anchor: 0,
+          head: 0
+        });
+      });
+    }
+  }
+  indentCurrentSelection() {
+    this.addAnimationFrame(() => {
+      if (this._editorView) {
+        (0, _commands.indentSelection)({
+          state: this._editorView.state,
+          dispatch: transaction => {
+            var _this$_editorView3;
+            (_this$_editorView3 = this._editorView) === null || _this$_editorView3 === void 0 ? void 0 : _this$_editorView3.update([transaction]);
+          }
+        });
+      }
+    });
+  }
+  indentAll() {
+    this.addAnimationFrame(() => {
+      if (this._editorView && this.currentDocValue) {
+        this.indentCodeRange(0, this.currentDocValue.length);
+      }
+    });
+  }
+  indentCodeRange(from, to) {
+    this.addAnimationFrame(() => {
+      if (this._editorView && this.currentDocValue) {
+        this.dispatchViewChanges({
+          changes: (0, _language.indentRange)(this._editorView.state, from, to)
+        });
+      }
+    });
+  }
+
+  // Attach state effects
+  dispatchViewEffects(effects) {
+    if (!this._editorView || !effects) return;
+    this._editorView.dispatch({
+      effects
+    });
+  }
+
+  // Dispatch changes to the document
+  dispatchViewChanges({
+    changes,
+    selection,
+    userEvent
+  }) {
+    if (!this._editorView || !changes) return;
+    this._editorView.dispatch({
+      changes,
+      ...(selection ? {
+        selection
+      } : void 0),
+      ...(userEvent ? {
+        userEvent
+      } : void 0)
+    });
+  }
+
+  // Select a portion of the document
+  dispatchViewSelection(selection) {
+    if (!this._editorView || !selection) return;
+    this._editorView.dispatch({
+      selection
+    });
+  }
+  get currentDocValue() {
+    var _this$_editorView4;
+    return (_this$_editorView4 = this._editorView) === null || _this$_editorView4 === void 0 ? void 0 : _this$_editorView4.state.doc;
+  }
+
+  // when value is passed, the editor should be controlled
+  get isControlled() {
+    return typeof this.props.value === 'string';
+  }
+  constructor(props) {
+    super(props);
+    this._id = void 0;
+    this.ref = null;
+    this._containerRef = void 0;
+    this._editorView = void 0;
+    this._raf = [];
+    this._newSelectionAfterValueChange = void 0;
+    this.handleRef = el => {
+      const elementRef = this.props.elementRef;
+      this.ref = el;
+      if (typeof elementRef === 'function') {
+        elementRef(el);
+      }
+    };
+    this.handleContainerRef = el => {
+      const containerRef = this.props.containerRef;
+      this._containerRef = el || void 0;
+      if (typeof containerRef === 'function') {
+        containerRef(el);
+      }
+    };
+    this.assignAriaLabel = () => {
+      if (this._containerRef) {
+        const editorDiv = this._containerRef.querySelector('[role="textbox"]');
+        if (editorDiv) {
+          editorDiv.setAttribute('aria-labelledby', `${this._id}`);
+        }
+      }
+    };
+    this._id = props.deterministicId();
+  }
+  componentDidMount() {
+    var _this$props$makeStyle, _this$props2;
+    const _this$props = this.props,
+      value = _this$props.value,
+      defaultValue = _this$props.defaultValue,
+      autofocus = _this$props.autofocus,
+      indentOnLoad = _this$props.indentOnLoad;
+    (_this$props$makeStyle = (_this$props2 = this.props).makeStyles) === null || _this$props$makeStyle === void 0 ? void 0 : _this$props$makeStyle.call(_this$props2);
+    const state = _state.EditorState.create({
+      doc: value || defaultValue,
+      extensions: this.extensions
+    });
+    this._editorView = new _view.EditorView({
+      state,
+      parent: this._containerRef
+    });
+
+    // from the a11y team:
+    // axe devtools and other automated a11y tests both flagging this issue,
+    // which can be observed while navigating with keyboard:
+    // Ensure elements that have scrollable content are accessible by keyboard
+    // To solve this problem, you need to fix at least (1) of the following:
+    // Element should have focusable content, Element should be focusable
+    this._editorView.scrollDOM.tabIndex = 0;
+    if (autofocus) {
+      this.focus();
+    }
+    if (indentOnLoad) {
+      this.indentAll();
+    }
+    this.assignAriaLabel();
+  }
+  componentWillUnmount() {
+    var _this$_editorView5;
+    (_this$_editorView5 = this._editorView) === null || _this$_editorView5 === void 0 ? void 0 : _this$_editorView5.destroy();
+    this.cancelAnimationFrames();
+  }
+  componentDidUpdate(prevProps) {
+    var _this$props$makeStyle2, _this$props3;
+    (_this$props$makeStyle2 = (_this$props3 = this.props).makeStyles) === null || _this$props$makeStyle2 === void 0 ? void 0 : _this$props$makeStyle2.call(_this$props3);
+    if (this._editorView) {
+      if (this.props.value !== prevProps.value) {
+        this.refreshEditorValue();
+      }
+      if (this.shouldUpdateExtensions(prevProps)) {
+        this.refreshExtensions();
+      }
+    }
+  }
+  shouldUpdateExtensions(prevProps) {
+    const propsToObserve = ['styles',
+    // needed for theme update
+    'themeOverride', 'language', 'readOnly', 'editable', 'lineNumbers', 'highlightActiveLineGutter', 'foldGutter', 'lineWrapping', 'autofocus', 'spellcheck', 'direction', 'dir', 'rtlMoveVisually', 'indentOnLoad', 'indentWithTab', 'indentUnit', 'highlightActiveLine', 'attachment'];
+    for (const prop of propsToObserve) {
+      if (!(0, _deepEqual.deepEqual)(this.props[prop], prevProps[prop])) {
+        return true;
+      }
+    }
+    return false;
+  }
+  get direction() {
+    // comes from the `direction` prop and
+    // falls back to the `dir` prop coming from the bidirectional decorator
+    return this.props.direction || this.props.dir;
+  }
+  get extensions() {
+    const extensions = [...this.baseExtensions,
+    // our custom extensions
+    this.languageExtension, this.onChangeExtension, this.focusListenerExtension, this.announceLineNumberExtension];
+    if (this.themeExtension) {
+      extensions.push(this.themeExtension);
+    }
+    if (this.props.lineNumbers) {
+      extensions.push((0, _view.lineNumbers)());
+    }
+    if (this.props.highlightActiveLine) {
+      extensions.push((0, _view.highlightActiveLine)());
+    }
+    if (this.props.highlightActiveLineGutter) {
+      extensions.push((0, _view.highlightActiveLineGutter)());
+    }
+    if (this.props.foldGutter) {
+      extensions.push((0, _language.foldGutter)());
+    }
+    if (this.props.lineWrapping) {
+      extensions.push(_view.EditorView.lineWrapping);
+    }
+    if (this.props.editable === false) {
+      extensions.push(_view.EditorView.editable.of(false));
+    }
+    if (this.props.readOnly) {
+      extensions.push(_state.EditorState.readOnly.of(true));
+    }
+    if (this.props.spellcheck) {
+      extensions.push(_view.EditorView.contentAttributes.of({
+        spellcheck: 'true'
+      }));
+    }
+    if (this.direction) {
+      extensions.push(_view.EditorView.contentAttributes.of({
+        dir: this.direction
+      }));
+    }
+    if (this.props.indentUnit) {
+      extensions.push(_language.indentUnit.of(this.props.indentUnit));
+    }
+    return extensions;
+  }
+  get baseExtensions() {
+    return [
+    // The extensions are based on codemirrors basic setup from 'codemirror'.
+    // It is recommended by CodeMirror, that if we want to configure
+    // our editor more precisely, we have to copy the source
+    // and adjust it as desired.
+    (0, _view.highlightSpecialChars)(), (0, _commands.history)(), (0, _view.drawSelection)(), (0, _view.dropCursor)(), _state.EditorState.allowMultipleSelections.of(true), (0, _language.syntaxHighlighting)(_language.defaultHighlightStyle, {
+      fallback: true
+    }), (0, _language.bracketMatching)(), (0, _autocomplete.closeBrackets)(), (0, _autocomplete.autocompletion)(), (0, _view.rectangularSelection)(), (0, _view.crosshairCursor)(), (0, _search.highlightSelectionMatches)(), (0, _language.indentOnInput)(), (0, _SearchPanel.default)(this.props.searchConfig), _view.keymap.of(this.keymaps)];
+  }
+  get keymaps() {
+    // TODO: if more keymaps are added, list them in the docs as well (#Command keybinding)
+    const keymaps = [..._autocomplete.closeBracketsKeymap, ...this.commandKeybinding, ..._commands.historyKeymap, ..._language.foldKeymap, ..._autocomplete.completionKeymap, ..._lint.lintKeymap, ...(this.props.searchConfig ? _search.searchKeymap : [])];
+    if (this.props.indentWithTab) {
+      keymaps.push(_commands.indentWithTab);
+    }
+    return keymaps;
+  }
+  get commandKeybinding() {
+    const rtlMoveVisually = this.props.rtlMoveVisually;
+    if (this.direction === 'rtl' && !rtlMoveVisually) {
+      const overrideableKeys = _customKeybinding.rtlHorizontalArrowKeymap.map(binding => binding.key ? binding.key : binding.mac ? binding.mac : binding);
+      // we have to remove the binding we want to override from the original,
+      // otherwise all will be merged and the defaults will still apply
+      const filteredOriginal = _commands.defaultKeymap.filter(binding => binding.key ? overrideableKeys.indexOf(binding.key) < 0 : binding.mac ? overrideableKeys.indexOf(binding.mac) < 0 : false);
+      return [...filteredOriginal, ..._customKeybinding.rtlHorizontalArrowKeymap];
+    }
+    return _commands.defaultKeymap;
+  }
+  get themeExtension() {
+    const styles = this.props.styles;
+    if (!(styles !== null && styles !== void 0 && styles.theme) || !styles.highlightStyle) {
+      return void 0;
+    }
+    const theme = _view.EditorView.theme(styles === null || styles === void 0 ? void 0 : styles.theme);
+    const highlightStyle = (0, _language.syntaxHighlighting)(_language.HighlightStyle.define(styles === null || styles === void 0 ? void 0 : styles.highlightStyle));
+
+    // see notes in props.ts
+    // if (darkTheme) {
+    //   theme = oneDarkTheme
+    //   highlightStyle = syntaxHighlighting(oneDarkHighlightStyle)
+    // }
+
+    return [theme, highlightStyle];
+  }
+  get languageExtension() {
+    const language = this.props.language;
+    switch (language) {
+      case 'json':
+        return (0, _langJson.json)();
+      case 'js':
+      case 'jsx':
+      case 'javascript':
+        return (0, _langJavascript.javascript)({
+          jsx: true,
+          typescript: true
+        });
+      case 'html':
+        return (0, _langHtml.html)({
+          matchClosingTags: true,
+          autoCloseTags: true
+        });
+      case 'css':
+        return (0, _langCss.css)();
+      case 'markdown':
+        return (0, _langMarkdown.markdown)();
+      case 'sh':
+      case 'shell':
+      case 'bash':
+        // ????
+        return _language.StreamLanguage.define(_shell.shell);
+      case 'yml':
+      case 'yaml':
+        return _language.StreamLanguage.define(_yaml.yaml);
+      default:
+        return (0, _langJavascript.javascript)({
+          jsx: true,
+          typescript: true
+        });
+    }
+  }
+  callOnChangeHandler(newValue) {
+    const _this$props4 = this.props,
+      onChange = _this$props4.onChange,
+      value = _this$props4.value;
+    this.addAnimationFrame(() => {
+      if (typeof onChange === 'function' && newValue !== value) {
+        onChange(newValue);
+      }
+    });
+  }
+  get onChangeExtension() {
+    return _state.EditorState.changeFilter.of(transaction => {
+      if (!this._editorView) {
+        return false;
+      }
+      if (transaction.docChanged) {
+        const newDoc = transaction.newDoc.toString();
+        if (this.isControlled) {
+          // the value will be changed by the onChange handler,
+          // refreshEditorValue has to run first
+          if (newDoc !== this.props.value) {
+            this._newSelectionAfterValueChange = transaction.selection;
+            this.cancelAnimationFrames();
+            this.callOnChangeHandler(newDoc);
+            return false;
+          } else {
+            return true;
+          }
+        } else {
+          this.callOnChangeHandler(newDoc);
+        }
+      }
+      return true;
+    });
+  }
+  get focusListenerExtension() {
+    const _this$props5 = this.props,
+      onFocus = _this$props5.onFocus,
+      onBlur = _this$props5.onBlur;
+    return _view.EditorView.updateListener.of(update => {
+      if (update.focusChanged && this._editorView) {
+        if (this.hasFocus) {
+          if (typeof onFocus === 'function') {
+            onFocus();
+          }
+        } else {
+          if (typeof onBlur === 'function') {
+            onBlur();
+          }
+        }
+      }
+    });
+  }
+  get announceLineNumberExtension() {
+    return _state.EditorState.transactionExtender.of(tr => {
+      const selection = tr.selection;
+      const oldSelection = tr.startState.selection.main;
+      if (selection && selection.main.empty && oldSelection.empty) {
+        const oldLine = tr.startState.doc.lineAt(oldSelection.head);
+        const newLine = tr.newDoc.lineAt(selection.main.head);
+        if (oldLine.number != newLine.number) return {
+          effects: _view.EditorView.announce.of(tr.startState.phrase('line ') + newLine.number + '.')
+        };
+      }
+      return null;
+    });
+  }
+  refreshExtensions() {
+    this.dispatchViewEffects(_state.StateEffect.reconfigure.of(this.extensions));
+  }
+  refreshEditorValue() {
+    if (!this._editorView) return;
+    const value = this.props.value;
+    const currentValue = this._editorView.state.doc.toString();
+    if (typeof value !== 'undefined' && currentValue !== value) {
+      let userEvent;
+      const lengthDiff = value.length - currentValue.length;
+
+      // setting user events are needed for the autocomplete to work
+      // (only these 2 events, autocomplete doesn't work on paste, etc.)
+      if (lengthDiff === 1) {
+        userEvent = 'input.type';
+      } else if (lengthDiff === -1) {
+        userEvent = 'delete.backward';
+      }
+      this.dispatchViewChanges({
+        changes: {
+          from: 0,
+          to: currentValue.length,
+          insert: value || ''
+        },
+        selection: this._newSelectionAfterValueChange,
+        userEvent: userEvent
+      });
+      this._newSelectionAfterValueChange = void 0;
+    }
+    if (this.props.indentOnLoad) {
+      this.indentAll();
+    }
+  }
+  render() {
+    const _this$props6 = this.props,
+      label = _this$props6.label,
+      styles = _this$props6.styles,
+      restProps = (0, _objectWithoutProperties2.default)(_this$props6, _excluded);
+    return (0, _jsxRuntime.jsx)("div", {
+      "data-cid": "SourceCodeEditor",
+      ref: this.handleRef,
+      css: styles === null || styles === void 0 ? void 0 : styles.codeEditor,
+      ...(0, _passthroughProps.passthroughProps)((0, _omitProps.omitProps)(restProps, SourceCodeEditor.allowedProps)),
+      children: (0, _jsxRuntime.jsxs)("label", {
+        css: styles === null || styles === void 0 ? void 0 : styles.label,
+        id: this._id,
+        children: [(0, _jsxRuntime.jsx)(_ScreenReaderContent.ScreenReaderContent, {
+          children: label
+        }), (0, _jsxRuntime.jsx)("div", {
+          ref: this.handleContainerRef,
+          css: styles === null || styles === void 0 ? void 0 : styles.codeEditorContainer
+        })]
+      })
+    });
+  }
+}, _SourceCodeEditor.displayName = "SourceCodeEditor", _SourceCodeEditor.componentId = 'SourceCodeEditor', _SourceCodeEditor.allowedProps = _props.allowedProps, _SourceCodeEditor.defaultProps = {
+  language: 'jsx',
+  readOnly: false,
+  editable: true,
+  lineNumbers: false,
+  foldGutter: false,
+  highlightActiveLine: false,
+  highlightActiveLineGutter: false,
+  lineWrapping: false,
+  autofocus: false,
+  spellcheck: false,
+  rtlMoveVisually: true,
+  indentOnLoad: false,
+  indentWithTab: false,
+  defaultValue: '',
+  height: 'auto'
+}, _SourceCodeEditor)) || _class) || _class) || _class);
+var _default = exports.default = SourceCodeEditor;

package/lib/SourceCodeEditor/v2/props.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.allowedProps = void 0;
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+const allowedProps = exports.allowedProps = ['label', 'language', 'readOnly', 'editable', 'lineNumbers', 'foldGutter', 'highlightActiveLineGutter', 'highlightActiveLine', 'lineWrapping', 'autofocus', 'spellcheck', 'direction', 'rtlMoveVisually', 'indentOnLoad', 'indentWithTab', 'indentUnit', 'defaultValue', 'value', 'onChange', 'onFocus', 'onBlur', 'attachment', 'height', 'width',
+// 'darkTheme',
+'elementRef', 'containerRef', 'searchConfig'];