From ed284fbc5f9c4cafe5b4046446ed69f144d55c7e Mon Sep 17 00:00:00 2001
From: Elian Doran <contact@eliandoran.me>
Date: Mon, 15 Dec 2025 08:32:01 +0200
Subject: [PATCH] feat(layout/note_actions): integrate open API docs

---
 .../src/widgets/FloatingButtonsDefinitions.tsx   |  2 +-
 .../src/widgets/ribbon/NoteActionsCustom.tsx     | 16 +++++++++++++++-
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/apps/client/src/widgets/FloatingButtonsDefinitions.tsx b/apps/client/src/widgets/FloatingButtonsDefinitions.tsx
index ecd7c9b92..bd7372d66 100644
--- a/apps/client/src/widgets/FloatingButtonsDefinitions.tsx
+++ b/apps/client/src/widgets/FloatingButtonsDefinitions.tsx
@@ -182,7 +182,7 @@ function RunActiveNoteButton({ note }: FloatingButtonContext) {
 }
 
 function OpenTriliumApiDocsButton({ note }: FloatingButtonContext) {
-    const isEnabled = note.mime.startsWith("application/javascript;env=");
+    const isEnabled = !isNewLayout && note.mime.startsWith("application/javascript;env=");
     return isEnabled && <FloatingButton
         icon="bx bx-help-circle"
         text={t("code_buttons.trilium_api_docs_button_title")}
diff --git a/apps/client/src/widgets/ribbon/NoteActionsCustom.tsx b/apps/client/src/widgets/ribbon/NoteActionsCustom.tsx
index c041ad787..c31014faa 100644
--- a/apps/client/src/widgets/ribbon/NoteActionsCustom.tsx
+++ b/apps/client/src/widgets/ribbon/NoteActionsCustom.tsx
@@ -6,6 +6,7 @@ import NoteContext from "../../components/note_context";
 import FNote from "../../entities/fnote";
 import { t } from "../../services/i18n";
 import { downloadFileNote, openNoteExternally } from "../../services/open";
+import { openInAppHelpFromUrl } from "../../services/utils";
 import { ViewTypeOptions } from "../collections/interface";
 import { buildSaveSqlToNoteHandler } from "../FloatingButtonsDefinitions";
 import ActionButton from "../react/ActionButton";
@@ -22,6 +23,7 @@ interface NoteActionsCustomProps {
 }
 
 interface NoteActionsCustomInnerProps extends NoteActionsCustomProps {
+    noteMime: string;
     noteType: NoteType;
     isReadOnly: boolean;
     isDefaultViewMode: boolean;
@@ -36,12 +38,14 @@ interface NoteActionsCustomInnerProps extends NoteActionsCustomProps {
 export default function NoteActionsCustom(props: NoteActionsCustomProps) {
     const { note } = props;
     const noteType = useNoteProperty(note, "type");
+    const noteMime = useNoteProperty(note, "mime");
     const [ viewType ] = useNoteLabel(note, "viewType");
     const parentComponent = useContext(ParentComponent);
     const [ isReadOnly ] = useNoteLabelBoolean(note, "readOnly");
-    const innerProps: NoteActionsCustomInnerProps | null | undefined = noteType && parentComponent && {
+    const innerProps: NoteActionsCustomInnerProps | false = !!noteType && !!noteMime && !!parentComponent && {
         ...props,
         noteType,
+        noteMime,
         viewType: viewType as ViewTypeOptions | null | undefined,
         isDefaultViewMode: props.noteContext.viewScope?.viewMode === "default",
         parentComponent,
@@ -51,6 +55,7 @@ export default function NoteActionsCustom(props: NoteActionsCustomProps) {
     return (innerProps &&
         <div className="note-actions-custom">
             <RunActiveNoteButton {...innerProps } />
+            <OpenTriliumApiDocsButton {...innerProps} />
             <SwitchSplitOrientationButton {...innerProps} />
             <ToggleReadOnlyButton {...innerProps} />
             <SaveToNoteButton {...innerProps} />
@@ -195,3 +200,12 @@ function SaveToNoteButton({ note }: NoteActionsCustomInnerProps) {
         onClick={buildSaveSqlToNoteHandler(note)}
     />;
 }
+
+function OpenTriliumApiDocsButton({ note }: NoteActionsCustomInnerProps) {
+    const isEnabled = note.mime.startsWith("application/javascript;env=");
+    return isEnabled && <ActionButton
+        icon="bx bx-help-circle"
+        text={t("code_buttons.trilium_api_docs_button_title")}
+        onClick={() => openInAppHelpFromUrl(note.mime.endsWith("frontend") ? "Q2z6av6JZVWm" : "MEtfsqa5VwNi")}
+    />;
+}