@atlaskit/editor-core 180.0.0 → 181.0.0

package/CHANGELOG.md

@@ -1,5 +1,122 @@
 # @atlaskit/editor-core
 
+## 181.0.0
+
+### Major Changes
+
+- [`6c543971074`](https://bitbucket.org/atlassian/atlassian-frontend/commits/6c543971074) - [ux] PTC-6520 remove team mention highlight
+
+### Minor Changes
+
+- [`a697f9eb7ca`](https://bitbucket.org/atlassian/atlassian-frontend/commits/a697f9eb7ca) - [ED-16746] Introduce the shareable actions concept into the NextEditorPlugin
+- [`a7e36157e01`](https://bitbucket.org/atlassian/atlassian-frontend/commits/a7e36157e01) - [ED-15941] Refactor Preset into EditorPresetBuilder
+- [`406c29f8cf1`](https://bitbucket.org/atlassian/atlassian-frontend/commits/406c29f8cf1) - ED-15802:Added stickyOffsetTop prop inside useStickyToolbar to support customise top for main toolbar when it is sticky.
+- [`0078ddc7e2e`](https://bitbucket.org/atlassian/atlassian-frontend/commits/0078ddc7e2e) - New smartLinks prop to allow renderer and editor to determine whether smart link should show actions that can change the link resource.
+- [`0ad977ead6d`](https://bitbucket.org/atlassian/atlassian-frontend/commits/0ad977ead6d) - EDM-2674: remove last reference to plainTextPasteLinkification feature flag in cleanup process."
+- [`4292f200ec9`](https://bitbucket.org/atlassian/atlassian-frontend/commits/4292f200ec9) - [ED-16560] Add preset prop to EditorNext
+- [`592e3761622`](https://bitbucket.org/atlassian/atlassian-frontend/commits/592e3761622) - [ED-15941] NextEditorPlugins will receive an api with the plugins dependencies on runtime
+
+### Patch Changes
+
+- [`b38ca291f7b`](https://bitbucket.org/atlassian/atlassian-frontend/commits/b38ca291f7b) - Fixed inlineCode issue cause by apostrophe replacements reported in DTR-987
+- [`1a2ba1a53a9`](https://bitbucket.org/atlassian/atlassian-frontend/commits/1a2ba1a53a9) - ED-17113: Fixed assistive text in mentions not including user name due to async look up.
+- [`deeb5ebee1f`](https://bitbucket.org/atlassian/atlassian-frontend/commits/deeb5ebee1f) - Fix self mention highlighting
+- [`f07824eeccc`](https://bitbucket.org/atlassian/atlassian-frontend/commits/f07824eeccc) - ED-15647 fix undo when pasting table with resized column in expand
+- [`f81e7ba7c07`](https://bitbucket.org/atlassian/atlassian-frontend/commits/f81e7ba7c07) - [ux] ED-16556 Fixed - Table floating toolbar "Table Options" and "Cell Options" are not accessible
+- [`dae1c82956b`](https://bitbucket.org/atlassian/atlassian-frontend/commits/dae1c82956b) - [ux] ED-17122 - Toolbar extension icons use tooltip as aria label
+- [`9d3fb04c725`](https://bitbucket.org/atlassian/atlassian-frontend/commits/9d3fb04c725) - [ED-16948] Fix crash in template editor when image is the first node.
+- [`568b7d96689`](https://bitbucket.org/atlassian/atlassian-frontend/commits/568b7d96689) - [ux] [ED-16819] Prevent up/down arrow from a media selection from creating new paragraphs. Should move to gap cursor instead if it cannot move into node before.
+- [`9dde8374c54`](https://bitbucket.org/atlassian/atlassian-frontend/commits/9dde8374c54) - Update import of EditorCardProvider from `@atlaskit/link-provider` to `@atlaskit/editor-card-provider` for scheduled release packages.
+- [`f7fc96b3738`](https://bitbucket.org/atlassian/atlassian-frontend/commits/f7fc96b3738) - ED-17086 - Added feature flag for expandedChartColors
+- [`a6b3a866e9d`](https://bitbucket.org/atlassian/atlassian-frontend/commits/a6b3a866e9d) - [ux] ED-16941: we now ignore screenshots when pasting text from Microsoft Office when using the image-upload plugin (legacyImageUploadProvider)
+- [`a57e2849f71`](https://bitbucket.org/atlassian/atlassian-frontend/commits/a57e2849f71) - Remove unused code in editor-core that is not imported anywhere
+- [`eb7ef06e38c`](https://bitbucket.org/atlassian/atlassian-frontend/commits/eb7ef06e38c) - Contextual toolbar focus will now be regained when exiting via ArrowLeft / ArrowRight keys, and will progress to the next toolbar item. onBlur will now also be called correctly when dropdown menu items lose focus.
+- [`2661a586431`](https://bitbucket.org/atlassian/atlassian-frontend/commits/2661a586431) - ED-15843 Applied fix for bodiedExtensions animation as per DTR-807
+- [`023b96ba3da`](https://bitbucket.org/atlassian/atlassian-frontend/commits/023b96ba3da) - emoji picker vertical alignment refinement
+- [`db34131a1e4`](https://bitbucket.org/atlassian/atlassian-frontend/commits/db34131a1e4) - [ED-16579] Add methods to Preset object including `setProvider`, `getProvider` and `getAllProviders`.
+
+  These are used internally to set providers (objects which can return functionality such as `emojiProvider`).
+
+- [`8ef5e96b6c4`](https://bitbucket.org/atlassian/atlassian-frontend/commits/8ef5e96b6c4) - Fix that removes remaining layout attribute from inlineCard type during updating from embedCard type to inlineCard type when embed is not allowed.
+- [`7f26be97caf`](https://bitbucket.org/atlassian/atlassian-frontend/commits/7f26be97caf) - [ux] ED-14957: add border color for dark mode for layout
+- [`68f4ce6955d`](https://bitbucket.org/atlassian/atlassian-frontend/commits/68f4ce6955d) - Fix logic to reconfigure state in ReactEditorView to fix a breakage on NCS pages.
+- [`1720ddc8076`](https://bitbucket.org/atlassian/atlassian-frontend/commits/1720ddc8076) - [ux] ED-16725 Added support for semantic tooltip names for background color palette.
+- Updated dependencies
+
+## 180.1.0
+
+### Minor Changes
+
+- [`434699a8b0e`](https://bitbucket.org/atlassian/atlassian-frontend/commits/434699a8b0e) - [ux] [ED-15904] Implements new functionality for the restart numbered lists project which allows a user to paste a block node into a list. It will now split the list and insert the node in that position. If it's an ordered list, list numbering will continue in the now split list.
+
+  This feature is behind the `restartNumberedLists` feature flag.
+
+  The change also includes a refactor to handle pasting of content from decisions into lists which should paste just the content, but currently pastes the wrapping decision node as well. This was previously only handled for panels, but also applies to decisions. This is not behind the feature flag.
+
+- [`15059b00c15`](https://bitbucket.org/atlassian/atlassian-frontend/commits/15059b00c15) - [ED-16585] Allow editorActions.replaceSelection and processRawValue to accept fragments. Allow quickInsert actions on extensions to return a fragment.
+- [`c22905e224e`](https://bitbucket.org/atlassian/atlassian-frontend/commits/c22905e224e) - [ux] ED-16335: First menu item gains focus when the dropdown menu is opened by keyboard.
+- [`9a25538e0ef`](https://bitbucket.org/atlassian/atlassian-frontend/commits/9a25538e0ef) - [ux] ED-16723 Custom panel background color is tokensied. More details at https://hello.atlassian.net/wiki/spaces/DST/pages/2382075153/Draft+Custom+panel+background+color+is+tokenised
+- [`6ec4f0aca5a`](https://bitbucket.org/atlassian/atlassian-frontend/commits/6ec4f0aca5a) - [ED-16558] Introduces a new parameter for ReactEditorView (getEditorPlugins) which can be used to return a list of EditorPlugins used by the component.
+
+  This parameter is optional, for existing behaviour pass undefined.
+
+- [`1d11b24f17e`](https://bitbucket.org/atlassian/atlassian-frontend/commits/1d11b24f17e) - [ux] ED-15549 Implemented keyboard navigation in color palette
+- [`52c5dfd3a76`](https://bitbucket.org/atlassian/atlassian-frontend/commits/52c5dfd3a76) - [ux] ED-15902 fixed an issue where the user types when the floating toolbar is scrolled, it resets scroll position to the left most position
+- [`710adab73cf`](https://bitbucket.org/atlassian/atlassian-frontend/commits/710adab73cf) - [ED-16557] Introduces EditorMigrationComponent which
+  can be used as a replacement for Editor. This
+  component calls Editor under the hood but if the
+  `useEditorNext` feature flag is active will start
+  using an experimental version of the Editor API.
+
+  At this stage Makers can start adopting
+  EditorMigrationComponent to replace the Editor
+  component.
+
+  This change also introduces the `useEditorNext`
+  feature flag. Activating this flag will start to use
+  the new Editor API.
+
+  Warning: This new Editor API is in development and
+  should not be used until the EditorNext component is
+  released and the API is stable.
+
+- [`56d6c797d39`](https://bitbucket.org/atlassian/atlassian-frontend/commits/56d6c797d39) - ED-16654 Calculate correct input latency and also added other timings for it
+
+### Patch Changes
+
+- [`2ee31675e66`](https://bitbucket.org/atlassian/atlassian-frontend/commits/2ee31675e66) - [ED-16557] Refactor Editor and EditorNext to share common code in editor-core.
+
+  Introduce new hooks in editor-common including:
+
+  1. `usePreviousState` can be used to remember the last props passed to a functional component
+
+  2. `useConstructor` can be used to run only once on a functional component
+
+- [`278411ec1e2`](https://bitbucket.org/atlassian/atlassian-frontend/commits/278411ec1e2) - [ED-17022] Fixed regression issue where the typeahead caret was black and on firefox the caret was shifted down
+- [`21168c61c7d`](https://bitbucket.org/atlassian/atlassian-frontend/commits/21168c61c7d) - [MEX-2205] Remove mediaGroupNodes and all the related logic
+- [`6dc6528ffab`](https://bitbucket.org/atlassian/atlassian-frontend/commits/6dc6528ffab) - ED-16888 Fix backslash duplication in codeBlock when pasting as plain text
+- [`cc150a98124`](https://bitbucket.org/atlassian/atlassian-frontend/commits/cc150a98124) - [ED-17041] Fix createAnalytics stub API fallback logic
+- [`286cc5d6e94`](https://bitbucket.org/atlassian/atlassian-frontend/commits/286cc5d6e94) - Minor improvement to WidthEmitter to stop console error logging and test migration.
+- [`6a031b9b2da`](https://bitbucket.org/atlassian/atlassian-frontend/commits/6a031b9b2da) - [ED-16334] Merge NextEditorPlugin interface with NextEditorPluginWithDependencies
+- [`f5bb69ce155`](https://bitbucket.org/atlassian/atlassian-frontend/commits/f5bb69ce155) - Add location attribute to Generic card and EditorLinkPicker
+- [`d0c2b12418d`](https://bitbucket.org/atlassian/atlassian-frontend/commits/d0c2b12418d) - [ED-16826] Add codemod to migrate from Editor to EditorMigrationComponent.
+- [`05c8f919801`](https://bitbucket.org/atlassian/atlassian-frontend/commits/05c8f919801) - ESS-3046 modify documentAri in collaborative editing example
+- [`2d8955e4740`](https://bitbucket.org/atlassian/atlassian-frontend/commits/2d8955e4740) - Remove UNSAFE lifecycle method from PanelTextInput.
+- [`c3eba8c788d`](https://bitbucket.org/atlassian/atlassian-frontend/commits/c3eba8c788d) - Updates Media Viewer input data object
+- [`e907b6924cc`](https://bitbucket.org/atlassian/atlassian-frontend/commits/e907b6924cc) - [ux] ED-16505 Update confirmation dialog message shown when data source element is about to removed
+- [`373b2c585c3`](https://bitbucket.org/atlassian/atlassian-frontend/commits/373b2c585c3) - [ED-16578] Inject stubs apis to reduce amount of parameters on preset creation
+- [`2d6074f31bb`](https://bitbucket.org/atlassian/atlassian-frontend/commits/2d6074f31bb) - ED-16740: [ux] Updated the dropdown menu to shift the focus for indentation and outdentation button to their respective opposite in case they become disabled. Also added fallback case where any disabled button will adjust focus to the next button down in the dropdown menu
+- [`6ab06e05f95`](https://bitbucket.org/atlassian/atlassian-frontend/commits/6ab06e05f95) - [ED-16607] Pass popupsMountPoint to status plugin
+- [`3a3ff6a8735`](https://bitbucket.org/atlassian/atlassian-frontend/commits/3a3ff6a8735) - Fixed issue where typeahead was wrapping incorrectly
+- [`4d5404b104c`](https://bitbucket.org/atlassian/atlassian-frontend/commits/4d5404b104c) - [ux] ED-16400 - Ensure no local id is copied over when copy/pasting a table row
+- [`81d9a6b42c4`](https://bitbucket.org/atlassian/atlassian-frontend/commits/81d9a6b42c4) - [ux] ED-16592 fix existed table name been copied that cannot regenerate
+- [`a6cf418fe1b`](https://bitbucket.org/atlassian/atlassian-frontend/commits/a6cf418fe1b) - ED-16904 Fixed floating toolbar disappearing on clicking color picker button."
+- [`dfb37c5d4c2`](https://bitbucket.org/atlassian/atlassian-frontend/commits/dfb37c5d4c2) - [ED-16752] Migrated fireAnlyticsEvent, getAnalyticsEventsFromTransaction, FireAnalyticsEvent, FireAnalyticsEventPayload
+  and extended FireAnalyticsEvent type with optional createAnalyticsEvent parameter in @atlaskit/editor-common. Decoupled
+  plugin dependency in some areas of @atlaskit/editor-core to now use the migrated code from @atlaskit/editor-common instead by
+  updating import endpoints.
+- Updated dependencies
+
 ## 180.0.0
 
 ### Patch Changes

package/codemods/180.1.0-update-to-editor-migration-component.ts

@@ -0,0 +1,8 @@
+import { renameEditorToMigrationComponent } from './migrates/rename-editor-to-editor-migration-component';
+import { createTransformer } from './utils';
+
+const transformer = createTransformer('@atlaskit/editor-core', [
+  renameEditorToMigrationComponent,
+]);
+
+export default transformer;

package/codemods/__tests__/rename-editor-to-editor-migration-component.ts

@@ -0,0 +1,156 @@
+jest.autoMockOff();
+
+import { createTransformer } from '../utils';
+import { renameEditorToMigrationComponent } from '../migrates/rename-editor-to-editor-migration-component';
+// This stays as require() since changing to import will trigger a linter error
+const defineInlineTest = require('jscodeshift/dist/testUtils').defineInlineTest;
+
+const transformer = createTransformer('@atlaskit/editor-core', [
+  renameEditorToMigrationComponent,
+]);
+
+describe('Update Editor to EditorMigrationComponent', () => {
+  defineInlineTest(
+    { default: transformer, parser: 'tsx' },
+    {},
+    `
+    import React from 'react';
+    import { Editor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <Editor />
+    );
+    `, // -----
+    `
+    import React from 'react';
+    import { EditorMigrationComponent as Editor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <Editor />
+    );
+    `, // -----
+    'update editor component',
+  );
+
+  defineInlineTest(
+    { default: transformer, parser: 'tsx' },
+    {},
+    `
+    import React from 'react';
+    import { Editor as AkEditor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor />
+    );
+    `, // -----
+    `
+    import React from 'react';
+    import { EditorMigrationComponent as AkEditor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor />
+    );
+    `, // -----
+    'update editor component to keep same local name',
+  );
+
+  defineInlineTest(
+    { default: transformer, parser: 'tsx' },
+    {},
+    `
+    import React from 'react';
+    import { Editor as AkEditor, ContextPanel } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor />
+    );
+    `, // -----
+    `
+    import React from 'react';
+    import { EditorMigrationComponent as AkEditor, ContextPanel } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor />
+    );
+    `, // -----
+    'update editor component to not modify other components',
+  );
+
+  defineInlineTest(
+    { default: transformer, parser: 'tsx' },
+    {},
+    `
+    import React from 'react';
+    import { ContextPanel } from '@atlaskit/editor-core';
+
+    export default () => (
+      <div />
+    );
+    `, // -----
+    `
+    import React from 'react';
+    import { ContextPanel } from '@atlaskit/editor-core';
+
+    export default () => (
+      <div />
+    );
+    `, // -----
+    'nothing should change if there is no editor',
+  );
+
+  defineInlineTest(
+    { default: transformer, parser: 'tsx' },
+    {},
+    `
+    import React from 'react';
+    import SomethingElse, { Editor } from 'cool-package'
+    import { Editor as AkEditor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor>
+        <Editor />
+      </AkEditor>
+    );
+    `, // -----
+    `
+    import React from 'react';
+    import SomethingElse, { Editor } from 'cool-package'
+    import { EditorMigrationComponent as AkEditor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor>
+        <Editor />
+      </AkEditor>
+    );
+    `, // -----
+    'should not change named exports from other packages that are called Editor',
+  );
+
+  defineInlineTest(
+    { default: transformer, parser: 'tsx' },
+    {},
+    `
+    import React from 'react';
+    import Editor from 'cool-package'
+    import { Editor as AkEditor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor>
+        <Editor />
+      </AkEditor>
+    );
+    `, // -----
+    `
+    import React from 'react';
+    import Editor from 'cool-package'
+    import { EditorMigrationComponent as AkEditor } from '@atlaskit/editor-core';
+
+    export default () => (
+      <AkEditor>
+        <Editor />
+      </AkEditor>
+    );
+    `, // -----
+    'should not change exports from other packages that has a default export of Editor',
+  );
+});

package/codemods/migrates/rename-editor-to-editor-migration-component.ts

@@ -0,0 +1,34 @@
+import core from 'jscodeshift';
+import { Collection } from 'jscodeshift/src/Collection';
+
+/**
+ * Generate a codemod to move component from Editor to
+ * EditorMigrationComponent
+ * Ref: ED-16826
+ */
+export const createUpdateEditorToMigrationComponent = (
+  pkg: string,
+  component: string,
+) => {
+  return (j: core.JSCodeshift, source: Collection<any>) => {
+    source
+      .find(j.ImportDeclaration, { source: { value: pkg } })
+      .filter(
+        (path) =>
+          j(path).find(j.ImportSpecifier, {
+            imported: { type: 'Identifier', name: component },
+          }).length > 0,
+      )
+      .find(j.ImportSpecifier)
+      .filter((path) => path.node.imported.name === component)
+      .replaceWith((currentImport) =>
+        j.importSpecifier(
+          j.identifier('EditorMigrationComponent'),
+          currentImport.node.local,
+        ),
+      );
+  };
+};
+
+export const renameEditorToMigrationComponent =
+  createUpdateEditorToMigrationComponent('@atlaskit/editor-core', 'Editor');

package/dist/cjs/actions/index.js

@@ -11,17 +11,17 @@ var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/cl
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _prosemirrorModel = require("prosemirror-model");
+var _utils = require("@atlaskit/editor-common/utils");
 var _prosemirrorState = require("prosemirror-state");
 var _prosemirrorUtils = require("prosemirror-utils");
-var _utils = require("../utils");
-var _document = require("../utils/document");
-var _action = require("../utils/action");
 var _eventDispatcher = require("../event-dispatcher");
-var _utils2 = require("@atlaskit/editor-common/utils");
-var _utils3 = require("../plugins/extension/utils");
-var _getFeatureFlags = require("../plugins/feature-flags-context/get-feature-flags");
 var _nativeCollabProviderPlugin = require("../plugins/collab-edit/native-collab-provider-plugin");
+var _utils2 = require("../plugins/extension/utils");
+var _getFeatureFlags = require("../plugins/feature-flags-context/get-feature-flags");
+var _utils3 = require("../utils");
+var _action = require("../utils/action");
 var _deprecationWarnings = _interopRequireDefault(require("../utils/deprecation-warnings"));
+var _document = require("../utils/document");
 var _nodesByLocalIds = require("../utils/nodes-by-localIds");
 var EditorActions = /*#__PURE__*/function () {
   function EditorActions() {
@@ -31,7 +31,7 @@ var EditorActions = /*#__PURE__*/function () {
     (0, _defineProperty2.default)(this, "dispatchAnalyticsEvent", function (payload) {
       if (_this.eventDispatcher) {
         var dispatch = (0, _eventDispatcher.createDispatch)(_this.eventDispatcher);
-        dispatch(_utils2.analyticsEventKey, {
+        dispatch(_utils.analyticsEventKey, {
           payload: payload
         });
       }
@@ -149,7 +149,22 @@ var EditorActions = /*#__PURE__*/function () {
       if (!this.editorView || this.editorView.hasFocus()) {
         return false;
       }
-      this.editorView.focus();
+
+      // If we focus on componentDidMount the editor can crash due to a prosemirror error.
+      // This is fixed in prosemirror-view@1.23.7
+      // See: https:github.com/ProseMirror/prosemirror-view/commit/735b88107d1cbe7575a188edb85f05c22fb56e35
+      //
+      // We don't want this error to crash the editor in the case we can't
+      // focus correctly.
+      // Revert workaround in: https://product-fabric.atlassian.net/browse/ED-17172
+      try {
+        this.editorView.focus();
+      } catch (err) {
+        if (process.env.NODE_ENV !== 'production') {
+          // eslint-disable-next-line no-console
+          console.error('EditorView focus failed with an error', err);
+        }
+      }
       this.editorView.dispatch(this.editorView.state.tr.scrollIntoView());
       return true;
     }
@@ -223,7 +238,7 @@ var EditorActions = /*#__PURE__*/function () {
                 return (0, _action.getEditorValueWithMedia)(editorView);
               case 5:
                 doc = _context3.sent;
-                json = (0, _utils.toJSON)(doc);
+                json = (0, _utils3.toJSON)(doc);
                 if (this.contentEncode) {
                   _context3.next = 9;
                   break;
@@ -250,7 +265,7 @@ var EditorActions = /*#__PURE__*/function () {
       var _this$editorView;
       if ((_this$editorView = this.editorView) !== null && _this$editorView !== void 0 && _this$editorView.state) {
         var _findNodePosWithLocal, _this$editorView2;
-        return (_findNodePosWithLocal = (0, _utils3.findNodePosWithLocalId)((_this$editorView2 = this.editorView) === null || _this$editorView2 === void 0 ? void 0 : _this$editorView2.state, id)) === null || _findNodePosWithLocal === void 0 ? void 0 : _findNodePosWithLocal.node;
+        return (_findNodePosWithLocal = (0, _utils2.findNodePosWithLocalId)((_this$editorView2 = this.editorView) === null || _this$editorView2 === void 0 ? void 0 : _this$editorView2.state, id)) === null || _findNodePosWithLocal === void 0 ? void 0 : _findNodePosWithLocal.node;
       }
     }
   }, {
@@ -329,7 +344,7 @@ var EditorActions = /*#__PURE__*/function () {
         return true;
       }
       var schema = state.schema;
-      var content = (0, _document.processRawValue)(schema, rawValue);
+      var content = Array.isArray(rawValue) ? (0, _document.processRawFragmentValue)(schema, rawValue) : (0, _document.processRawValue)(schema, rawValue);
       if (!content) {
         return false;
       }

package/dist/cjs/analytics-api/attach-payload-into-transaction.js

@@ -20,7 +20,7 @@ var attachPayloadIntoTransaction = function attachPayloadIntoTransaction(_ref) {
   tr.step(new _steps.AnalyticsStep([{
     payload: payload,
     channel: channel
-  }], actionsToIgnore, tr.selection.$from.pos) // We need to create the step based on a position, this prevent split history for relative changes.
+  }], actionsToIgnore, editorState.selection.$from.pos) // We need to create the step based on a position, this prevent split history for relative changes.
   );
 
   // When you add a new step all the storedMarks are removed it