@prosekit/react 0.7.0-beta.0 → 0.7.0-beta.1

package/src/components/autocomplete/autocomplete-item.gen.ts

@@ -1,34 +1,85 @@
-import {
-  type AutocompleteItemElement,
-  type AutocompleteItemProps as Props,
-  type AutocompleteItemEvents as Events,
-  autocompleteItemProps,
-  autocompleteItemEvents,
-} from '@prosekit/web/autocomplete'
-import type {
-  ForwardRefExoticComponent,
-  HTMLAttributes,
-  RefAttributes,
-} from 'react'
-
-import { createComponent } from '../create-component.ts'
-import type { CreateProps } from '../create-props.ts'
+/**
+ * This file is auto-generated by the "@aria-ui/cli" tool. Do not edit this file directly.
+ */
+
+import { registerAutocompleteItemElement, type AutocompleteItemElement, type AutocompleteItemProps as AutocompleteItemElementProps, type AutocompleteItemEvents } from '@prosekit/web/autocomplete';
+import { createElement, forwardRef, useCallback, useRef, type ForwardedRef, type ForwardRefExoticComponent, type HTMLAttributes, type RefAttributes, useLayoutEffect } from 'react';
+
+/**
+ * Props for the {@link AutocompleteItem} React component.
+ *
+ * @public
+ */
+export interface AutocompleteItemProps extends Omit<HTMLAttributes<AutocompleteItemElement>, 'onSelect'> {
+  /**
+   * The value of the item, which will be matched against the query.
+   *
+   * If not provided, the value is the item's text content.
+   *
+   * @default ""
+   */
+  value?: AutocompleteItemElementProps['value'];
+  /**
+   * Whether this option is disabled.
+   *
+   * @default false
+   */
+  disabled?: AutocompleteItemElementProps['disabled'];
+  /** Emitted when the the item is selected. */
+  onSelect?: (event: AutocompleteItemEvents['select']) => void;
+}
+
+function AutocompleteItemComponent(props: AutocompleteItemProps, forwardedRef: ForwardedRef<AutocompleteItemElement>) {
+  registerAutocompleteItemElement();
+
+  const elementRef = useRef<AutocompleteItemElement>(null);
+  const handlersRef = useRef<Array<((event: Event) => void) | undefined>>([]);
+
+  const { disabled: p0, value: p1, onSelect: e0, ...restProps } = props;
+
+  useLayoutEffect(() => {
+    const element = elementRef.current as Record<string, unknown> | null;
+    if (!element) return;
+    Object.assign(element, { disabled: p0, value: p1 });
+    handlersRef.current = [e0] as Array<((event: Event) => void) | undefined>;
+  });
+
+  useLayoutEffect(() => {
+    const element = elementRef.current;
+    if (!element) return;
+    const ac = new AbortController();
+    for (const [index, eventName] of ['select'].entries()) {
+      element.addEventListener(
+        eventName,
+        (event: Event) => {
+          handlersRef.current[index]?.(event);
+        },
+        { signal: ac.signal },
+      );
+    }
+    return () => ac.abort();
+  }, []);
+
+  const mergedRef = useCallback(
+    (element: AutocompleteItemElement | null) => {
+      elementRef.current = element;
+      if (typeof forwardedRef === 'function') {
+        forwardedRef(element);
+      } else if (forwardedRef) {
+        forwardedRef.current = element;
+      }
+    },
+    [forwardedRef],
+  );
+
+  return createElement('prosekit-autocomplete-item', { ...restProps, ref: mergedRef, suppressHydrationWarning: true });
+}
 
 /**
- * Props for the {@link AutocompleteItem} component.
+ * A React component that renders an `prosekit-autocomplete-item` custom element.
+ *
+ * @public
  */
-export interface AutocompleteItemProps extends Partial<CreateProps<Props, Events>> {}
-
-export const AutocompleteItem: ForwardRefExoticComponent<
-  AutocompleteItemProps &
-  RefAttributes<AutocompleteItemElement> &
-  HTMLAttributes<AutocompleteItemElement>
-> = createComponent<
-  AutocompleteItemProps,
-  AutocompleteItemElement
->(
-  'prosekit-autocomplete-item',
-  'AutocompleteItem',
-  Object.keys(autocompleteItemProps),
-  Object.keys(autocompleteItemEvents),
-)
+export const AutocompleteItem: ForwardRefExoticComponent<AutocompleteItemProps & RefAttributes<AutocompleteItemElement>> = /* @__PURE__ */ forwardRef(AutocompleteItemComponent);
+
+export type { AutocompleteItemEvents };

package/src/components/autocomplete/autocomplete-popup.gen.ts

@@ -0,0 +1,78 @@
+/**
+ * This file is auto-generated by the "@aria-ui/cli" tool. Do not edit this file directly.
+ */
+
+import { registerAutocompletePopupElement, type AutocompletePopupElement, type AutocompletePopupEvents } from '@prosekit/web/autocomplete';
+import { createElement, forwardRef, useCallback, useRef, type ForwardedRef, type ForwardRefExoticComponent, type HTMLAttributes, type RefAttributes, useLayoutEffect } from 'react';
+
+/**
+ * Props for the {@link AutocompletePopup} React component.
+ *
+ * @public
+ */
+export interface AutocompletePopupProps extends HTMLAttributes<AutocompletePopupElement> {
+  /**
+   * Emitted when the selected value changes. Only available when multiple is
+   * false.
+   */
+  onValueChange?: (event: AutocompletePopupEvents['valueChange']) => void;
+  /**
+   * Emitted when the selected values change. Only available when multiple is
+   * true.
+   */
+  onValuesChange?: (event: AutocompletePopupEvents['valuesChange']) => void;
+}
+
+function AutocompletePopupComponent(props: AutocompletePopupProps, forwardedRef: ForwardedRef<AutocompletePopupElement>) {
+  registerAutocompletePopupElement();
+
+  const elementRef = useRef<AutocompletePopupElement>(null);
+  const handlersRef = useRef<Array<((event: Event) => void) | undefined>>([]);
+
+  const { onValueChange: e0, onValuesChange: e1, ...restProps } = props;
+
+  useLayoutEffect(() => {
+    const element = elementRef.current as Record<string, unknown> | null;
+    if (!element) return;
+    handlersRef.current = [e0, e1] as Array<((event: Event) => void) | undefined>;
+  });
+
+  useLayoutEffect(() => {
+    const element = elementRef.current;
+    if (!element) return;
+    const ac = new AbortController();
+    for (const [index, eventName] of ['valueChange', 'valuesChange'].entries()) {
+      element.addEventListener(
+        eventName,
+        (event: Event) => {
+          handlersRef.current[index]?.(event);
+        },
+        { signal: ac.signal },
+      );
+    }
+    return () => ac.abort();
+  }, []);
+
+  const mergedRef = useCallback(
+    (element: AutocompletePopupElement | null) => {
+      elementRef.current = element;
+      if (typeof forwardedRef === 'function') {
+        forwardedRef(element);
+      } else if (forwardedRef) {
+        forwardedRef.current = element;
+      }
+    },
+    [forwardedRef],
+  );
+
+  return createElement('prosekit-autocomplete-popup', { ...restProps, ref: mergedRef, suppressHydrationWarning: true });
+}
+
+/**
+ * A React component that renders an `prosekit-autocomplete-popup` custom element.
+ *
+ * @public
+ */
+export const AutocompletePopup: ForwardRefExoticComponent<AutocompletePopupProps & RefAttributes<AutocompletePopupElement>> = /* @__PURE__ */ forwardRef(AutocompletePopupComponent);
+
+export type { AutocompletePopupEvents };

package/src/components/autocomplete/autocomplete-positioner.gen.ts

@@ -0,0 +1,151 @@
+/**
+ * This file is auto-generated by the "@aria-ui/cli" tool. Do not edit this file directly.
+ */
+
+import { registerAutocompletePositionerElement, type AutocompletePositionerElement, type AutocompletePositionerProps as AutocompletePositionerElementProps } from '@prosekit/web/autocomplete';
+import { createElement, forwardRef, useCallback, useRef, type ForwardedRef, type ForwardRefExoticComponent, type HTMLAttributes, type RefAttributes, useLayoutEffect } from 'react';
+
+/**
+ * Props for the {@link AutocompletePositioner} React component.
+ *
+ * @public
+ */
+export interface AutocompletePositionerProps extends HTMLAttributes<AutocompletePositionerElement> {
+  /**
+   * The placement of the popover, relative to the text cursor.
+   *
+   * @default "bottom-start"
+   */
+  placement?: AutocompletePositionerElementProps['placement'];
+  /**
+   * The distance between the popover and the hovered block.
+   *
+   * @default 4
+   */
+  offset?: AutocompletePositionerElementProps['offset'];
+  /** @default true */
+  inline?: AutocompletePositionerElementProps['inline'];
+  /** @default true */
+  hoist?: AutocompletePositionerElementProps['hoist'];
+  /** @default true */
+  fitViewport?: AutocompletePositionerElementProps['fitViewport'];
+  /** @default "The body element" */
+  boundary?: AutocompletePositionerElementProps['boundary'];
+  /** @default 8 */
+  overflowPadding?: AutocompletePositionerElementProps['overflowPadding'];
+  /**
+   * The strategy to use for positioning
+   *
+   * @default "absolute"
+   */
+  strategy?: AutocompletePositionerElementProps['strategy'];
+  /**
+   * Options to activate auto-update listeners
+   *
+   * @see https://floating-ui.com/docs/autoUpdate
+   *
+   * @default true
+   */
+  autoUpdate?: AutocompletePositionerElementProps['autoUpdate'];
+  /**
+   * Whether to flip the `placement` in order to keep it in view when the
+   * preferred placement(s) will overflow the clipping boundary. You can also
+   * provide an array of placements to try sequentially if the preferred
+   * `placement` does not fit.
+   *
+   * @default true
+   */
+  flip?: AutocompletePositionerElementProps['flip'];
+  /**
+   * Whether the floating element should shift to keep it in view.
+   *
+   * @default true
+   */
+  shift?: AutocompletePositionerElementProps['shift'];
+  /**
+   * Whether the floating element can overlap the reference element to keep it
+   * in view.
+   *
+   * @default false
+   */
+  overlap?: AutocompletePositionerElementProps['overlap'];
+  /**
+   * Whether to constrain the floating element's width so that it matches the
+   * reference element.
+   *
+   * @default false
+   */
+  sameWidth?: AutocompletePositionerElementProps['sameWidth'];
+  /**
+   * Whether to constrain the floating element's height so that it matches the
+   * reference element.
+   *
+   * @default false
+   */
+  sameHeight?: AutocompletePositionerElementProps['sameHeight'];
+  /**
+   * Whether to hide the floating element when the reference element or the
+   * floating element is fully clipped.
+   *
+   * @default false
+   */
+  hide?: AutocompletePositionerElementProps['hide'];
+  /**
+   * Describes the root boundary that the element will be checked for overflow relative to.
+   * Please see https://floating-ui.com/docs/detectoverflow#rootboundary for more information.
+   *
+   * @default 'viewport'
+   */
+  rootBoundary?: AutocompletePositionerElementProps['rootBoundary'];
+  /**
+   * The element that will be used to check for overflow. Please see
+   * https://floating-ui.com/docs/detectoverflow#elementcontext for more
+   * information.
+   *
+   * @default 'floating'
+   */
+  elementContext?: AutocompletePositionerElementProps['elementContext'];
+  /**
+   * Whether to check the alternate elementContext's boundary. Please see
+   * https://floating-ui.com/docs/detectoverflow#altboundary for more
+   * information.
+   *
+   * @default false
+   */
+  altBoundary?: AutocompletePositionerElementProps['altBoundary'];
+}
+
+function AutocompletePositionerComponent(props: AutocompletePositionerProps, forwardedRef: ForwardedRef<AutocompletePositionerElement>) {
+  registerAutocompletePositionerElement();
+
+  const elementRef = useRef<AutocompletePositionerElement>(null);
+
+  const { altBoundary: p0, autoUpdate: p1, boundary: p2, elementContext: p3, fitViewport: p4, flip: p5, hide: p6, hoist: p7, inline: p8, offset: p9, overflowPadding: p10, overlap: p11, placement: p12, rootBoundary: p13, sameHeight: p14, sameWidth: p15, shift: p16, strategy: p17, ...restProps } = props;
+
+  useLayoutEffect(() => {
+    const element = elementRef.current as Record<string, unknown> | null;
+    if (!element) return;
+    Object.assign(element, { altBoundary: p0, autoUpdate: p1, boundary: p2, elementContext: p3, fitViewport: p4, flip: p5, hide: p6, hoist: p7, inline: p8, offset: p9, overflowPadding: p10, overlap: p11, placement: p12, rootBoundary: p13, sameHeight: p14, sameWidth: p15, shift: p16, strategy: p17 });
+  });
+
+  const mergedRef = useCallback(
+    (element: AutocompletePositionerElement | null) => {
+      elementRef.current = element;
+      if (typeof forwardedRef === 'function') {
+        forwardedRef(element);
+      } else if (forwardedRef) {
+        forwardedRef.current = element;
+      }
+    },
+    [forwardedRef],
+  );
+
+  return createElement('prosekit-autocomplete-positioner', { ...restProps, ref: mergedRef, suppressHydrationWarning: true });
+}
+
+/**
+ * A React component that renders an `prosekit-autocomplete-positioner` custom element.
+ *
+ * @public
+ */
+export const AutocompletePositioner: ForwardRefExoticComponent<AutocompletePositionerProps & RefAttributes<AutocompletePositionerElement>> = /* @__PURE__ */ forwardRef(AutocompletePositionerComponent);

package/src/components/autocomplete/autocomplete-root.gen.ts

@@ -0,0 +1,107 @@
+/**
+ * This file is auto-generated by the "@aria-ui/cli" tool. Do not edit this file directly.
+ */
+
+import { registerAutocompleteRootElement, type AutocompleteRootElement, type AutocompleteRootProps as AutocompleteRootElementProps, type AutocompleteRootEvents } from '@prosekit/web/autocomplete';
+import { createElement, forwardRef, useCallback, useRef, type ForwardedRef, type ForwardRefExoticComponent, type HTMLAttributes, type RefAttributes, useLayoutEffect } from 'react';
+
+import { useEditorContext } from '../../contexts/editor-context.ts';
+
+/**
+ * Props for the {@link AutocompleteRoot} React component.
+ *
+ * @public
+ */
+export interface AutocompleteRootProps extends HTMLAttributes<AutocompleteRootElement> {
+  /**
+   * The ProseKit editor instance.
+   *
+   * @default null
+   * @hidden
+   */
+  editor?: AutocompleteRootElementProps['editor'];
+  /**
+   * The regular expression to match the query text to autocomplete.
+   *
+   * @default null
+   */
+  regex?: AutocompleteRootElementProps['regex'];
+  /**
+   * The filter function to determine if an item should be shown in the
+   * listbox.
+   *
+   * @default defaultItemFilter
+   */
+  filter?: AutocompleteRootElementProps['filter'];
+  /** Fired when the open state changes. */
+  onOpenChange?: (event: AutocompleteRootEvents['openChange']) => void;
+  /** Fired when the query changes. */
+  onQueryChange?: (event: AutocompleteRootEvents['queryChange']) => void;
+  /**
+   * Emitted when the selected value changes. Only available when multiple is
+   * false.
+   */
+  onValueChange?: (event: AutocompleteRootEvents['valueChange']) => void;
+  /**
+   * Emitted when the selected values change. Only available when multiple is
+   * true.
+   */
+  onValuesChange?: (event: AutocompleteRootEvents['valuesChange']) => void;
+}
+
+function AutocompleteRootComponent(props: AutocompleteRootProps, forwardedRef: ForwardedRef<AutocompleteRootElement>) {
+  registerAutocompleteRootElement();
+
+  const elementRef = useRef<AutocompleteRootElement>(null);
+  const handlersRef = useRef<Array<((event: Event) => void) | undefined>>([]);
+
+  const p0Fallback = useEditorContext();
+
+  const { editor: p0, filter: p1, regex: p2, onOpenChange: e0, onQueryChange: e1, onValueChange: e2, onValuesChange: e3, ...restProps } = props;
+
+  useLayoutEffect(() => {
+    const element = elementRef.current as Record<string, unknown> | null;
+    if (!element) return;
+    Object.assign(element, { editor: p0 ?? p0Fallback, filter: p1, regex: p2 });
+    handlersRef.current = [e0, e1, e2, e3] as Array<((event: Event) => void) | undefined>;
+  });
+
+  useLayoutEffect(() => {
+    const element = elementRef.current;
+    if (!element) return;
+    const ac = new AbortController();
+    for (const [index, eventName] of ['openChange', 'queryChange', 'valueChange', 'valuesChange'].entries()) {
+      element.addEventListener(
+        eventName,
+        (event: Event) => {
+          handlersRef.current[index]?.(event);
+        },
+        { signal: ac.signal },
+      );
+    }
+    return () => ac.abort();
+  }, []);
+
+  const mergedRef = useCallback(
+    (element: AutocompleteRootElement | null) => {
+      elementRef.current = element;
+      if (typeof forwardedRef === 'function') {
+        forwardedRef(element);
+      } else if (forwardedRef) {
+        forwardedRef.current = element;
+      }
+    },
+    [forwardedRef],
+  );
+
+  return createElement('prosekit-autocomplete-root', { ...restProps, ref: mergedRef, suppressHydrationWarning: true });
+}
+
+/**
+ * A React component that renders an `prosekit-autocomplete-root` custom element.
+ *
+ * @public
+ */
+export const AutocompleteRoot: ForwardRefExoticComponent<AutocompleteRootProps & RefAttributes<AutocompleteRootElement>> = /* @__PURE__ */ forwardRef(AutocompleteRootComponent);
+
+export type { AutocompleteRootEvents };

package/src/components/autocomplete/index.gen.ts

@@ -1,7 +1,15 @@
-export { AutocompleteEmpty, type AutocompleteEmptyProps } from './autocomplete-empty.gen.ts'
+/**
+ * This file is auto-generated by the "@aria-ui/cli" tool. Do not edit this file directly.
+ */
 
-export { AutocompleteItem, type AutocompleteItemProps } from './autocomplete-item.gen.ts'
+export { AutocompleteEmpty, type AutocompleteEmptyProps } from './autocomplete-empty.gen.ts';
 
-export { AutocompleteList, type AutocompleteListProps } from './autocomplete-list.gen.ts'
+export { AutocompleteItem, type AutocompleteItemProps, type AutocompleteItemEvents } from './autocomplete-item.gen.ts';
 
-export { AutocompletePopover, type AutocompletePopoverProps } from './autocomplete-popover.gen.ts'
+export { AutocompletePopup, type AutocompletePopupProps, type AutocompletePopupEvents } from './autocomplete-popup.gen.ts';
+
+export { AutocompletePositioner, type AutocompletePositionerProps } from './autocomplete-positioner.gen.ts';
+
+export { AutocompleteRoot, type AutocompleteRootProps, type AutocompleteRootEvents } from './autocomplete-root.gen.ts';
+
+export { OpenChangeEvent, QueryChangeEvent, SelectEvent, ValueChangeEvent, ValuesChangeEvent } from '@prosekit/web/autocomplete';

package/src/components/autocomplete/index.ts

@@ -0,0 +1,27 @@
+/**
+
+@module
+
+## Anatomy
+
+```jsx
+import {
+  AutocompleteEmpty,
+  AutocompleteItem,
+  AutocompletePopup,
+  AutocompletePositioner,
+  AutocompleteRoot,
+} from 'prosekit/react/autocomplete'
+
+<AutocompleteRoot>
+  <AutocompletePositioner>
+    <AutocompletePopup>
+      <AutocompleteItem>...</AutocompleteItem>
+      <AutocompleteEmpty>...</AutocompleteEmpty>
+    </AutocompletePopup>
+  </AutocompletePositioner>
+</AutocompleteRoot>
+```
+*/
+
+export * from './index.gen.ts'

package/src/components/block-handle/block-handle-add.gen.ts

@@ -1,34 +1,60 @@
-import {
-  type BlockHandleAddElement,
-  type BlockHandleAddProps as Props,
-  type BlockHandleAddEvents as Events,
-  blockHandleAddProps,
-  blockHandleAddEvents,
-} from '@prosekit/web/block-handle'
-import type {
-  ForwardRefExoticComponent,
-  HTMLAttributes,
-  RefAttributes,
-} from 'react'
-
-import { createComponent } from '../create-component.ts'
-import type { CreateProps } from '../create-props.ts'
+/**
+ * This file is auto-generated by the "@aria-ui/cli" tool. Do not edit this file directly.
+ */
+
+import { registerBlockHandleAddElement, type BlockHandleAddElement, type BlockHandleAddProps as BlockHandleAddElementProps } from '@prosekit/web/block-handle';
+import { createElement, forwardRef, useCallback, useRef, type ForwardedRef, type ForwardRefExoticComponent, type HTMLAttributes, type RefAttributes, useLayoutEffect } from 'react';
+
+import { useEditorContext } from '../../contexts/editor-context.ts';
+
+/**
+ * Props for the {@link BlockHandleAdd} React component.
+ *
+ * @public
+ */
+export interface BlockHandleAddProps extends HTMLAttributes<BlockHandleAddElement> {
+  /**
+   * The ProseKit editor instance.
+   *
+   * @default null
+   * @hidden
+   */
+  editor?: BlockHandleAddElementProps['editor'];
+}
+
+function BlockHandleAddComponent(props: BlockHandleAddProps, forwardedRef: ForwardedRef<BlockHandleAddElement>) {
+  registerBlockHandleAddElement();
+
+  const elementRef = useRef<BlockHandleAddElement>(null);
+
+  const p0Fallback = useEditorContext();
+
+  const { editor: p0, ...restProps } = props;
+
+  useLayoutEffect(() => {
+    const element = elementRef.current as Record<string, unknown> | null;
+    if (!element) return;
+    Object.assign(element, { editor: p0 ?? p0Fallback });
+  });
+
+  const mergedRef = useCallback(
+    (element: BlockHandleAddElement | null) => {
+      elementRef.current = element;
+      if (typeof forwardedRef === 'function') {
+        forwardedRef(element);
+      } else if (forwardedRef) {
+        forwardedRef.current = element;
+      }
+    },
+    [forwardedRef],
+  );
+
+  return createElement('prosekit-block-handle-add', { ...restProps, ref: mergedRef, suppressHydrationWarning: true });
+}
 
 /**
- * Props for the {@link BlockHandleAdd} component.
+ * A React component that renders an `prosekit-block-handle-add` custom element.
+ *
+ * @public
  */
-export interface BlockHandleAddProps extends Partial<CreateProps<Props, Events>> {}
-
-export const BlockHandleAdd: ForwardRefExoticComponent<
-  BlockHandleAddProps &
-  RefAttributes<BlockHandleAddElement> &
-  HTMLAttributes<BlockHandleAddElement>
-> = createComponent<
-  BlockHandleAddProps,
-  BlockHandleAddElement
->(
-  'prosekit-block-handle-add',
-  'BlockHandleAdd',
-  Object.keys(blockHandleAddProps),
-  Object.keys(blockHandleAddEvents),
-)
+export const BlockHandleAdd: ForwardRefExoticComponent<BlockHandleAddProps & RefAttributes<BlockHandleAddElement>> = /* @__PURE__ */ forwardRef(BlockHandleAddComponent);