@prosekit/web 0.7.13 → 0.8.0-beta.1

package/src/components/resizable/resizable-root.ts

@@ -0,0 +1,184 @@
+import type { HostElement, HostElementConstructor, PropsDeclaration } from '@aria-ui/core'
+import { createSignal, defineCustomElement, defineProps, registerCustomElement, useEffect, type State } from '@aria-ui/core'
+import { useAttribute } from '@aria-ui/utils'
+
+import { isFinitePositiveNumber } from '../../utils/is-finite-positive-number.ts'
+
+import {
+  onResizeContext,
+  onResizeEndContext,
+  onResizeStartContext,
+  type OnResize,
+  type OnResizeEnd,
+  type OnResizeStart,
+} from './context.ts'
+
+/**
+ * @public
+ */
+export interface ResizableRootProps {
+  /**
+   * The width of the resizable element.
+   *
+   * @default null
+   */
+  width: number | null
+
+  /**
+   * The height of the resizable element.
+   *
+   * @default null
+   */
+  height: number | null
+
+  /**
+   * The aspect ratio of the resizable element.
+   *
+   * @default null
+   */
+  aspectRatio: number | null
+}
+
+/**
+ * @internal
+ */
+export const ResizableRootPropsDeclaration: PropsDeclaration<ResizableRootProps> = defineProps<ResizableRootProps>({
+  width: { default: null, attribute: 'data-width', type: 'json' },
+  height: { default: null, attribute: 'data-height', type: 'json' },
+  aspectRatio: { default: null, attribute: 'data-aspect-ratio', type: 'json' },
+})
+
+/**
+ * @public
+ */
+export interface ResizableRootEvents {
+  /**
+   * Emitted when a resize operation starts.
+   */
+  resizeStart: ResizeStartEvent
+
+  /**
+   * Emitted when a resize operation ends.
+   */
+  resizeEnd: ResizeEndEvent
+}
+
+/**
+ * @public
+ */
+export class ResizeStartEvent extends Event {
+  readonly detail: {
+    readonly width: number
+    readonly height: number
+  }
+  constructor(width: number, height: number) {
+    super('resizeStart')
+    this.detail = { width, height }
+  }
+}
+
+/**
+ * @public
+ */
+export class ResizeEndEvent extends Event {
+  readonly detail: {
+    readonly width: number
+    readonly height: number
+  }
+  constructor(width: number, height: number) {
+    super('resizeEnd')
+    this.detail = { width, height }
+  }
+}
+
+/**
+ * @internal
+ */
+export function setupResizableRoot(
+  host: HostElement,
+  props: State<ResizableRootProps>,
+): void {
+  const resizing = createSignal(false)
+
+  const onResizeStart: OnResizeStart = () => {
+    const { width, height } = host.getBoundingClientRect()
+
+    let aspectRatio: number = props.aspectRatio.get() ?? width / height
+
+    if (!isFinitePositiveNumber(aspectRatio)) {
+      aspectRatio = 0
+    }
+
+    resizing.set(true)
+    host.dispatchEvent(new ResizeStartEvent(width, height))
+    return [width, height, aspectRatio]
+  }
+
+  const onResize: OnResize = (width, height) => {
+    props.width.set(width)
+    props.height.set(height)
+  }
+
+  const onResizeEnd: OnResizeEnd = () => {
+    const { width, height } = host.getBoundingClientRect()
+    resizing.set(false)
+    host.dispatchEvent(new ResizeEndEvent(width, height))
+  }
+
+  onResizeStartContext.provide(host, onResizeStart)
+  onResizeContext.provide(host, onResize)
+  onResizeEndContext.provide(host, onResizeEnd)
+
+  useEffect(host, () => {
+    updateResizableRootStyles(
+      host,
+      Math.max(props.width.get() || 0, 1),
+      Math.max(props.height.get() || 0, 1),
+      props.aspectRatio.get(),
+    )
+  })
+
+  useAttribute(host, 'data-resizing', () => (resizing.get() ? '' : undefined))
+}
+
+function updateResizableRootStyles(
+  host: HostElement,
+  width: number,
+  height: number,
+  aspectRatio: number | null,
+) {
+  host.style.width = isFinitePositiveNumber(width) ? `${width}px` : ''
+
+  host.style.height = isFinitePositiveNumber(height) ? `${height}px` : ''
+
+  if (isFinitePositiveNumber(aspectRatio)) {
+    host.style.aspectRatio = `${aspectRatio}`
+
+    if (width && width > 0 && aspectRatio >= 1) {
+      host.style.height = 'auto'
+    } else if (height && height > 0 && aspectRatio <= 1) {
+      host.style.width = 'min-content'
+    }
+  }
+}
+
+const ResizableRootElementBase: HostElementConstructor<ResizableRootProps> = defineCustomElement(
+  setupResizableRoot,
+  ResizableRootPropsDeclaration,
+)
+
+/**
+ * @public
+ */
+export class ResizableRootElement extends ResizableRootElementBase {}
+
+let isResizableRootRegistered = false
+
+/**
+ * @internal
+ */
+export function registerResizableRootElement(): void {
+  if (isResizableRootRegistered) return
+  isResizableRootRegistered = true
+  registerCustomElement('prosekit-resizable-root', ResizableRootElement)
+}

package/src/components/table-handle/dnd.ts

@@ -1,4 +1,4 @@
-import { createComputed, useEffect, type ConnectableElement, type ReadonlySignal } from '@aria-ui/core'
+import { useEffect, type HostElement } from '@aria-ui/core'
 import { computePosition, offset } from '@floating-ui/dom'
 import { isHTMLElement } from '@ocavue/utils'
 import type { Editor } from '@prosekit/core'
@@ -7,10 +7,10 @@ import type { EditorView } from '@prosekit/pm/view'
 import { assignStyles } from '../../utils/assign-styles.ts'
 import { getSafeEditorView } from '../../utils/get-safe-editor-view.ts'
 
-import { tableHandleDndContext, tableHandleRootContext } from './context.ts'
+import { tableHandleStoreContext } from './store.ts'
 
 export type OnInitParams = {
-  host: ConnectableElement
+  host: HostElement
   direction: 'row' | 'col'
   dragging: boolean
   draggingIndex: number
@@ -19,41 +19,30 @@ export type OnInitParams = {
 }
 
 export function useInitDndPosition(
-  host: ConnectableElement,
-  editor: ReadonlySignal<Editor | null>,
+  host: HostElement,
+  getEditor: () => Editor | null,
   onInit: (params: OnInitParams) => void,
 ): void {
-  const dndContext = tableHandleDndContext.consume(host)
-  const rootContext = tableHandleRootContext.consume(host)
-
-  const draggingSignal = createComputed(() => {
-    const context = dndContext.get()
-    return context.dragging
-  })
-
-  const directionSignal = createComputed(() => {
-    const context = dndContext.get()
-    return context.direction
-  })
-
-  const draggingIndexSignal = createComputed(() => {
-    const context = dndContext.get()
-    return context.draggingIndex
-  })
+  const getStore = tableHandleStoreContext.consume(host)
 
   useEffect(host, () => {
-    const view = getSafeEditorView(editor.get())
+    const view = getSafeEditorView(getEditor())
     if (!view) return
 
-    const dragging = draggingSignal.get()
-    const direction = directionSignal.get()
+    const store = getStore()
+    if (!store) return
+
+    const dndStore = store.dndStore
+
+    const dragging = dndStore.dragging.get()
+    const direction = dndStore.direction.get()
 
     host.dataset.direction = direction
     host.dataset.dragging = dragging.toString()
 
-    const draggingIndex = draggingIndexSignal.get()
+    const draggingIndex = dndStore.draggingIndex.get()
 
-    const relatedDOMs = getDndRelatedDOMs(view, rootContext.peek()?.cellPos, draggingIndex, direction)
+    const relatedDOMs = getDndRelatedDOMs(view, store.getReferenceCell()?.cellPos, draggingIndex, direction)
     if (!relatedDOMs) return
     const { table, cell } = relatedDOMs
 

package/src/components/table-handle/index.ts

@@ -0,0 +1,125 @@
+/**
+
+@module
+
+## Anatomy
+
+```html
+<prosekit-table-handle-root>
+  <prosekit-table-handle-drag-preview></prosekit-table-handle-drag-preview>
+  <prosekit-table-handle-drop-indicator></prosekit-table-handle-drop-indicator>
+  <prosekit-table-handle-column-positioner>
+    <prosekit-table-handle-column-popup>
+      <prosekit-table-handle-column-menu-root>
+        <prosekit-table-handle-column-menu-trigger>...</prosekit-table-handle-column-menu-trigger>
+        <prosekit-menu-positioner>
+          <prosekit-menu-popup>
+            <prosekit-menu-item>...</prosekit-menu-item>
+          </prosekit-menu-popup>
+        </prosekit-menu-positioner>
+      </prosekit-table-handle-column-menu-root>
+    </prosekit-table-handle-column-popup>
+  </prosekit-table-handle-column-positioner>
+  <prosekit-table-handle-row-positioner>
+    <prosekit-table-handle-row-popup>
+      <prosekit-table-handle-row-menu-root>
+        <prosekit-table-handle-row-menu-trigger>...</prosekit-table-handle-row-menu-trigger>
+        <prosekit-menu-positioner>
+          <prosekit-menu-popup>
+            <prosekit-menu-item>...</prosekit-menu-item>
+          </prosekit-menu-popup>
+        </prosekit-menu-positioner>
+      </prosekit-table-handle-row-menu-root>
+    </prosekit-table-handle-row-popup>
+  </prosekit-table-handle-row-positioner>
+</prosekit-table-handle-root>
+```
+*/
+
+export {
+  registerTableHandleColumnPopupElement,
+  setupTableHandleColumnPopup,
+  TableHandleColumnPopupElement,
+  TableHandleColumnPopupPropsDeclaration,
+  type TableHandleColumnPopupProps,
+} from './table-handle-column-popup.ts'
+
+export {
+  registerTableHandleColumnPositionerElement,
+  setupTableHandleColumnPositioner,
+  TableHandleColumnPositionerElement,
+  TableHandleColumnPositionerPropsDeclaration,
+  type TableHandleColumnPositionerProps,
+} from './table-handle-column-positioner.ts'
+
+export {
+  registerTableHandleColumnMenuRootElement,
+  setupTableHandleColumnMenuRoot,
+  TableHandleColumnMenuRootElement,
+  TableHandleColumnMenuRootPropsDeclaration,
+  type TableHandleColumnMenuRootProps,
+} from './table-handle-column-menu-root.ts'
+
+export {
+  registerTableHandleColumnMenuTriggerElement,
+  setupTableHandleColumnMenuTrigger,
+  TableHandleColumnMenuTriggerElement,
+  TableHandleColumnMenuTriggerPropsDeclaration,
+  type TableHandleColumnMenuTriggerProps,
+} from './table-handle-column-menu-trigger.ts'
+
+export {
+  registerTableHandleDragPreviewElement,
+  setupTableHandleDragPreview,
+  TableHandleDragPreviewElement,
+  TableHandleDragPreviewPropsDeclaration,
+  type TableHandleDragPreviewProps,
+} from './table-handle-drag-preview.ts'
+
+export {
+  registerTableHandleDropIndicatorElement,
+  setupTableHandleDropIndicator,
+  TableHandleDropIndicatorElement,
+  TableHandleDropIndicatorPropsDeclaration,
+  type TableHandleDropIndicatorProps,
+} from './table-handle-drop-indicator.ts'
+
+export {
+  registerTableHandleRootElement,
+  setupTableHandleRoot,
+  TableHandleRootElement,
+  TableHandleRootPropsDeclaration,
+  type TableHandleRootProps,
+} from './table-handle-root.ts'
+
+export {
+  registerTableHandleRowPopupElement,
+  setupTableHandleRowPopup,
+  TableHandleRowPopupElement,
+  TableHandleRowPopupPropsDeclaration,
+  type TableHandleRowPopupProps,
+} from './table-handle-row-popup.ts'
+
+export {
+  registerTableHandleRowPositionerElement,
+  setupTableHandleRowPositioner,
+  TableHandleRowPositionerElement,
+  TableHandleRowPositionerPropsDeclaration,
+  type TableHandleRowPositionerProps,
+} from './table-handle-row-positioner.ts'
+
+export {
+  registerTableHandleRowMenuRootElement,
+  setupTableHandleRowMenuRoot,
+  TableHandleRowMenuRootElement,
+  TableHandleRowMenuRootPropsDeclaration,
+  type TableHandleRowMenuRootProps,
+} from './table-handle-row-menu-root.ts'
+
+export {
+  registerTableHandleRowMenuTriggerElement,
+  setupTableHandleRowMenuTrigger,
+  TableHandleRowMenuTriggerElement,
+  TableHandleRowMenuTriggerPropsDeclaration,
+  type TableHandleRowMenuTriggerProps,
+} from './table-handle-row-menu-trigger.ts'

package/src/components/table-handle/{table-handle-drag-preview/render-preview.ts → render-preview.ts}

@@ -1,8 +1,8 @@
-import { assignStyles } from '../../../utils/assign-styles.ts'
-import { cloneElement, deepCloneElement } from '../../../utils/clone-element.ts'
-import { fadeColor } from '../../../utils/fade-color.ts'
-import { getEffectiveBackgroundColor } from '../../../utils/get-effective-background-color.ts'
-import { injectStyle } from '../../../utils/inject-style.ts'
+import { assignStyles } from '../../utils/assign-styles.ts'
+import { cloneElement, deepCloneElement } from '../../utils/clone-element.ts'
+import { fadeColor } from '../../utils/fade-color.ts'
+import { getEffectiveBackgroundColor } from '../../utils/get-effective-background-color.ts'
+import { injectStyle } from '../../utils/inject-style.ts'
 
 export function clearPreviewDOM(previewRoot: HTMLElement): void {
   while (previewRoot.firstChild) {

package/src/components/table-handle/shared.ts

@@ -0,0 +1,61 @@
+import { defineProps, type PropsDeclaration } from '@aria-ui/core'
+import { OverlayPositionerPropsDeclaration, type OverlayPositionerProps } from '@aria-ui/elements/overlay'
+import type { Editor } from '@prosekit/core'
+
+/**
+ * @internal
+ */
+export interface SharedTableHandlePositionerProps extends Omit<OverlayPositionerProps, 'hoist' | 'flip' | 'shift' | 'hide' | 'offset'> {
+  /**
+   * The ProseKit editor instance.
+   *
+   * @default null
+   * @hidden
+   */
+  editor: Editor | null
+
+  /**
+   * Whether to use the browser [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API)
+   * to place the floating element on top of other page content.
+   *
+   * @default false
+   */
+  hoist: OverlayPositionerProps['hoist']
+
+  /**
+   * @default false
+   * @hidden
+   */
+  flip: OverlayPositionerProps['flip']
+
+  /**
+   * @default false
+   * @hidden
+   */
+  shift: OverlayPositionerProps['shift']
+
+  /**
+   * @default true
+   * @hidden
+   */
+  hide: OverlayPositionerProps['hide']
+
+  /**
+   * @default 0
+   * @hidden
+   */
+  offset: OverlayPositionerProps['offset']
+}
+
+/** @internal */
+export const SharedTableHandlePositionerPropsDeclaration: PropsDeclaration<SharedTableHandlePositionerProps> = defineProps<
+  SharedTableHandlePositionerProps
+>({
+  ...OverlayPositionerPropsDeclaration,
+  editor: { default: null, attribute: false, type: 'json' },
+  hoist: { default: false, attribute: false, type: 'boolean' },
+  flip: { default: false, attribute: false, type: 'json' },
+  shift: { default: false, attribute: false, type: 'boolean' },
+  hide: { default: true, attribute: false, type: 'boolean' },
+  offset: { default: 0, attribute: false, type: 'json' },
+})

package/src/components/table-handle/store.ts

@@ -0,0 +1,117 @@
+import { computed, createContext, createSignal, type Context, type Signal } from '@aria-ui/core'
+import type { OpenChangeEvent } from '@aria-ui/elements/overlay'
+import { createOverlayStore, type OverlayStore } from '@aria-ui/elements/overlay'
+
+import type { HoveringCellInfo } from './utils.ts'
+
+function noop(): void {}
+function returnTrue(): boolean {
+  return true
+}
+function returnFalse(): boolean {
+  return false
+}
+
+class DndStore {
+  readonly dragging: Signal<boolean> = createSignal(false)
+  readonly direction: Signal<'row' | 'col'> = createSignal<'row' | 'col'>('row')
+  readonly draggingIndex: Signal<number> = createSignal(-1)
+  readonly droppingIndex: Signal<number> = createSignal(-1)
+  readonly x: Signal<number> = createSignal(-1)
+  readonly y: Signal<number> = createSignal(-1)
+  readonly startX: Signal<number> = createSignal(-1)
+  readonly startY: Signal<number> = createSignal(-1)
+}
+
+/**
+ * @internal
+ */
+export interface TableHandleStore {
+  readonly dndStore: DndStore
+  readonly setIsColumnMenuOpen: (open: boolean) => void
+  readonly setIsRowMenuOpen: (open: boolean) => void
+  readonly columnOverlayStore: OverlayStore
+  readonly rowOverlayStore: OverlayStore
+  readonly getReferenceCell: () => HoveringCellInfo | undefined
+}
+
+/**
+ * @internal
+ */
+export function createTableHandleStore(
+  getHoveringCellInfo: () => HoveringCellInfo | undefined,
+  getCanShow: () => boolean,
+): TableHandleStore {
+  const isColumnMenuOpen = createSignal(false)
+  const isRowMenuOpen = createSignal(false)
+
+  const getHasMenuOpen = (): boolean => {
+    return isColumnMenuOpen.get() || isRowMenuOpen.get()
+  }
+
+  const setIsRowMenuOpen = (open: boolean): void => {
+    isRowMenuOpen.set(open)
+  }
+
+  const setIsColumnMenuOpen = (open: boolean): void => {
+    isColumnMenuOpen.set(open)
+  }
+
+  const referenceCellInfo = createSignal<HoveringCellInfo | undefined>(undefined)
+
+  let prevHoveringCellInfo: HoveringCellInfo | undefined = undefined
+
+  const getReferenceCell = computed((): HoveringCellInfo | undefined => {
+    if (!getCanShow()) {
+      referenceCellInfo.set(undefined)
+      return
+    }
+
+    // Do not toggle/update the menu when hovering another cell if the menu is already open
+    if (getHasMenuOpen()) {
+      return prevHoveringCellInfo
+    }
+
+    prevHoveringCellInfo = getHoveringCellInfo()
+    return prevHoveringCellInfo
+  })
+
+  const getOpen = computed((): boolean => {
+    return !!getReferenceCell()
+  })
+
+  const handleOpenChange = (event: OpenChangeEvent) => {
+    if (getHasMenuOpen()) {
+      event.preventDefault()
+    }
+  }
+
+  const columnOverlayStore = createOverlayStore(
+    getOpen,
+    noop,
+    returnTrue,
+    returnFalse,
+    handleOpenChange,
+  )
+  const rowOverlayStore = createOverlayStore(
+    getOpen,
+    noop,
+    returnTrue,
+    returnFalse,
+    handleOpenChange,
+  )
+
+  return {
+    dndStore: new DndStore(),
+    setIsRowMenuOpen,
+    setIsColumnMenuOpen,
+    columnOverlayStore,
+    rowOverlayStore,
+    getReferenceCell,
+  }
+}
+
+/**
+ * @internal
+ */
+export const tableHandleStoreContext: Context<TableHandleStore> = createContext<TableHandleStore>('prosekit-table-handle-store')

package/src/components/table-handle/table-handle-column-menu-root.ts

@@ -0,0 +1,51 @@
+import {
+  defineCustomElement,
+  defineProps,
+  registerCustomElement,
+  useEffect,
+  type HostElement,
+  type HostElementConstructor,
+  type PropsDeclaration,
+  type State,
+} from '@aria-ui/core'
+import { MenuRootPropsDeclaration, setupMenuRoot, type MenuRootProps } from '@aria-ui/elements/menu'
+
+import { tableHandleStoreContext } from './store.ts'
+
+export interface TableHandleColumnMenuRootProps extends MenuRootProps {}
+
+/** @internal */
+export const TableHandleColumnMenuRootPropsDeclaration: PropsDeclaration<TableHandleColumnMenuRootProps> = defineProps<
+  TableHandleColumnMenuRootProps
+>(MenuRootPropsDeclaration)
+
+/** @internal */
+export function setupTableHandleColumnMenuRoot(
+  host: HostElement,
+  props: State<TableHandleColumnMenuRootProps>,
+): void {
+  setupMenuRoot(host, props)
+  const getStore = tableHandleStoreContext.consume(host)
+
+  useEffect(host, () => {
+    const open = props.open.get() || false
+    const store = getStore?.()
+    if (!store) return
+    store.setIsColumnMenuOpen(open)
+  })
+}
+
+const TableHandleColumnMenuRootElementBase: HostElementConstructor<TableHandleColumnMenuRootProps> = defineCustomElement(
+  setupTableHandleColumnMenuRoot,
+  TableHandleColumnMenuRootPropsDeclaration,
+)
+
+/**
+ * @public
+ */
+export class TableHandleColumnMenuRootElement extends TableHandleColumnMenuRootElementBase {}
+
+/** @internal */
+export function registerTableHandleColumnMenuRootElement(): void {
+  registerCustomElement('prosekit-table-handle-column-menu-root', TableHandleColumnMenuRootElement)
+}