18747818748

Committed 23 Oct 2025 12:08PM UTC coverage: 39.79% (+0.09%) from 39.698%

Build # 18747818748

Build Type

push

github

Committed by

web-flow

Commit Message

feat: affiche des premiers éléments de syntaxe Markdown en clic droit (#1735)

Co-authored-by: Thomas Parisot <thom4parisot@users.noreply.github.com>

Run Details

614 of 860 branches covered (71.4%)

Branch coverage included in aggregate %.

104 of 166 new or added lines in 4 files covered. (62.65%)

1 existing line in 1 file now uncovered.

6159 of 16162 relevant lines covered (38.11%)

2.55 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

0.0

/front/src/components/collaborative/CollaborativeTextEditor.jsx

import React, { useCallback, useEffect, useMemo, useRef } from 'react'
import { Helmet } from 'react-helmet'
import { useTranslation } from 'react-i18next'
import { shallowEqual, useDispatch, useSelector } from 'react-redux'
import { MonacoBinding } from 'y-monaco'

import { MarkdownMenu, MetopesMenu, actions, registerActions, Separator } from './actions'
import { DiffEditor } from '@monaco-editor/react'
import throttle from 'lodash.throttle'
import 'monaco-editor/esm/vs/base/browser/ui/codicons/codicon/codicon.css'

import { useArticleVersion, useEditableArticle } from '../../hooks/article.js'
import { useBibliographyCompletion } from '../../hooks/bibliography.js'
import { useCollaboration } from '../../hooks/collaboration.js'
import { useStyloExportPreview } from '../../hooks/stylo-export.js'
import defaultEditorOptions from '../Write/providers/monaco/options.js'
import { onDropIntoEditor } from '../Write/providers/monaco/support.js'

import Alert from '../molecules/Alert.jsx'
import Loading from '../molecules/Loading.jsx'
import MonacoEditor from '../molecules/MonacoEditor.jsx'
import CollaborativeEditorArticleHeader from './CollaborativeEditorArticleHeader.jsx'
import CollaborativeEditorWebSocketStatus from './CollaborativeEditorWebSocketStatus.jsx'

import styles from './CollaborativeTextEditor.module.scss'

/**
 * @typedef {import('monaco-editor').editor.IStandaloneCodeEditor} IStandaloneCodeEditor
 * @typedef {import('monaco-editor')} monaco
 */

/**
 * @param {object} props
 * @param {string} props.articleId
 * @param {string|undefined} props.versionId
 * @param {'write' | 'compare' | 'preview'} props.mode
 * @returns {Element}
 */
export default function CollaborativeTextEditor({
  articleId,
  versionId,
  mode,
}) {
  const { yText, awareness, websocketStatus, dynamicStyles } = useCollaboration(
    { articleId, versionId }
  )
  const { t } = useTranslation('editor')

  const {
    version,
    error,
    isLoading: isVersionLoading,
  } = useArticleVersion({ versionId })
  const { provider: bibliographyCompletionProvider } =
    useBibliographyCompletion()
  const {
    article,
    bibliography,
    isLoading: isWorkingVersionLoading,
  } = useEditableArticle({
    articleId,
    versionId,
  })

  const { html: __html, isLoading: isPreviewLoading } = useStyloExportPreview({
    ...(mode === 'preview'
      ? {
          md_content: versionId ? version.md : yText?.toString(),
          yaml_content: versionId
            ? version.yaml
            : article?.workingVersion?.yaml,
          bib_content: versionId ? version.bib : article?.workingVersion?.bib,
        }
      : {}),
    with_toc: true,
    with_nocite: true,
    with_link_citations: true,
  })

  const dispatch = useDispatch()
  const editorRef = useRef(null)
  const editorCursorPosition = useSelector(
    (state) => state.editorCursorPosition,
    shallowEqual
  )

  const hasVersion = useMemo(() => !!versionId, [versionId])
  const isLoading =
    yText === null ||
    isPreviewLoading ||
    isWorkingVersionLoading ||
    isVersionLoading

  const options = useMemo(
    () => ({
      ...defaultEditorOptions,
      contextmenu: hasVersion ? false : websocketStatus === 'connected',
      readOnly: hasVersion ? true : websocketStatus !== 'connected',
      dropIntoEditor: {
        enabled: true,
      },
    }),
    [websocketStatus, hasVersion]
  )

  const updateArticleStructureAndStats = useCallback(
    throttle(
      ({ text: md }) => {
        dispatch({ type: 'UPDATE_ARTICLE_STATS', md })
        dispatch({ type: 'UPDATE_ARTICLE_STRUCTURE', md })
      },
      250,
      { leading: false, trailing: true }
    ),
    []
  )

  const handleCollaborativeEditorDidMount = useCallback(
    (
      /** @type {IStandaloneCodeEditor} */ editor,
      /** @type {monaco} */ monaco
    ) => {
      editorRef.current = editor

      editor.onDropIntoEditor(onDropIntoEditor(editor))

      const contextMenu = editor.getContribution('editor.contrib.contextmenu')
      const originalMenuActions = contextMenu._getMenuActions(
        editor.getModel(),
        editor.contextMenuId
      )

      contextMenu._getMenuActions = function _getStyloCustomMenuActions () {
        return [
            ...originalMenuActions,
            new Separator(),
            MetopesMenu({ editor, t }),
            MarkdownMenu({ editor, t }),
          ]
      }

      // Command Palette commands
      registerActions(editor, t, actions.metopes)
      registerActions(editor, t, actions.md, { palette: false })

      const completionProvider = bibliographyCompletionProvider.register(monaco)
      editor.onDidDispose(() => completionProvider.dispose())

      const model = editor.getModel()
      // Set EOL to LF otherwise it causes synchronization issues due to inconsistent EOL between Windows and Linux.
      // https://github.com/yjs/y-monaco/issues/27
      model.setEOL(monaco.editor.EndOfLineSequence.LF)
      if (yText && awareness) {
        new MonacoBinding(yText, model, new Set([editor]), awareness)
      }
    },
    [yText, awareness]
  )

  const handleEditorDidMount = useCallback((editor) => {
    editorRef.current = editor
  }, [])

  let timeoutId
  useEffect(() => {
    if (yText) {
      updateArticleStructureAndStats({ text: yText.toString() })
      yText.observe(function (yTextEvent, transaction) {
        dispatch({
          type: 'UPDATE_ARTICLE_WORKING_COPY_STATUS',
          status: 'syncing',
        })
        if (timeoutId) {
          clearTimeout(timeoutId)
        }
        timeoutId = setTimeout(() => {
          dispatch({
            type: 'UPDATE_ARTICLE_WORKING_COPY_STATUS',
            status: 'synced',
          })
        }, 4000)

        updateArticleStructureAndStats({ text: yText.toString() })
      })
    }
  }, [articleId, versionId, yText])

  useEffect(() => {
    if (versionId) {
      dispatch({ type: 'UPDATE_ARTICLE_STATS', md: version.md })
      dispatch({ type: 'UPDATE_ARTICLE_STRUCTURE', md: version.md })
    }
  }, [versionId])

  useEffect(() => {
    if (bibliography) {
      bibliographyCompletionProvider.bibTeXEntries = bibliography.entries
    }
  }, [bibliography])

  useEffect(() => {
    const line = editorCursorPosition.lineNumber
    const editor = editorRef.current
    editor?.focus()
    const endOfLineColumn = editor?.getModel()?.getLineMaxColumn(line + 1)
    editor?.setPosition({ lineNumber: line + 1, column: endOfLineColumn })
    editor?.revealLineNearTop(line + 1, 1) // smooth
  }, [editorRef, editorCursorPosition])

  if (isLoading) {
    return <Loading />
  }

  if (error) {
    return <Alert message={error.message} />
  }

  return (
    <>
      <style>{dynamicStyles}</style>
      <Helmet>
        <title>{article.title}</title>
      </Helmet>

      <CollaborativeEditorArticleHeader
        articleTitle={article.title}
        versionId={versionId}
      />

      <CollaborativeEditorWebSocketStatus
        className={styles.inlineStatus}
        status={websocketStatus}
      />

      {mode === 'preview' && (
        <section
          className={styles.previewPage}
          dangerouslySetInnerHTML={{ __html }}
        />
      )}

      {mode === 'compare' && (
        <div className={styles.collaborativeEditor}>
          <DiffEditor
            className={styles.editor}
            width={'100%'}
            height={'auto'}
            modified={article.workingVersion?.md}
            original={version.md}
            language="markdown"
            options={defaultEditorOptions}
          />
        </div>
      )}

      <div className={styles.collaborativeEditor} hidden={mode !== 'write'}>
        <MonacoEditor
          width={'100%'}
          height={'auto'}
          options={options}
          className={styles.editor}
          defaultLanguage="markdown"
          {...(hasVersion
            ? { value: version.md, onMount: handleEditorDidMount }
            : { onMount: handleCollaborativeEditorDidMount })}
        />
      </div>
    </>
  )
}

1	import React, { useCallback, useEffect, useMemo, useRef } from 'react'	×
2	import { Helmet } from 'react-helmet'	×
3	import { useTranslation } from 'react-i18next'	×
4	import { shallowEqual, useDispatch, useSelector } from 'react-redux'	×
5	import { MonacoBinding } from 'y-monaco'	×
6
NEW 7	import { MarkdownMenu, MetopesMenu, actions, registerActions, Separator } from './actions'	×
8	import { DiffEditor } from '@monaco-editor/react'	×
9	import throttle from 'lodash.throttle'	×
10	import 'monaco-editor/esm/vs/base/browser/ui/codicons/codicon/codicon.css'	×
11
12	import { useArticleVersion, useEditableArticle } from '../../hooks/article.js'	×
13	import { useBibliographyCompletion } from '../../hooks/bibliography.js'	×
14	import { useCollaboration } from '../../hooks/collaboration.js'	×
15	import { useStyloExportPreview } from '../../hooks/stylo-export.js'	×
16	import defaultEditorOptions from '../Write/providers/monaco/options.js'	×
17	import { onDropIntoEditor } from '../Write/providers/monaco/support.js'	×
18
19	import Alert from '../molecules/Alert.jsx'	×
20	import Loading from '../molecules/Loading.jsx'	×
21	import MonacoEditor from '../molecules/MonacoEditor.jsx'	×
22	import CollaborativeEditorArticleHeader from './CollaborativeEditorArticleHeader.jsx'	×
23	import CollaborativeEditorWebSocketStatus from './CollaborativeEditorWebSocketStatus.jsx'	×
24
25	import styles from './CollaborativeTextEditor.module.scss'	×
26
27	/**
28	* @typedef {import('monaco-editor').editor.IStandaloneCodeEditor} IStandaloneCodeEditor
29	* @typedef {import('monaco-editor')} monaco
30	*/
31
32	/**
33	* @param {object} props
34	* @param {string} props.articleId
35	* @param {string\|undefined} props.versionId
36	* @param {'write' \| 'compare' \| 'preview'} props.mode
37	* @returns {Element}
38	*/
39	export default function CollaborativeTextEditor({	×
40	articleId,	×
41	versionId,	×
42	mode,	×
43	}) {	×
44	const { yText, awareness, websocketStatus, dynamicStyles } = useCollaboration(	×
45	{ articleId, versionId }	×
46	)	×
47	const { t } = useTranslation('editor')	×
48
49	const {	×
50	version,	×
51	error,	×
52	isLoading: isVersionLoading,	×
53	} = useArticleVersion({ versionId })	×
54	const { provider: bibliographyCompletionProvider } =	×
55	useBibliographyCompletion()	×
56	const {	×
57	article,	×
58	bibliography,	×
59	isLoading: isWorkingVersionLoading,	×
60	} = useEditableArticle({	×
61	articleId,	×
62	versionId,	×
63	})	×
64
65	const { html: __html, isLoading: isPreviewLoading } = useStyloExportPreview({	×
66	...(mode === 'preview'	×
67	? {	×
68	md_content: versionId ? version.md : yText?.toString(),	×
69	yaml_content: versionId	×
70	? version.yaml	×
71	: article?.workingVersion?.yaml,	×
72	bib_content: versionId ? version.bib : article?.workingVersion?.bib,	×
73	}	×
74	: {}),	×
75	with_toc: true,	×
76	with_nocite: true,	×
77	with_link_citations: true,	×
78	})	×
79
80	const dispatch = useDispatch()	×
81	const editorRef = useRef(null)	×
82	const editorCursorPosition = useSelector(	×
83	(state) => state.editorCursorPosition,	×
84	shallowEqual	×
85	)	×
86
87	const hasVersion = useMemo(() => !!versionId, [versionId])	×
88	const isLoading =	×
89	yText === null \|\|	×
90	isPreviewLoading \|\|	×
91	isWorkingVersionLoading \|\|	×
92	isVersionLoading	×
93
94	const options = useMemo(	×
95	() => ({	×
96	...defaultEditorOptions,	×
97	contextmenu: hasVersion ? false : websocketStatus === 'connected',	×
98	readOnly: hasVersion ? true : websocketStatus !== 'connected',	×
99	dropIntoEditor: {	×
100	enabled: true,	×
101	},	×
102	}),	×
103	[websocketStatus, hasVersion]	×
104	)	×
105
106	const updateArticleStructureAndStats = useCallback(	×
107	throttle(	×
108	({ text: md }) => {	×
109	dispatch({ type: 'UPDATE_ARTICLE_STATS', md })	×
110	dispatch({ type: 'UPDATE_ARTICLE_STRUCTURE', md })	×
111	},	×
112	250,	×
113	{ leading: false, trailing: true }	×
114	),	×
115	[]	×
116	)	×
117
118	const handleCollaborativeEditorDidMount = useCallback(	×
119	(	×
120	/** @type {IStandaloneCodeEditor} */ editor,	×
121	/** @type {monaco} */ monaco	×
122	) => {	×
123	editorRef.current = editor	×
124
125	editor.onDropIntoEditor(onDropIntoEditor(editor))	×
126
127	const contextMenu = editor.getContribution('editor.contrib.contextmenu')	×
128	const originalMenuActions = contextMenu._getMenuActions(	×
129	editor.getModel(),	×
130	editor.contextMenuId	×
131	)	×
132
133	contextMenu._getMenuActions = function _getStyloCustomMenuActions () {	×
134	return [	×
135	...originalMenuActions,	×
136	new Separator(),	×
137	MetopesMenu({ editor, t }),	×
NEW 138	MarkdownMenu({ editor, t }),	×
139	]	×
140	}	×
141
142	// Command Palette commands
NEW 143	registerActions(editor, t, actions.metopes)	×
NEW 144	registerActions(editor, t, actions.md, { palette: false })	×
145
146	const completionProvider = bibliographyCompletionProvider.register(monaco)	×
147	editor.onDidDispose(() => completionProvider.dispose())	×
148
149	const model = editor.getModel()	×
150	// Set EOL to LF otherwise it causes synchronization issues due to inconsistent EOL between Windows and Linux.
151	// https://github.com/yjs/y-monaco/issues/27
152	model.setEOL(monaco.editor.EndOfLineSequence.LF)	×
153	if (yText && awareness) {	×
154	new MonacoBinding(yText, model, new Set([editor]), awareness)	×
155	}	×
156	},	×
157	[yText, awareness]	×
158	)	×
159
160	const handleEditorDidMount = useCallback((editor) => {	×
161	editorRef.current = editor	×
162	}, [])	×
163
164	let timeoutId	×
165	useEffect(() => {	×
166	if (yText) {	×
167	updateArticleStructureAndStats({ text: yText.toString() })	×
168	yText.observe(function (yTextEvent, transaction) {	×
169	dispatch({	×
170	type: 'UPDATE_ARTICLE_WORKING_COPY_STATUS',	×
171	status: 'syncing',	×
172	})	×
173	if (timeoutId) {	×
174	clearTimeout(timeoutId)	×
175	}	×
176	timeoutId = setTimeout(() => {	×
177	dispatch({	×
178	type: 'UPDATE_ARTICLE_WORKING_COPY_STATUS',	×
179	status: 'synced',	×
180	})	×
181	}, 4000)	×
182
183	updateArticleStructureAndStats({ text: yText.toString() })	×
184	})	×
185	}	×
186	}, [articleId, versionId, yText])	×
187
188	useEffect(() => {	×
189	if (versionId) {	×
190	dispatch({ type: 'UPDATE_ARTICLE_STATS', md: version.md })	×
191	dispatch({ type: 'UPDATE_ARTICLE_STRUCTURE', md: version.md })	×
192	}	×
193	}, [versionId])	×
194
195	useEffect(() => {	×
196	if (bibliography) {	×
197	bibliographyCompletionProvider.bibTeXEntries = bibliography.entries	×
198	}	×
199	}, [bibliography])	×
200
201	useEffect(() => {	×
202	const line = editorCursorPosition.lineNumber	×
203	const editor = editorRef.current	×
204	editor?.focus()	×
205	const endOfLineColumn = editor?.getModel()?.getLineMaxColumn(line + 1)	×
206	editor?.setPosition({ lineNumber: line + 1, column: endOfLineColumn })	×
207	editor?.revealLineNearTop(line + 1, 1) // smooth	×
208	}, [editorRef, editorCursorPosition])	×
209
210	if (isLoading) {	×
211	return <Loading />	×
212	}	×
213
214	if (error) {	×
215	return <Alert message={error.message} />	×
216	}	×
217
218	return (	×
219	<>	×
220	<style>{dynamicStyles}</style>	×
221	<Helmet>	×
222	<title>{article.title}</title>	×
223	</Helmet>	×
224
225	<CollaborativeEditorArticleHeader	×
226	articleTitle={article.title}	×
227	versionId={versionId}	×
228	/>	×
229
230	<CollaborativeEditorWebSocketStatus	×
231	className={styles.inlineStatus}	×
232	status={websocketStatus}	×
233	/>	×
234
235	{mode === 'preview' && (	×
236	<section	×
237	className={styles.previewPage}	×
238	dangerouslySetInnerHTML={{ __html }}	×
239	/>	×
240	)}
241
242	{mode === 'compare' && (	×
243	<div className={styles.collaborativeEditor}>	×
244	<DiffEditor	×
245	className={styles.editor}	×
246	width={'100%'}	×
247	height={'auto'}	×
248	modified={article.workingVersion?.md}	×
249	original={version.md}	×
250	language="markdown"	×
251	options={defaultEditorOptions}	×
252	/>	×
253	</div>	×
254	)}
255
256	<div className={styles.collaborativeEditor} hidden={mode !== 'write'}>	×
257	<MonacoEditor	×
258	width={'100%'}	×
259	height={'auto'}	×
260	options={options}	×
261	className={styles.editor}	×
262	defaultLanguage="markdown"	×
263	{...(hasVersion	×
264	? { value: version.md, onMount: handleEditorDidMount }	×
265	: { onMount: handleCollaborativeEditorDidMount })}	×
266	/>	×
267	</div>	×
268	</>	×
269	)
270	}	×

EcrituresNumeriques / stylo / 18747818748

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous