@atlaskit/icon 22.23.0 → 22.24.1

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @atlaskit/icon
 
+## 22.24.1
+
+### Patch Changes
+
+- [#157955](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/157955)
+  [`ea8ebc84a9079`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/ea8ebc84a9079) -
+  Updated migration mapping for several icon entrypoints.
+
+  **`@atlaskit/icon/core/migration`**
+
+  - `content-wrap-left--editor-media-wrap-left`
+  - `content-wrap-right--editor-media-wrap-right`
+  - `discovery--editor-note`
+  - `file--document-filled`
+  - `file--document`
+  - `files--documents`
+  - `minus--editor-divider`
+
+  Updated legacy icons to map to new icons via the icon facade:
+
+  - document → file
+  - document-filled → file
+  - documents → files
+  - editor/divider → minus
+  - editor/media-wrap-left → content-wrap-left
+  - editor/media-wrap-right → content-wrap-right
+  - editor/note → discovery
+
+## 22.24.0
+
+### Minor Changes
+
+- [#155379](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/155379)
+  [`d703fb68d3059`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/d703fb68d3059) -
+  Run build-glyphs in icon packages.
+- [#155379](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/155379)
+  [`d703fb68d3059`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/d703fb68d3059) -
+  Add static imports for icon metadata.
+
 ## 22.23.0
 
 ### Minor Changes

package/afm-cc/tsconfig.json

@@ -5,8 +5,7 @@
         "target": "es5",
         "composite": true,
         "outDir": "../dist",
-        "rootDir": "../",
-        "baseUrl": "../"
+        "rootDir": "../"
     },
     "include": [
         "../src/**/*.ts",

package/core/migration/content-wrap-left--editor-media-wrap-left.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::ed123c466ae8d0fca547a321571416d1>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+
+import React from 'react';
+import type { NewCoreIconProps } from '@atlaskit/icon/UNSAFE_base-new';
+import Icon from '@atlaskit/icon/UNSAFE_base-new';
+
+declare const ContentWrapLeftIconMigration: {
+  (props: Omit<NewCoreIconProps, 'dangerouslySetGlyph' | 'type' | 'LEGACY_fallbackIcon'> ): JSX.Element;
+  displayName: string;
+};
+export default ContentWrapLeftIconMigration;

package/core/migration/content-wrap-left--editor-media-wrap-left.js

@@ -0,0 +1,33 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::aa78811470485bb3a924a1ffc7ba2346>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _contentWrapLeft = _interopRequireDefault(require("@atlaskit/icon/core/content-wrap-left"));
+var _mediaWrapLeft = _interopRequireDefault(require("@atlaskit/icon/glyph/editor/media-wrap-left"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * ⚠️ EXPERIMENTAL ⚠️ - New icons are in alpha - and subject to change or removal in future minor or patch releases.
+ *
+ * Migration Icon component for ContentWrapLeftIcon.
+ * This component is ContentWrapLeftIcon, with `UNSAFE_fallbackIcon` set to "EditorMediaWrapLeftIcon".
+ *
+ * Category: single-purpose
+ * Location: @atlaskit/icon
+ * Usage guidance: Single purpose - Reserved for left aligning media and content with wrapping enabled.
+ * - [Examples](https://atlaskit.atlassian.com/packages/design-system/icon)
+ * - [Code](https://atlaskit.atlassian.com/packages/design-system/icon/docs/custom-icons)
+ */
+const ContentWrapLeftIcon = props => /*#__PURE__*/_react.default.createElement(_contentWrapLeft.default, Object.assign({
+  LEGACY_fallbackIcon: _mediaWrapLeft.default
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+ContentWrapLeftIcon.Name = 'ContentWrapLeftIconMigration';
+var _default = exports.default = ContentWrapLeftIcon;

package/core/migration/content-wrap-right--editor-media-wrap-right.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::ad0c6c4b1a9194856d4378bd807d8750>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+
+import React from 'react';
+import type { NewCoreIconProps } from '@atlaskit/icon/UNSAFE_base-new';
+import Icon from '@atlaskit/icon/UNSAFE_base-new';
+
+declare const ContentWrapRightIconMigration: {
+  (props: Omit<NewCoreIconProps, 'dangerouslySetGlyph' | 'type' | 'LEGACY_fallbackIcon'> ): JSX.Element;
+  displayName: string;
+};
+export default ContentWrapRightIconMigration;

package/core/migration/content-wrap-right--editor-media-wrap-right.js

@@ -0,0 +1,33 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::55a7f1c09c25653217ff074c79cc9853>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _contentWrapRight = _interopRequireDefault(require("@atlaskit/icon/core/content-wrap-right"));
+var _mediaWrapRight = _interopRequireDefault(require("@atlaskit/icon/glyph/editor/media-wrap-right"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * ⚠️ EXPERIMENTAL ⚠️ - New icons are in alpha - and subject to change or removal in future minor or patch releases.
+ *
+ * Migration Icon component for ContentWrapRightIcon.
+ * This component is ContentWrapRightIcon, with `UNSAFE_fallbackIcon` set to "EditorMediaWrapRightIcon".
+ *
+ * Category: single-purpose
+ * Location: @atlaskit/icon
+ * Usage guidance: Single purpose - Reserved for right aligning media and content with wrapping enabled.
+ * - [Examples](https://atlaskit.atlassian.com/packages/design-system/icon)
+ * - [Code](https://atlaskit.atlassian.com/packages/design-system/icon/docs/custom-icons)
+ */
+const ContentWrapRightIcon = props => /*#__PURE__*/_react.default.createElement(_contentWrapRight.default, Object.assign({
+  LEGACY_fallbackIcon: _mediaWrapRight.default
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+ContentWrapRightIcon.Name = 'ContentWrapRightIconMigration';
+var _default = exports.default = ContentWrapRightIcon;

package/core/migration/discovery--editor-note.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::7d66bdbe58cc695156fc227a0654ef06>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+
+import React from 'react';
+import type { NewCoreIconProps } from '@atlaskit/icon/UNSAFE_base-new';
+import Icon from '@atlaskit/icon/UNSAFE_base-new';
+
+declare const DiscoveryIconMigration: {
+  (props: Omit<NewCoreIconProps, 'dangerouslySetGlyph' | 'type' | 'LEGACY_fallbackIcon'> ): JSX.Element;
+  displayName: string;
+};
+export default DiscoveryIconMigration;

package/core/migration/discovery--editor-note.js

@@ -0,0 +1,33 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::9af21fe67c79950014f02edbb68b85b0>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _discovery = _interopRequireDefault(require("@atlaskit/icon/core/discovery"));
+var _note = _interopRequireDefault(require("@atlaskit/icon/glyph/editor/note"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * ⚠️ EXPERIMENTAL ⚠️ - New icons are in alpha - and subject to change or removal in future minor or patch releases.
+ *
+ * Migration Icon component for DiscoveryIcon.
+ * This component is DiscoveryIcon, with `UNSAFE_fallbackIcon` set to "EditorNoteIcon".
+ *
+ * Category: single-purpose
+ * Location: @atlaskit/icon
+ * Usage guidance: Single purpose - Reserved for representing discovery. Used for Note info panel variant in Editor.
+ * - [Examples](https://atlaskit.atlassian.com/packages/design-system/icon)
+ * - [Code](https://atlaskit.atlassian.com/packages/design-system/icon/docs/custom-icons)
+ */
+const DiscoveryIcon = props => /*#__PURE__*/_react.default.createElement(_discovery.default, Object.assign({
+  LEGACY_fallbackIcon: _note.default
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+DiscoveryIcon.Name = 'DiscoveryIconMigration';
+var _default = exports.default = DiscoveryIcon;

package/core/migration/file--document-filled.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::fa14c6d08e368b33546e9c56821965d4>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+
+import React from 'react';
+import type { NewCoreIconProps } from '@atlaskit/icon/UNSAFE_base-new';
+import Icon from '@atlaskit/icon/UNSAFE_base-new';
+
+declare const FileIconMigration: {
+  (props: Omit<NewCoreIconProps, 'dangerouslySetGlyph' | 'type' | 'LEGACY_fallbackIcon'> ): JSX.Element;
+  displayName: string;
+};
+export default FileIconMigration;

package/core/migration/file--document-filled.js

@@ -0,0 +1,33 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::4afbad9fc39f7f3368478b0974fa96af>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _file = _interopRequireDefault(require("@atlaskit/icon/core/file"));
+var _documentFilled = _interopRequireDefault(require("@atlaskit/icon/glyph/document-filled"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * ⚠️ EXPERIMENTAL ⚠️ - New icons are in alpha - and subject to change or removal in future minor or patch releases.
+ *
+ * Migration Icon component for FileIcon.
+ * This component is FileIcon, with `UNSAFE_fallbackIcon` set to "DocumentFilledIcon".
+ *
+ * Category: multi-purpose
+ * Location: @atlaskit/icon
+ * Usage guidance: Multi purpose - Known uses: document, file. Do not use to represent a page — use the dedicated 'Page' icon instead.
+ * - [Examples](https://atlaskit.atlassian.com/packages/design-system/icon)
+ * - [Code](https://atlaskit.atlassian.com/packages/design-system/icon/docs/custom-icons)
+ */
+const FileIcon = props => /*#__PURE__*/_react.default.createElement(_file.default, Object.assign({
+  LEGACY_fallbackIcon: _documentFilled.default
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+FileIcon.Name = 'FileIconMigration';
+var _default = exports.default = FileIcon;

package/core/migration/file--document.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::fa14c6d08e368b33546e9c56821965d4>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+
+import React from 'react';
+import type { NewCoreIconProps } from '@atlaskit/icon/UNSAFE_base-new';
+import Icon from '@atlaskit/icon/UNSAFE_base-new';
+
+declare const FileIconMigration: {
+  (props: Omit<NewCoreIconProps, 'dangerouslySetGlyph' | 'type' | 'LEGACY_fallbackIcon'> ): JSX.Element;
+  displayName: string;
+};
+export default FileIconMigration;

package/core/migration/file--document.js

@@ -0,0 +1,33 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::4f1cf86304d50bc1fd5a255b20c6e894>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _file = _interopRequireDefault(require("@atlaskit/icon/core/file"));
+var _document = _interopRequireDefault(require("@atlaskit/icon/glyph/document"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * ⚠️ EXPERIMENTAL ⚠️ - New icons are in alpha - and subject to change or removal in future minor or patch releases.
+ *
+ * Migration Icon component for FileIcon.
+ * This component is FileIcon, with `UNSAFE_fallbackIcon` set to "DocumentIcon".
+ *
+ * Category: multi-purpose
+ * Location: @atlaskit/icon
+ * Usage guidance: Multi purpose - Known uses: document, file. Do not use to represent a page — use the dedicated 'Page' icon instead.
+ * - [Examples](https://atlaskit.atlassian.com/packages/design-system/icon)
+ * - [Code](https://atlaskit.atlassian.com/packages/design-system/icon/docs/custom-icons)
+ */
+const FileIcon = props => /*#__PURE__*/_react.default.createElement(_file.default, Object.assign({
+  LEGACY_fallbackIcon: _document.default
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+FileIcon.Name = 'FileIconMigration';
+var _default = exports.default = FileIcon;

package/core/migration/files--documents.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::1fa3fa8bdde7f161ef03648f6b07d507>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+
+import React from 'react';
+import type { NewCoreIconProps } from '@atlaskit/icon/UNSAFE_base-new';
+import Icon from '@atlaskit/icon/UNSAFE_base-new';
+
+declare const FilesIconMigration: {
+  (props: Omit<NewCoreIconProps, 'dangerouslySetGlyph' | 'type' | 'LEGACY_fallbackIcon'> ): JSX.Element;
+  displayName: string;
+};
+export default FilesIconMigration;

package/core/migration/files--documents.js

@@ -0,0 +1,33 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::6dc1a5b1450546971bd4971237c7fcf0>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _files = _interopRequireDefault(require("@atlaskit/icon/core/files"));
+var _documents = _interopRequireDefault(require("@atlaskit/icon/glyph/documents"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * ⚠️ EXPERIMENTAL ⚠️ - New icons are in alpha - and subject to change or removal in future minor or patch releases.
+ *
+ * Migration Icon component for FilesIcon.
+ * This component is FilesIcon, with `UNSAFE_fallbackIcon` set to "DocumentsIcon".
+ *
+ * Category: multi-purpose
+ * Location: @atlaskit/icon
+ * Usage guidance: Multi purpose - Known uses: documents, files. Do not use to represent pages — use the dedicated 'Pages' icon instead.
+ * - [Examples](https://atlaskit.atlassian.com/packages/design-system/icon)
+ * - [Code](https://atlaskit.atlassian.com/packages/design-system/icon/docs/custom-icons)
+ */
+const FilesIcon = props => /*#__PURE__*/_react.default.createElement(_files.default, Object.assign({
+  LEGACY_fallbackIcon: _documents.default
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+FilesIcon.Name = 'FilesIconMigration';
+var _default = exports.default = FilesIcon;

package/core/migration/minus--editor-divider.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::0695dd20fb5e5b1c65d4e21a9a397ff2>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+
+import React from 'react';
+import type { NewCoreIconProps } from '@atlaskit/icon/UNSAFE_base-new';
+import Icon from '@atlaskit/icon/UNSAFE_base-new';
+
+declare const MinusIconMigration: {
+  (props: Omit<NewCoreIconProps, 'dangerouslySetGlyph' | 'type' | 'LEGACY_fallbackIcon'> ): JSX.Element;
+  displayName: string;
+};
+export default MinusIconMigration;

package/core/migration/minus--editor-divider.js

@@ -0,0 +1,33 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ * @codegen <<SignedSource::4672c42339fc6e042990bac4beef63a0>>
+ * @codegenCommand yarn build:icon-glyphs
+ */
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _minus = _interopRequireDefault(require("@atlaskit/icon/core/minus"));
+var _divider = _interopRequireDefault(require("@atlaskit/icon/glyph/editor/divider"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * ⚠️ EXPERIMENTAL ⚠️ - New icons are in alpha - and subject to change or removal in future minor or patch releases.
+ *
+ * Migration Icon component for MinusIcon.
+ * This component is MinusIcon, with `UNSAFE_fallbackIcon` set to "EditorDividerIcon".
+ *
+ * Category: multi-purpose
+ * Location: @atlaskit/icon
+ * Usage guidance: Multi purpose - Known uses: horizontal rule in Editor.
+ * - [Examples](https://atlaskit.atlassian.com/packages/design-system/icon)
+ * - [Code](https://atlaskit.atlassian.com/packages/design-system/icon/docs/custom-icons)
+ */
+const MinusIcon = props => /*#__PURE__*/_react.default.createElement(_minus.default, Object.assign({
+  LEGACY_fallbackIcon: _divider.default
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
+}, props));
+MinusIcon.Name = 'MinusIconMigration';
+var _default = exports.default = MinusIcon;

package/dist/cjs/metadata-core.js

@@ -9,7 +9,7 @@ exports.default = void 0;
  *
  * To change the format of this file, modify `UNSAFE_createIconDocsNew` in icon-build-process/src/create-icon-docs.tsx.
  *
- * @codegen <<SignedSource::d76c32c1492b8dd1bef65149c573c900>>
+ * @codegen <<SignedSource::ac7f367e690af67950a58d9f31ed30f7>>
  * @codegenCommand yarn build:icon-glyphs
  */
 
@@ -743,6 +743,7 @@ var metadata = {
     keywords: ['content-wrap-left', 'contentwrapleft', 'icon', 'core', 'content', 'media', 'image', 'alignment', 'left', 'inline', 'wrap'],
     componentName: 'ContentWrapLeftIcon',
     package: '@atlaskit/icon/core/content-wrap-left',
+    oldName: ['editor/media-wrap-left'],
     type: 'core',
     categorization: 'single-purpose',
     usage: 'Single purpose - Reserved for left aligning media and content with wrapping enabled.',
@@ -752,6 +753,7 @@ var metadata = {
     keywords: ['content-wrap-right', 'contentwrapright', 'icon', 'core', 'content', 'media', 'image', 'alignment', 'right', 'inline', 'wrap'],
     componentName: 'ContentWrapRightIcon',
     package: '@atlaskit/icon/core/content-wrap-right',
+    oldName: ['editor/media-wrap-right'],
     type: 'core',
     categorization: 'single-purpose',
     usage: 'Single purpose - Reserved for right aligning media and content with wrapping enabled.',
@@ -914,6 +916,7 @@ var metadata = {
     keywords: ['discovery', 'icon', 'core', 'discovery', 'note', 'filled'],
     componentName: 'DiscoveryIcon',
     package: '@atlaskit/icon/core/discovery',
+    oldName: ['editor/note'],
     type: 'core',
     categorization: 'single-purpose',
     usage: 'Single purpose - Reserved for representing discovery. Used for Note info panel variant in Editor.',
@@ -1160,7 +1163,7 @@ var metadata = {
     keywords: ['file', 'document', 'paper', 'page', 'sheet', 'icon', 'core', 'document', 'file', 'paper'],
     componentName: 'FileIcon',
     package: '@atlaskit/icon/core/file',
-    oldName: ['editor/file', 'file'],
+    oldName: ['document-filled', 'document', 'editor/file', 'file'],
     type: 'core',
     categorization: 'multi-purpose',
     usage: "Multi purpose - Known uses: document, file. Do not use to represent a page — use the dedicated 'Page' icon instead.",
@@ -1170,6 +1173,7 @@ var metadata = {
     keywords: ['files', 'icon', 'core', 'documents', 'files', 'papers'],
     componentName: 'FilesIcon',
     package: '@atlaskit/icon/core/files',
+    oldName: ['documents'],
     type: 'core',
     categorization: 'multi-purpose',
     usage: "Multi purpose - Known uses: documents, files. Do not use to represent pages — use the dedicated 'Pages' icon instead.",
@@ -1779,7 +1783,7 @@ var metadata = {
     keywords: ['minus', 'icon', 'core', 'rule', 'horizontal line', 'divider', 'minus', 'subtract'],
     componentName: 'MinusIcon',
     package: '@atlaskit/icon/core/minus',
-    oldName: ['editor/horizontal-rule'],
+    oldName: ['editor/divider', 'editor/horizontal-rule'],
     type: 'core',
     categorization: 'multi-purpose',
     usage: 'Multi purpose - Known uses: horizontal rule in Editor.',