feat(Slug): implement AI Slug

packages/carbon-components-react/scss/components/slug/_index.scss

@@ -0,0 +1,9 @@
+// Code generated by carbon-components-react. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@forward '@carbon/styles/scss/components/slug';

packages/carbon-components-react/scss/components/slug/_slug.scss

@@ -0,0 +1,9 @@
+// Code generated by carbon-components-react. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@forward '@carbon/styles/scss/components/slug/slug';

packages/carbon-components/scss/components/slug/_index.scss

@@ -0,0 +1,9 @@
+// Code generated by carbon-components. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@forward '@carbon/styles/scss/components/slug';

packages/carbon-components/scss/components/slug/_slug.scss

@@ -0,0 +1,9 @@
+// Code generated by carbon-components. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@forward '@carbon/styles/scss/components/slug/slug';

packages/elements/src/__tests__/__snapshots__/PublicAPI-test.js.snap

@@ -271,6 +271,15 @@ Array [
   "skeletonElement",
   "slow01",
   "slow02",
+  "slugBackground",
+  "slugBackgroundHover",
+  "slugCalloutAuraEnd",
+  "slugCalloutAuraStart",
+  "slugCalloutGradientBottom",
+  "slugCalloutGradientTop",
+  "slugGradient",
+  "slugGradientHover",
+  "slugHollowHover",
   "spacing",
   "spacing01",
   "spacing02",

packages/react/__tests__/__snapshots__/PublicAPI-test.js.snap

@@ -8781,6 +8781,9 @@ Map {
       "as": Object {
         "type": "elementType",
       },
+      "autoAlign": Object {
+        "type": "bool",
+      },
       "children": Object {
         "type": "node",
       },

packages/react/scss/components/slug/_index.scss

@@ -0,0 +1,9 @@
+// Code generated by @carbon/react. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@forward '@carbon/styles/scss/components/slug';

packages/react/scss/components/slug/_slug.scss

@@ -0,0 +1,9 @@
+// Code generated by @carbon/react. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@forward '@carbon/styles/scss/components/slug/slug';

packages/react/src/components/Slug/Slug.js

@@ -0,0 +1,136 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import cx from 'classnames';
+import PropTypes from 'prop-types';
+import React from 'react';
+
+import { usePrefix } from '../../internal/usePrefix';
+import {
+  Toggletip,
+  ToggletipButton,
+  ToggletipContent,
+  ToggletipActions,
+} from '../Toggletip';
+
+const Slug = React.forwardRef(function Slug(
+  {
+    aiText = 'AI',
+    aiTextLabel,
+    align,
+    autoAlign = false,
+    className,
+    dotType,
+    kind,
+    size = 'xs',
+    slugContent,
+  },
+  ref
+) {
+  const prefix = usePrefix();
+
+  const slugClasses = cx(className, {
+    [`${prefix}--slug`]: true,
+    [`${prefix}--slug--hollow`]: kind === 'hollow' || dotType === 'hollow',
+    // Need to come up with a better name; explainable?
+    // Need to be able to target the non-hollow variant another way
+    // other than using `:not` all over the styles
+    [`${prefix}--slug--enabled`]: kind !== 'hollow' && dotType !== 'hollow',
+  });
+
+  const slugButtonClasses = cx({
+    [`${prefix}--slug__button`]: true,
+    [`${prefix}--slug__button--${size}`]: size,
+    [`${prefix}--slug__button--${kind}`]: kind,
+    [`${prefix}--slug__button--inline-with-content`]:
+      kind === 'inline' && aiTextLabel,
+  });
+
+  return (
+    <div className={slugClasses} ref={ref}>
+      <Toggletip align={align} autoAlign={autoAlign}>
+        <ToggletipButton className={slugButtonClasses} label="Show information">
+          <span className={`${prefix}--slug__text`}>{aiText}</span>
+          {aiTextLabel && (
+            <span className={`${prefix}--slug__additional-text`}>
+              {aiTextLabel}
+            </span>
+          )}
+        </ToggletipButton>
+        <ToggletipContent>
+          {slugContent}
+          <ToggletipActions></ToggletipActions>
+        </ToggletipContent>
+      </Toggletip>
+    </div>
+  );
+});
+
+Slug.propTypes = {
+  /**
+   * Specify the correct translation of the AI text
+   */
+  aiText: PropTypes.string,
+
+  /**
+   * Specify additional text to be rendered next to the AI label in the inline variant
+   */
+  aiTextLabel: PropTypes.string,
+
+  /**
+   * Specify how the popover should align with the button
+   */
+  align: PropTypes.oneOf([
+    'top',
+    'top-left',
+    'top-right',
+
+    'bottom',
+    'bottom-left',
+    'bottom-right',
+
+    'left',
+    'left-bottom',
+    'left-top',
+
+    'right',
+    'right-bottom',
+    'right-top',
+  ]),
+
+  /**
+   * Will auto-align the popover on first render if it is not visible. This prop is currently experimental and is subject to future changes.
+   */
+  autoAlign: PropTypes.bool,
+
+  /**
+   * Specify an optional className to be added to the AI slug
+   */
+  className: PropTypes.string,
+
+  /**
+   * Specify the type of dot that should be rendered in front of the inline variant
+   */
+  dotType: PropTypes.oneOf(['default', 'hollow']),
+
+  /**
+   * Specify the type of Slug, from the following list of types:
+   */
+  kind: PropTypes.oneOf(['default', 'hollow', 'inline']),
+
+  /**
+   * Specify the size of the button, from the following list of sizes:
+   */
+  size: PropTypes.oneOf(['mini', '2xs', 'xs', 'sm', 'md', 'lg', 'xl']),
+
+  /**
+   * Specify the content you want rendered inside the slug ToggleTip
+   */
+  slugContent: PropTypes.node,
+};
+
+export default Slug;

packages/react/src/components/Slug/Slug.mdx

@@ -0,0 +1 @@
+Hello

packages/react/src/components/Slug/Slug.stories.js

@@ -0,0 +1,148 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/* eslint-disable no-console */
+
+import React from 'react';
+
+import Slug from '.';
+import Button from '../Button';
+import mdx from './Slug.mdx';
+import './slug-story.scss';
+
+export default {
+  title: 'Experimental/unstable__Slug',
+  component: Slug,
+  parameters: {
+    docs: {
+      page: mdx,
+    },
+  },
+};
+
+const aiContent = (
+  <div>
+    <p className="secondary">AI Explained</p>
+    <h1>84%</h1>
+    <p className="secondary bold">Confidence score</p>
+    <p className="secondary">
+      Lorem ipsum dolor sit amet, di os consectetur adipiscing elit, sed do
+      eiusmod tempor incididunt ut fsil labore et dolore magna aliqua.
+    </p>
+    <hr />
+    <p className="secondary">Model type</p>
+    <p className="bold">Foundation model</p>
+  </div>
+);
+
+const content = <span>AI was used to generate this content</span>;
+
+export const Default = () => (
+  <>
+    <div className="slug-container">
+      <Slug autoAlign size="mini" slugContent={aiContent} />
+      <Slug autoAlign size="2xs" slugContent={aiContent} />
+      <Slug autoAlign size="xs" slugContent={aiContent} />
+      <Slug autoAlign size="sm" slugContent={aiContent} />
+      <Slug autoAlign size="md" slugContent={aiContent} />
+      <Slug autoAlign size="lg" slugContent={aiContent} />
+      <Slug autoAlign size="xl" slugContent={aiContent} />
+    </div>
+    <div className="slug-container">
+      <Slug kind="hollow" autoAlign size="mini" slugContent={content} />
+      <Slug kind="hollow" autoAlign size="2xs" slugContent={content} />
+      <Slug kind="hollow" autoAlign size="xs" slugContent={content} />
+    </div>
+    <div className="slug-container">
+      <Slug autoAlign kind="inline" size="sm" slugContent={aiContent} />
+      <Slug autoAlign kind="inline" size="md" slugContent={aiContent} />
+      <Slug autoAlign kind="inline" size="lg" slugContent={aiContent} />
+    </div>
+    <div className="slug-container">
+      <Slug
+        autoAlign
+        kind="inline"
+        size="sm"
+        aiTextLabel="Text goes here"
+        slugContent={aiContent}
+      />
+      <Slug
+        autoAlign
+        kind="inline"
+        size="md"
+        aiTextLabel="Text goes here"
+        slugContent={aiContent}
+      />
+      <Slug
+        autoAlign
+        kind="inline"
+        size="lg"
+        aiTextLabel="Text goes here"
+        slugContent={aiContent}
+      />
+    </div>
+    <div className="slug-container">
+      <Slug
+        autoAlign
+        kind="inline"
+        dotType="hollow"
+        size="sm"
+        slugContent={content}
+      />
+      <Slug
+        autoAlign
+        kind="inline"
+        dotType="hollow"
+        size="md"
+        slugContent={content}
+      />
+      <Slug
+        autoAlign
+        kind="inline"
+        dotType="hollow"
+        size="lg"
+        slugContent={content}
+      />
+    </div>
+    <div className="slug-container">
+      <Slug
+        autoAlign
+        kind="inline"
+        dotType="hollow"
+        size="sm"
+        aiTextLabel="Text goes here"
+        slugContent={content}
+      />
+      <Slug
+        autoAlign
+        kind="inline"
+        dotType="hollow"
+        size="md"
+        aiTextLabel="Text goes here"
+        slugContent={content}
+      />
+      <Slug
+        autoAlign
+        kind="inline"
+        dotType="hollow"
+        size="lg"
+        aiTextLabel="Text goes here"
+        slugContent={content}
+      />
+    </div>
+  </>
+);
+
+export const Playground = (args) => (
+  <>
+    <div className="slug-container">
+      <Slug autoAlign slugContent={aiContent} {...args} />
+    </div>
+    <Button>Test</Button>
+    <Button kind="danger">Test</Button>
+  </>
+);

packages/react/src/components/Slug/index.js

@@ -0,0 +1,10 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import Slug from './Slug';
+
+export default Slug;
+export { Slug };