@byline/richtext-lexical 0.9.3

package/src/field/plugins/treeview-plugin/index.tsx

@@ -0,0 +1,29 @@
+'use client'
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import type * as React from 'react'
+
+import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext'
+import { TreeView } from '@lexical/react/LexicalTreeView'
+
+export function TreeViewPlugin(): React.JSX.Element {
+  const [editor] = useLexicalComposerContext()
+  return (
+    <TreeView
+      viewClassName="tree-view-output"
+      treeTypeButtonClassName="debug-treetype-button"
+      timeTravelPanelClassName="debug-timetravel-panel"
+      timeTravelButtonClassName="debug-timetravel-button"
+      timeTravelPanelSliderClassName="debug-timetravel-panel-slider"
+      timeTravelPanelButtonClassName="debug-timetravel-panel-button"
+      editor={editor}
+    />
+  )
+}

package/src/field/plugins/vimeo-plugin/index.ts

@@ -0,0 +1,42 @@
+'use client'
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import { useEffect } from 'react'
+
+import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext'
+import { $insertNodeToNearestRoot } from '@lexical/utils'
+import { COMMAND_PRIORITY_EDITOR, createCommand, type LexicalCommand } from 'lexical'
+
+import { $createVimeoNode, VimeoNode } from '../../nodes/vimeo-node'
+
+export const INSERT_VIMEO_COMMAND: LexicalCommand<string> = createCommand('INSERT_VIMEO_COMMAND')
+
+export function VimeoPlugin(): React.JSX.Element | null {
+  const [editor] = useLexicalComposerContext()
+
+  useEffect(() => {
+    if (!editor.hasNodes([VimeoNode])) {
+      throw new Error('VimeoPlugin: VimeoNode not registered on editor')
+    }
+
+    return editor.registerCommand<string>(
+      INSERT_VIMEO_COMMAND,
+      (payload) => {
+        const vimeoNode = $createVimeoNode(payload)
+        $insertNodeToNearestRoot(vimeoNode)
+
+        return true
+      },
+      COMMAND_PRIORITY_EDITOR
+    )
+  }, [editor])
+
+  return null
+}

package/src/field/plugins/youtube-plugin/index.ts

@@ -0,0 +1,43 @@
+'use client'
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import { useEffect } from 'react'
+
+import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext'
+import { $insertNodeToNearestRoot } from '@lexical/utils'
+import { COMMAND_PRIORITY_EDITOR, createCommand, type LexicalCommand } from 'lexical'
+
+import { $createYouTubeNode, YouTubeNode } from '../../nodes/youtube-node'
+
+export const INSERT_YOUTUBE_COMMAND: LexicalCommand<string> =
+  createCommand('INSERT_YOUTUBE_COMMAND')
+
+export function YouTubePlugin(): React.JSX.Element | null {
+  const [editor] = useLexicalComposerContext()
+
+  useEffect(() => {
+    if (!editor.hasNodes([YouTubeNode])) {
+      throw new Error('YouTubePlugin: YouTubeNode not registered on editor')
+    }
+
+    return editor.registerCommand<string>(
+      INSERT_YOUTUBE_COMMAND,
+      (payload) => {
+        const youTubeNode = $createYouTubeNode(payload)
+        $insertNodeToNearestRoot(youTubeNode)
+
+        return true
+      },
+      COMMAND_PRIORITY_EDITOR
+    )
+  }, [editor])
+
+  return null
+}

package/src/field/shared/canUseDOM.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+export const CAN_USE_DOM: boolean =
+  typeof window !== 'undefined' && typeof window.document.createElement !== 'undefined'

package/src/field/shared/caretFromPoint.bak

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+export default function caretFromPoint(
+  x: number,
+  y: number
+): null | {
+  offset: number
+  node: Node
+} {
+  if (typeof document.caretRangeFromPoint !== 'undefined') {
+    const range = document.caretRangeFromPoint(x, y)
+    if (range === null) {
+      return null
+    }
+    return {
+      node: range.startContainer,
+      offset: range.startOffset
+    }
+    // @ts-expect-error: caretPositionFromPoint does not exist on document
+  } else if (document.caretPositionFromPoint !== 'undefined') {
+    // @ts-expect-error: caretPositionFromPoint does not exist on document
+    const range = document.caretPositionFromPoint(x, y)
+    if (range === null) {
+      return null
+    }
+    return {
+      node: range.offsetNode,
+      offset: range.offset
+    }
+  } else {
+    // Gracefully handle IE
+    return null
+  }
+}

package/src/field/shared/environment.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import { CAN_USE_DOM } from './canUseDOM'
+
+declare global {
+  interface Document {
+    documentMode?: unknown
+  }
+
+  interface Window {
+    MSStream?: unknown
+  }
+}
+
+const documentMode = CAN_USE_DOM && 'documentMode' in document ? document.documentMode : null
+
+export const IS_APPLE: boolean = CAN_USE_DOM && /Mac|iPod|iPhone|iPad/.test(navigator.platform)
+
+export const IS_FIREFOX: boolean =
+  CAN_USE_DOM && /^(?!.*Seamonkey)(?=.*Firefox).*/i.test(navigator.userAgent)
+
+export const CAN_USE_BEFORE_INPUT: boolean =
+  CAN_USE_DOM && 'InputEvent' in window && documentMode == null
+    ? 'getTargetRanges' in new window.InputEvent('input')
+    : false
+
+export const IS_SAFARI: boolean = CAN_USE_DOM && /Version\/[\d.]+.*Safari/.test(navigator.userAgent)
+
+export const IS_IOS: boolean =
+  CAN_USE_DOM && /iPad|iPhone|iPod/.test(navigator.userAgent) && window.MSStream == null
+
+// Keep these in case we need to use them in the future.
+// export const IS_WINDOWS: boolean = CAN_USE_DOM && /Win/.test(navigator.platform);
+export const IS_CHROME: boolean = CAN_USE_DOM && /^(?=.*Chrome).*/i.test(navigator.userAgent)
+// export const canUseTextInputEvent: boolean = CAN_USE_DOM && 'TextEvent' in window && !documentMode;
+
+export const IS_APPLE_WEBKIT =
+  CAN_USE_DOM && /AppleWebKit\/[\d.]+/.test(navigator.userAgent) && !IS_CHROME

package/src/field/shared/invariant.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+// invariant(condition, message) will refine types based on "condition", and
+// if "condition" is false will throw an error. This function is special-cased
+// in flow itself, so we can't name it anything else.
+export default function invariant(
+  cond?: boolean,
+  message?: string,
+  ..._args: string[]
+): asserts cond {
+  if (cond ?? false) {
+    return
+  }
+
+  throw new Error(
+    `Internal Lexical error: invariant() is meant to be replaced at compile ' +
+      'time. There is no runtime version. Error: ${message ?? ''}`
+  )
+}

package/src/field/shared/simpleDiffWithCursor.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+export default function simpleDiffWithCursor(
+  a: string,
+  b: string,
+  cursor: number
+): { index: number; insert: string; remove: number } {
+  const aLength = a.length
+  const bLength = b.length
+  let left = 0 // number of same characters counting from left
+  let right = 0 // number of same characters counting from right
+  // Iterate left to the right until we find a changed character
+  // First iteration considers the current cursor position
+  while (left < aLength && left < bLength && a[left] === b[left] && left < cursor) {
+    left++
+  }
+  // Iterate right to the left until we find a changed character
+  while (
+    right + left < aLength &&
+    right + left < bLength &&
+    a[aLength - right - 1] === b[bLength - right - 1]
+  ) {
+    right++
+  }
+  // Try to iterate left further to the right without caring about the current cursor position
+  while (right + left < aLength && right + left < bLength && a[left] === b[left]) {
+    left++
+  }
+  return {
+    index: left,
+    insert: b.slice(left, bLength - right),
+    remove: aLength - left - right,
+  }
+}

package/src/field/shared/useLayoutEffect.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import { useEffect, useLayoutEffect } from 'react'
+
+import { CAN_USE_DOM } from './canUseDOM'
+
+const useLayoutEffectImpl: typeof useLayoutEffect = CAN_USE_DOM ? useLayoutEffect : useEffect
+
+export default useLayoutEffectImpl

package/src/field/shared/useModalFormState.ts

@@ -0,0 +1,48 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+import { type Dispatch, type SetStateAction, useEffect, useRef, useState } from 'react'
+
+/**
+ * Modal form-state machine: initialise state from a factory once, and reset
+ * it on the **leading edge** of `isOpen` (closed → open). The ref guard is
+ * load-bearing — without it, an effect with the factory's source data in its
+ * deps would fire every time the parent re-derives the prop, wiping
+ * in-progress input mid-edit.
+ *
+ * The `init` callback is read at fire time (latest render's closure), so
+ * factories that close over fresh props will see the correct values.
+ *
+ * `onReset` runs immediately after the state reset — useful for clearing
+ * sibling state such as validation errors that must align with the form.
+ */
+export function useModalFormState<T>(
+  isOpen: boolean,
+  init: () => T,
+  onReset?: () => void
+): [T, Dispatch<SetStateAction<T>>] {
+  const [state, setState] = useState<T>(init)
+
+  // Hold the latest `init` / `onReset` in refs so the leading-edge effect
+  // doesn't need them in its deps — we want it driven solely by `isOpen`.
+  const initRef = useRef(init)
+  initRef.current = init
+  const onResetRef = useRef(onReset)
+  onResetRef.current = onReset
+
+  const wasOpenRef = useRef(false)
+  useEffect(() => {
+    if (isOpen && !wasOpenRef.current) {
+      setState(initRef.current())
+      onResetRef.current?.()
+    }
+    wasOpenRef.current = isOpen
+  }, [isOpen])
+
+  return [state, setState]
+}

package/src/field/shared/warnOnlyOnce.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+export default function warnOnlyOnce(message: string): (() => void) | undefined {
+  // @ts-expect-error: ignore
+  if (!__DEV__) {
+    return
+  }
+  let run = false
+  return () => {
+    if (!run) {
+      console.warn(message)
+    }
+    run = true
+  }
+}