@manuscripts/body-editor 3.12.66 → 3.13.0

package/src/components/outline/DraggableTree.tsx

@@ -0,0 +1,438 @@
+/*!
+ * © 2019 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import {
+  TriangleCollapsedIcon,
+  TriangleExpandedIcon,
+} from '@manuscripts/style-guide'
+import {
+  isAttachmentsNode,
+  isBibliographySectionNode,
+  isSupplementsNode,
+  isElementNodeType,
+  isHeroImageNode,
+  ManuscriptEditorView,
+  ManuscriptNode,
+  ManuscriptNodeType,
+  nodeTitle,
+  nodeTitlePlaceholder,
+  schema,
+} from '@manuscripts/transform'
+import { Fragment } from 'prosemirror-model'
+import React, { MouseEvent, useRef, useState } from 'react'
+import { useDrag, useDrop } from 'react-dnd'
+
+import { Capabilities } from '../../lib/capabilities'
+import { ContextMenu } from '../../lib/context-menu'
+import { DropSide, getDropSide } from '../../lib/dnd'
+import { isBodyLocked } from '../../lib/utils'
+import { nodeTypeIcon } from '../../node-type-icons'
+import { PluginState, sectionTitleKey } from '../../plugins/section_title'
+import { FileAttachment } from '../../lib/files'
+import {
+  Outline,
+  OutlineItem,
+  OutlineItemArrow,
+  OutlineItemIcon,
+  OutlineItemLink,
+  OutlineItemLinkText,
+  OutlineItemNoArrow,
+  OutlineItemPlaceholder,
+} from './Outline'
+import { isDeleted } from '@manuscripts/track-changes-plugin'
+
+const excludedTypes = [
+  schema.nodes.table,
+  schema.nodes.figure,
+  schema.nodes.footnotes_element,
+  schema.nodes.bibliography_element,
+  schema.nodes.keywords,
+  schema.nodes.affiliations,
+  schema.nodes.contributors,
+  schema.nodes.author_notes,
+  schema.nodes.title,
+  schema.nodes.alt_titles,
+  schema.nodes.alt_title,
+  schema.nodes.alt_text,
+  schema.nodes.long_desc,
+  schema.nodes.trans_abstract,
+  schema.nodes.trans_graphical_abstract,
+  schema.nodes.subtitles,
+  schema.nodes.subtitle,
+  schema.nodes.supplement,
+]
+
+const childrenExcludedTypes = [
+  schema.nodes.pullquote_element,
+  schema.nodes.blockquote_element,
+]
+
+export interface TreeItem {
+  index: number
+  items: TreeItem[]
+  node: ManuscriptNode
+  pos: number
+  endPos: number
+  parent?: ManuscriptNode
+}
+
+const isExcluded = (nodeType: ManuscriptNodeType) => {
+  return excludedTypes.includes(nodeType)
+}
+
+const isChildrenExcluded = (nodeType: ManuscriptNodeType) => {
+  return childrenExcludedTypes.includes(nodeType)
+}
+
+interface TreeBuilderOptions {
+  node: ManuscriptNode
+  pos: number
+  index: number
+  parent?: ManuscriptNode
+}
+
+type TreeBuilder = (options: TreeBuilderOptions) => TreeItem
+
+const isAbstractOrBackmatter = (item: TreeItem) => {
+  return (
+    item.parent &&
+    (item.parent.type === schema.nodes.abstracts ||
+      item.parent.type === schema.nodes.backmatter)
+  )
+}
+
+const isManuscriptNode = (node: ManuscriptNode | undefined) => {
+  return node?.type === schema.nodes.manuscript
+}
+
+type EditorPropsWithFiles = ManuscriptEditorView['props'] & {
+  getFiles?: () => FileAttachment[]
+}
+
+const isPdfFile = (file?: FileAttachment) => {
+  if (!file?.name) {
+    return false
+  }
+  const name = file.name.toLowerCase()
+  return name.endsWith('.pdf')
+}
+
+const getEditorFiles = (view?: ManuscriptEditorView) => {
+  const props = view?.props as EditorPropsWithFiles | undefined
+  return props?.getFiles?.()
+}
+
+export const buildTree: TreeBuilder = ({
+  node,
+  pos,
+  index,
+  parent,
+}): TreeItem => {
+  const items: TreeItem[] = []
+  const startPos = pos + 1 // TODO: don't increment this?
+  const endPos = pos + node.nodeSize
+
+  if (!isChildrenExcluded(node.type)) {
+    node.forEach((childNode, offset, childIndex) => {
+      if (isExcluded(childNode.type)) {
+        return
+      }
+      if (
+        isManuscriptNode(node) ||
+        ((!childNode.isAtom || isElementNodeType(childNode.type)) &&
+          childNode.attrs.id &&
+          !isDeleted(childNode))
+      ) {
+        items.push(
+          buildTree({
+            node: childNode,
+            pos: startPos + offset,
+            index: childIndex,
+            parent: node,
+          })
+        )
+      }
+    })
+  }
+
+  return { node, index, items, pos, endPos, parent }
+}
+
+export interface DraggableTreeProps {
+  depth: number
+  tree: TreeItem
+  view?: ManuscriptEditorView
+  can?: Capabilities
+  getFiles?: () => FileAttachment[]
+}
+
+export const DraggableTree: React.FC<DraggableTreeProps> = ({
+  tree,
+  view,
+  depth,
+  can,
+  getFiles,
+}) => {
+  const [dropSide, setDropSide] = useState<DropSide>()
+  const [isOpen, setOpen] = useState(depth === 0)
+  const ref = useRef<HTMLDivElement>(null)
+  // Disable drag-and-drop functionality when the body is locked
+  const disableDragAndDrop = view
+    ? isBodyLocked(view.state) || !can?.editArticle
+    : true
+
+  const { node, items, parent } = tree
+  const sectionTitleState: PluginState | undefined = view
+    ? sectionTitleKey.getState(view.state)
+    : undefined
+
+  const itemText = (node: ManuscriptNode) => {
+    const text = nodeTitle(node)
+    let sectionNumber =
+      node.type.name === 'section' && sectionTitleState
+        ? (sectionTitleState.get(node.attrs.id) ?? '')
+        : ''
+    sectionNumber = sectionNumber ? `${sectionNumber}.` : ''
+
+    if (text) {
+      return `${sectionNumber}${sectionNumber ? ' ' : ''}${text.trim()}`
+    }
+
+    const placeholder = nodeTitlePlaceholder(node.type)
+
+    return (
+      <OutlineItemPlaceholder>
+        {sectionNumber && `${sectionNumber} `}
+        {placeholder}
+      </OutlineItemPlaceholder>
+    )
+  }
+
+  const toggleOpen = () => {
+    setOpen(!isOpen)
+  }
+
+  const [{ isDragging }, dragRef] = useDrag({
+    type: 'outline',
+    item: tree,
+    canDrag: () => {
+      // Prevent dragging if the node is deleted, the body is locked, or editing is not allowed
+      return depth !== 0 && !disableDragAndDrop && !isDeleted(node)
+    },
+    collect: (monitor) => ({
+      isDragging: monitor.isDragging(),
+    }),
+  })
+
+  const [{ isOver }, dropRef] = useDrop({
+    accept: 'outline',
+    canDrop(item: TreeItem, monitor) {
+      if (disableDragAndDrop) {
+        return false
+      }
+      if (isAbstractOrBackmatter(item) || isAbstractOrBackmatter(tree)) {
+        return false
+      }
+      if (!ref.current) {
+        return false
+      }
+      if (!tree.parent) {
+        return false
+      }
+      // can't drop on itself
+      if (item.node.attrs.id === tree.node.attrs.id) {
+        return false
+      }
+      // can't drop within itself
+      if (item.pos <= tree.pos && item.endPos >= tree.endPos) {
+        return false
+      }
+      // can't drop immediately before/after itself
+      if (tree.pos === item.endPos || item.pos === tree.endPos) {
+        return false
+      }
+
+      const side = getDropSide(ref.current, monitor)
+      const index = side === 'before' ? tree.index : tree.index + 1
+
+      return tree.parent.canReplace(index, index, Fragment.from(item.node))
+    },
+    hover(item, monitor) {
+      if (disableDragAndDrop || !ref.current || !monitor.canDrop()) {
+        return
+      }
+      const side = getDropSide(ref.current, monitor)
+      setDropSide(side)
+    },
+    drop(item: TreeItem, monitor) {
+      if (disableDragAndDrop || !ref.current || !view) {
+        return
+      }
+      const side = getDropSide(ref.current, monitor)
+      const pos = side === 'before' ? tree.pos - 1 : tree.endPos - 1
+      let sourcePos = item.pos - 1
+
+      const node = item.node.type.schema.nodes[item.node.type.name].create(
+        {
+          ...item.node.attrs,
+        },
+        item.node.content
+      )
+
+      const tr = view.state.tr.insert(pos, node)
+      sourcePos = tr.mapping.map(sourcePos)
+      tr.delete(sourcePos, sourcePos + item.node.nodeSize)
+      view.dispatch(tr)
+    },
+    collect: (monitor) => ({
+      isOver: monitor.isOver({ shallow: true }),
+    }),
+  })
+
+  const isDeletedItem = isDeleted(node)
+  const isHeroImage = isHeroImageNode(node)
+  const isSupplements = isSupplementsNode(node)
+  const isMainDocument = isAttachmentsNode(node)
+  const editorFiles = isMainDocument
+    ? (getFiles?.() ?? getEditorFiles(view))
+    : undefined
+
+  const isTop =
+    isManuscriptNode(parent) &&
+    !isHeroImage &&
+    !isSupplements &&
+    !isMainDocument
+
+  // Hide attachments node from outline when it's empty
+  if (isMainDocument && node.childCount === 0) {
+    return null
+  }
+
+  if (isMainDocument) {
+    const attachmentIds = new Set<string>()
+    node.forEach((childNode) => {
+      const href = childNode.attrs?.href
+      if (href) {
+        attachmentIds.add(href.replace(/^attachment:/, ''))
+      }
+    })
+
+    const mainDocumentFile =
+      editorFiles?.find((file) => {
+        const fileId = file.id?.replace(/^attachment:/, '')
+        return !!fileId && attachmentIds.has(fileId)
+      }) ?? editorFiles?.find((file) => isPdfFile(file))
+    const isMainDocumentPDF = isPdfFile(mainDocumentFile)
+
+    // Hide main document in outline if it is not a PDF
+    if (!isMainDocumentPDF) {
+      return null
+    }
+  }
+
+  const handleContextMenu = (e: MouseEvent) => {
+    e.preventDefault()
+    e.stopPropagation()
+
+    if (!can?.editArticle) {
+      return false
+    }
+    if (!view) {
+      return null
+    }
+
+    const menu = new ContextMenu(tree.node, view, () => tree.pos - 1)
+    menu.showEditMenu(e.currentTarget as HTMLAnchorElement)
+  }
+
+  const handleKeyDown = (e: React.KeyboardEvent<HTMLDivElement>) => {
+    if (e.key === 'Enter') {
+      e.preventDefault()
+      e.stopPropagation()
+
+      if (items.length > 0) {
+        // Has children: expand/collapse
+        toggleOpen()
+      } else {
+        // No children: navigate to the link
+        const link = (e.currentTarget as HTMLElement).querySelector('a')
+        if (link) {
+          link.click()
+        }
+      }
+    }
+  }
+
+  dragRef(dropRef(ref))
+
+  const classNames = [
+    isDragging && 'dragging',
+    isOver && dropSide && `drop-${dropSide}`,
+    isDeletedItem && 'deleted',
+    isHeroImage && 'hero-image',
+    isSupplements && 'supplements',
+    isBibliographySectionNode(node) && 'references',
+    isMainDocument && 'main-document',
+  ]
+    .filter(Boolean)
+    .join(' ') // .filter(Boolean) removes all falsy values (false, '', null, etc.)
+  return (
+    <Outline ref={ref} className={classNames}>
+      {!isTop && node.type.name != 'manuscript' && (
+        <OutlineItem
+          depth={isHeroImage || isSupplements || isMainDocument ? 1 : depth}
+          onContextMenu={handleContextMenu}
+          onKeyDown={handleKeyDown}
+          tabIndex={-1}
+          data-outline-item
+        >
+          {items.length ? (
+            <OutlineItemArrow
+              aria-label={`${isOpen ? 'Collapse' : 'Expand'} ${node.type.name}`}
+              onClick={toggleOpen}
+              tabIndex={-1}
+            >
+              {isOpen ? <TriangleExpandedIcon /> : <TriangleCollapsedIcon />}
+            </OutlineItemArrow>
+          ) : (
+            <OutlineItemNoArrow />
+          )}
+
+          <OutlineItemLink to={`#${node.attrs.id}`} tabIndex={-1}>
+            <OutlineItemIcon>{nodeTypeIcon(node.type)}</OutlineItemIcon>
+            <OutlineItemLinkText className={`outline-text-${node.type.name}`}>
+              {itemText(node)}
+            </OutlineItemLinkText>
+          </OutlineItemLink>
+        </OutlineItem>
+      )}
+
+      {items.length ? (
+        <div className={`subtree ${isOpen ? '' : 'collapsed'}`}>
+          {items.map((subtree, index) => (
+            <DraggableTree
+              key={subtree.node.attrs.id || 'subtree-' + index}
+              tree={subtree}
+              view={view}
+              depth={!tree.parent ? depth : depth + 1}
+              can={can}
+              getFiles={getFiles}
+            />
+          ))}
+        </div>
+      ) : null}
+    </Outline>
+  )
+}

package/src/components/outline/ManuscriptOutline.tsx

@@ -0,0 +1,127 @@
+/*!
+ * © 2019 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ManuscriptEditorView, ManuscriptNode } from '@manuscripts/transform'
+import React, { useCallback, useEffect, useRef, useState } from 'react'
+
+import { Capabilities } from '../../lib/capabilities'
+import { FileAttachment } from '../../lib/files'
+import { useDebounce } from '../hooks/use-debounce'
+import { buildTree, DraggableTree, TreeItem } from './DraggableTree'
+
+export interface ManuscriptOutlineProps {
+  doc: ManuscriptNode | null
+  can?: Capabilities
+  view?: ManuscriptEditorView
+  getFiles?: () => FileAttachment[]
+}
+
+export const ManuscriptOutline: React.FC<ManuscriptOutlineProps> = (props) => {
+  const [values, setValues] = useState<{
+    tree: TreeItem
+    view?: ManuscriptEditorView
+    can?: Capabilities
+    getFiles?: () => FileAttachment[]
+  }>()
+  const containerRef = useRef<HTMLDivElement>(null)
+
+  const debouncedProps = useDebounce(props, 500)
+
+  useEffect(() => {
+    const { doc, view } = debouncedProps
+
+    if (doc) {
+      const tree = buildTree({
+        node: doc,
+        pos: 0,
+        index: 0,
+      })
+
+      setValues({ tree, view, can: props.can, getFiles: props.getFiles })
+    } else {
+      setValues(undefined)
+    }
+  }, [debouncedProps, props.can, props.getFiles])
+
+  // Get all visible outline items (excluding those in collapsed subtrees)
+  const getOutlineItems = useCallback(() => {
+    if (!containerRef.current) return []
+    const allItems = Array.from(
+      containerRef.current.querySelectorAll<HTMLElement>('[data-outline-item]')
+    )
+
+    // Filter out items that are inside a collapsed subtree
+    return allItems.filter((item) => {
+      let parent = item.parentElement
+      while (parent && parent !== containerRef.current) {
+        if (
+          parent.classList.contains('subtree') &&
+          parent.classList.contains('collapsed')
+        ) {
+          return false
+        }
+        parent = parent.parentElement
+      }
+      return true
+    })
+  }, [])
+
+  // Set roving tabindex: only first item is tabbable
+  useEffect(() => {
+    const items = getOutlineItems()
+    items.forEach((item, index) => {
+      item.tabIndex = index === 0 ? 0 : -1
+    })
+  }, [getOutlineItems, values])
+
+  const handleKeyDown = useCallback(
+    (event: React.KeyboardEvent<HTMLDivElement>) => {
+      if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') {
+        return
+      }
+
+      const target = event.target as HTMLElement
+      // Only handle if an outline item is focused
+      if (!target.hasAttribute('data-outline-item')) {
+        return
+      }
+
+      const items = getOutlineItems()
+      const currentIndex = items.indexOf(target)
+
+      if (currentIndex === -1) return
+
+      event.preventDefault()
+
+      let nextIndex: number
+      if (event.key === 'ArrowDown') {
+        nextIndex = (currentIndex + 1) % items.length
+      } else {
+        nextIndex = (currentIndex - 1 + items.length) % items.length
+      }
+
+      const nextItem = items[nextIndex]
+      nextItem?.focus()
+    },
+    [getOutlineItems]
+  )
+
+  return values && values.view ? (
+    <div ref={containerRef} onKeyDown={handleKeyDown}>
+      <DraggableTree {...values} depth={0} />
+    </div>
+  ) : null
+}

package/src/components/outline/Outline.tsx

@@ -0,0 +1,141 @@
+/*!
+ * © 2019 Atypon Systems LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Link } from 'react-router-dom'
+import styled from 'styled-components'
+
+export const OutlineItemIcon = styled.span`
+  display: inline-flex;
+  width: 1.2em;
+  height: 1.3em;
+  justify-content: center;
+  align-items: center;
+  padding: 2px;
+  flex-shrink: 0;
+`
+
+export const OutlineItem = styled.div<{
+  depth: number
+}>`
+  align-items: center;
+  color: ${(props) => props.theme.colors.text.primary};
+  box-sizing: border-box;
+  cursor: pointer;
+  display: flex;
+  font-size: ${(props) =>
+    props.depth === 0
+      ? props.theme.font.size.large
+      : props.theme.font.size.medium};
+  line-height: 30px;
+  margin-left: -${(props) => props.theme.grid.unit * 10}px;
+  margin-right: -${(props) => props.theme.grid.unit * 5}px;
+  overflow-x: hidden;
+  padding-right: ${(props) => props.theme.grid.unit * 5}px;
+  padding-left: ${(props) => 20 + props.depth * 20}px;
+  white-space: nowrap;
+
+  &:hover {
+    background: ${(props) => props.theme.colors.background.fifth};
+  }
+
+  &:focus-visible {
+    background: ${(props) => props.theme.colors.background.fifth};
+    outline: 2px solid #bce7f6;
+    outline-offset: -2px;
+  }
+`
+
+export const OutlineItemArrow = styled.button`
+  display: inline-block;
+  cursor: pointer;
+  border: none;
+  background: transparent;
+  padding: 0 ${(props) => props.theme.grid.unit}px;
+  flex-shrink: 0;
+  font-size: ${(props) => props.theme.font.size.normal};
+
+  &:hover use {
+    fill: #ccc;
+  }
+
+  &:focus {
+    outline: none;
+  }
+`
+
+export const OutlineItemNoArrow = styled.span`
+  display: inline-block;
+  width: 25px;
+  flex-shrink: 0;
+`
+
+export const OutlineItemLink = styled(Link)`
+  flex: 1;
+  display: inline-flex;
+  align-items: center;
+  overflow-x: hidden;
+  color: inherit;
+  text-decoration: none;
+  height: 100%;
+  border-bottom: 1px solid transparent;
+  border-top: 1px solid transparent;
+
+  &:focus,
+  &:active {
+    outline: none;
+  }
+`
+
+export const OutlineItemLinkText = styled.span`
+  flex: 1;
+  display: inline-block;
+  overflow-x: hidden;
+  text-overflow: ellipsis;
+  margin-left: ${(props) => props.theme.grid.unit * 2}px;
+`
+
+export const Outline = styled.div`
+  font-size: ${(props) => props.theme.font.size.medium};
+  position: relative;
+
+  & .outline-text-title {
+    font-size: ${(props) => props.theme.font.size.large};
+  }
+
+  &.dragging {
+    opacity: 0.5;
+  }
+
+  &.drop-before > ${OutlineItem} > ${OutlineItemLink} {
+    border-top-color: ${(props) => props.theme.colors.brand.dark};
+  }
+
+  &.drop-after > ${OutlineItem} > ${OutlineItemLink} {
+    border-bottom-color: ${(props) => props.theme.colors.brand.dark};
+  }
+
+  & .subtree.collapsed {
+    display: none;
+  }
+
+  & div:has(.supplements, .hero-image, .main-document) .references {
+    margin-bottom: 5px;
+    padding-bottom: 5px;
+    border-bottom: 1px dashed #ddd;
+  }
+`
+
+export const OutlineItemPlaceholder = styled.span``