@salesforcedevs/docs-components 1.34.1-redoc-latest-banner-2 → 1.34.3

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2020, Salesforce.com, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+* Neither the name of Salesforce.com nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/package.json

@@ -1,30 +1,29 @@
 {
-  "name": "@salesforcedevs/docs-components",
-  "version": "1.34.1-redoc-latest-banner-2",
-  "description": "Docs Lightning web components for DSC",
-  "license": "MIT",
-  "main": "index.js",
-  "engines": {
-    "node": "22.x"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@api-components/amf-helper-mixin": "4.5.29",
-    "classnames": "2.5.1",
-    "dompurify": "3.2.4",
-    "kagekiri": "1.4.2",
-    "lodash.orderby": "4.6.0",
-    "lodash.uniqby": "4.7.0",
-    "query-string": "7.1.3",
-    "sentence-case": "3.0.4"
-  },
-  "devDependencies": {
-    "@types/classnames": "2.3.1",
-    "@types/lodash.orderby": "4.6.9",
-    "@types/lodash.uniqby": "4.7.9"
-  },
-  "gitHead": "4629fdd9ca18a13480044ad43515b91945d16aad",
-  "stableVersion": "1.34.0"
-}
+    "name": "@salesforcedevs/docs-components",
+    "version": "1.34.3",
+    "description": "Docs Lightning web components for DSC",
+    "license": "MIT",
+    "main": "index.js",
+    "engines": {
+        "node": "22.x"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "@api-components/amf-helper-mixin": "4.5.29",
+        "classnames": "2.5.1",
+        "dompurify": "3.2.4",
+        "kagekiri": "1.4.2",
+        "lodash.orderby": "4.6.0",
+        "lodash.uniqby": "4.7.0",
+        "query-string": "7.1.3",
+        "sentence-case": "3.0.4"
+    },
+    "devDependencies": {
+        "@types/classnames": "2.3.1",
+        "@types/lodash.orderby": "4.6.9",
+        "@types/lodash.uniqby": "4.7.9"
+    },
+    "gitHead": "c8c3bb1003d40a55fdd5733c7891dcca3931fb24"
+}

package/src/modules/doc/contentActionToolbar/constants.ts

@@ -0,0 +1,43 @@
+export const DEFAULT_TOOLTIP_LABEL = "Click to copy";
+export const COPIED_TOOLTIP_LABEL = "Copied!";
+export const COPIED_RESET_MS = 1000;
+
+export const ANALYTICS_CONTENT_CATEGORY = "content action toolbar";
+export const MORE_ACTIONS_LABEL = "More actions";
+
+export const COPY_MARKDOWN_LABEL = "Copy as Markdown";
+export const VIEW_MARKDOWN_LABEL = "View as Markdown";
+export const COPY_MARKDOWN_URL_LABEL = "Copy URL to Markdown";
+export const VIEW_LLMS_LABEL = "View llms.txt";
+export const COPY_LLMS_URL_LABEL = "Copy URL to llms.txt";
+export const OPEN_CHATGPT_LABEL = "Open in ChatGPT";
+export const OPEN_CLAUDE_LABEL = "Open in Claude";
+export const OPEN_PERPLEXITY_LABEL = "Open in Perplexity";
+
+export const LLMS_TXT_PATH = "/docs/llms.txt";
+export const CHATGPT_URL = "https://chatgpt.com/";
+export const CLAUDE_URL = "https://claude.ai/new";
+export const PERPLEXITY_URL = "https://www.perplexity.ai/search";
+
+export const ACTION_COPY_MARKDOWN = "copy-markdown";
+export const ACTION_VIEW_MARKDOWN = "view-markdown";
+export const ACTION_COPY_MARKDOWN_URL = "copy-markdown-url";
+export const ACTION_VIEW_LLMS = "view-llms";
+export const ACTION_COPY_LLMS_URL = "copy-llms-url";
+export const ACTION_OPEN_CHATGPT = "open-chatgpt";
+export const ACTION_OPEN_CLAUDE = "open-claude";
+export const ACTION_OPEN_PERPLEXITY = "open-perplexity";
+
+export const AI_ASSISTANTS = [
+    {
+        action: ACTION_OPEN_CHATGPT,
+        base: CHATGPT_URL,
+        label: OPEN_CHATGPT_LABEL
+    },
+    { action: ACTION_OPEN_CLAUDE, base: CLAUDE_URL, label: OPEN_CLAUDE_LABEL },
+    {
+        action: ACTION_OPEN_PERPLEXITY,
+        base: PERPLEXITY_URL,
+        label: OPEN_PERPLEXITY_LABEL
+    }
+] as const;

package/src/modules/doc/contentActionToolbar/contentActionToolbar.css

@@ -2,16 +2,27 @@
 
 :host {
     display: block;
+
+    /* 4px gap below the trigger, and the same 4px gap above when the menu
+       flips */
+    --popover-container-open-transform: translateY(var(--dx-g-spacing-xs));
+    --popover-container-open-transform-up: translateY(
+        calc(-1 * var(--dx-g-spacing-xs))
+    );
 }
 
 .toolbar {
     display: flex;
     align-items: center;
-    flex-wrap: wrap;
+    flex-wrap: nowrap;
     gap: var(--dx-g-spacing-smd);
     margin-bottom: var(--dx-g-spacing-lg);
 }
 
+.toolbar > * {
+    flex-shrink: 0;
+}
+
 .toolbar-button {
     --dx-c-button-font-weight: var(--dx-g-font-demi);
     --dx-c-button-line-height: var(--dx-g-spacing-mlg);
@@ -24,9 +35,26 @@
     background-color: var(--dx-g-gray-70);
 }
 
-@media screen and (max-width: 480px) {
-    .toolbar-button_copy-url,
-    .divider_copy-url {
-        display: none;
-    }
+.toolbar_no-markdown .divider_view-llms {
+    display: none;
+}
+
+.toolbar-menu {
+    --dx-c-popover-z-index: calc(var(--dx-g-z-index-100) + 6);
+
+    flex: 0 0 auto;
+}
+
+.menu-trigger {
+    white-space: nowrap;
+    flex-shrink: 0;
+}
+
+.toolbar > [data-overflow="true"] {
+    display: none;
+}
+
+.toolbar > .divider_view-markdown[data-overflow="true"] ~ .divider_menu,
+.toolbar_no-markdown .divider_menu {
+    display: none;
 }

package/src/modules/doc/contentActionToolbar/contentActionToolbar.html

@@ -1,53 +1,88 @@
 <template>
-    <div class="toolbar" lwc:if={markdownUrl}>
-        <dx-tooltip placement="top-right" label={copyMarkdownLabel}>
+    <div class={toolbarClass}>
+        <template lwc:if={hasMarkdown}>
+            <dx-tooltip
+                placement="top-right"
+                label={copyMarkdownTooltipLabel}
+                visible={copyMarkdownTooltipVisible}
+            >
+                <dx-button
+                    class="toolbar-button"
+                    variant="inline"
+                    size="small"
+                    icon-sprite="utility"
+                    icon-symbol="copy"
+                    icon-size="medium"
+                    icon-position="right"
+                    aria-label={copyMarkdownButtonText}
+                    onclick={handleCopyMarkdown}
+                >
+                    {copyMarkdownButtonText}
+                </dx-button>
+            </dx-tooltip>
+
+            <div class="divider divider_view-markdown"></div>
+
             <dx-button
-                class="toolbar-button"
+                class="toolbar-button toolbar-button_view-markdown"
                 variant="inline"
                 size="small"
                 icon-sprite="utility"
-                icon-symbol="copy"
+                icon-symbol="new_window"
                 icon-size="medium"
                 icon-position="right"
-                aria-label={copyMarkdownButtonText}
-                onclick={handleCopyMarkdown}
+                aria-label={viewMarkdownButtonText}
+                onclick={handleViewMarkdown}
             >
-                {copyMarkdownButtonText}
+                {viewMarkdownButtonText}
             </dx-button>
-        </dx-tooltip>
+        </template>
 
-        <div class="divider"></div>
+        <div class="divider divider_view-llms"></div>
 
         <dx-button
-            class="toolbar-button"
+            class="toolbar-button toolbar-button_view-llms"
             variant="inline"
             size="small"
             icon-sprite="utility"
             icon-symbol="new_window"
             icon-size="medium"
             icon-position="right"
-            aria-label={viewMarkdownButtonText}
-            onclick={handleViewMarkdown}
+            aria-label={viewLlmsButtonText}
+            onclick={handleViewLlms}
         >
-            {viewMarkdownButtonText}
+            {viewLlmsButtonText}
         </dx-button>
 
-        <div class="divider divider_copy-url"></div>
+        <div class="divider divider_menu"></div>
 
-        <dx-tooltip placement="top-right" label={copyUrlLabel}>
-            <dx-button
-                class="toolbar-button toolbar-button_copy-url"
-                variant="inline"
-                size="small"
-                icon-sprite="utility"
-                icon-symbol="link"
-                icon-size="medium"
-                icon-position="right"
-                aria-label={copyUrlButtonText}
-                onclick={handleCopyUrl}
+        <dx-dropdown
+            class="toolbar-menu"
+            options={menuOptions}
+            placement="bottom-end"
+            width-mode="fit-content"
+            onchange={handleMenuSelect}
+            onopen={handleMenuOpen}
+            onclose={handleMenuClose}
+        >
+            <dx-tooltip
+                placement="top-right"
+                label={menuTooltipLabel}
+                visible={menuTooltipVisible}
+                suppressed={menuOpen}
             >
-                {copyUrlButtonText}
-            </dx-button>
-        </dx-tooltip>
+                <dx-button
+                    class="menu-trigger"
+                    variant="secondary"
+                    size="small"
+                    icon-sprite="utility"
+                    icon-symbol="threedots"
+                    icon-size="medium"
+                    icon-only
+                >
+                    {moreActionsLabel}
+                </dx-button>
+            </dx-tooltip>
+        </dx-dropdown>
     </div>
 </template>