edytor 1.0.0 → 3.0.0

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/make-adapter/make-monitor.js

@@ -9,9 +9,8 @@ export function makeMonitor() {
     // Monitor is allowed to monitor events if:
     // 1. It has no `canMonitor` function (default is that a monitor can listen to everything)
     // 2. `canMonitor` returns true
-    if (!monitor.canMonitor || monitor.canMonitor(dragging.canMonitorArgs)) {
-      dragging.active.add(monitor);
-    }
+    // edytor: no monitor sets `canMonitor`.
+    dragging.active.add(monitor);
   }
   function monitorForConsumers(args) {
     // We are giving each `args` a new reference so that you

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/element/custom-native-drag-preview/set-custom-native-drag-preview.d.ts

@@ -29,7 +29,7 @@ type RenderFn = ({ container, }: {
  * });
  */
 export declare function setCustomNativeDragPreview({ render, nativeSetDragImage, getOffset, }: {
-    getOffset?: GetOffsetFn;
+    getOffset: GetOffsetFn;
     render: RenderFn;
     nativeSetDragImage: ElementEventPayloadMap['onGenerateDragPreview']['nativeSetDragImage'];
 }): void;

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/element/custom-native-drag-preview/set-custom-native-drag-preview.js

@@ -1,8 +1,6 @@
 import { monitorForElements } from '../../../adapter/element-adapter.js';
 import { isSafari } from '../../../util/is-safari.js';
-import { maxZIndex } from '../../../util/max-z-index.js';
 import { popoverResetUserAgentStyles } from '../../../util/popover-reset-styles.js';
-import { supportsPopover } from '../../../util/supports-popover.js';
 
 /** A function to remove the element that has been added to the `container`.
  * @example () => root.unmount()
@@ -10,13 +8,6 @@ import { supportsPopover } from '../../../util/supports-popover.js';
 
 /** A function that will render a preview element into a `container` `HTMLElement` */
 
-/** By default we use the build in values for the native drag preview: {x: 0, y: 0} */
-function defaultOffset() {
-  return {
-    x: 0,
-    y: 0
-  };
-}
 
 /** This function provides the ability to mount an element for it to be used as the native drag preview
  *
@@ -37,7 +28,8 @@ function defaultOffset() {
 export function setCustomNativeDragPreview({
   render,
   nativeSetDragImage,
-  getOffset = defaultOffset
+  // edytor: every caller gives its `getOffset`.
+  getOffset
 }) {
   const container = document.createElement('div');
 
@@ -50,23 +42,15 @@ export function setCustomNativeDragPreview({
   // Falls back to position:fixed + maxZIndex when the popover API is not available.
   // Note: the popover attribute must be set before the element is in the DOM.
   // `.showPopover()` is called further below after the element is appended to the body.
-  if (supportsPopover()) {
-    container.setAttribute('popover', 'manual');
-  }
+  // edytor: every supported engine has the Popover API (no fallback).
+  container.setAttribute('popover', 'manual');
   Object.assign(container.style, {
     // Ensuring we don't cause reflow when adding the element to the page
     // Using `position:fixed` rather than `position:absolute` so we are
     // positioned on the current viewport.
     // `position:fixed` also creates a new stacking context, so we don't need to do that here
     position: 'fixed',
-    ...(supportsPopover() ?
-    // needs to come first as it has 'inset: unset' which
-    // needs to be overridden by our top / left values
-    popoverResetUserAgentStyles : {
-      // Fallback: using maximum possible z-index so that this element
-      // will always be on top of other positioned content.
-      zIndex: maxZIndex
-    }),
+    ...popoverResetUserAgentStyles,
     // According to `mdn`, the element can be offscreen:
     // https://developer.mozilla.org/en-US/docs/Web/API/DataTransfer/setDragImage#imgelement
     //
@@ -82,9 +66,7 @@ export function setCustomNativeDragPreview({
   document.body.append(container);
 
   // `.showPopover()` must be called after the element is in the DOM.
-  if (supportsPopover()) {
-    container.showPopover();
-  }
+  container.showPopover();
   const unmount = render({
     container
   });

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/external/contains-files.d.ts

@@ -0,0 +1,2 @@
+import { type ContainsSource } from './native-types.js';
+export declare function containsFiles({ source }: ContainsSource): boolean;

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/external/contains-files.js

@@ -0,0 +1,5 @@
+export function containsFiles({
+  source
+}) {
+  return source.types.includes('Files');
+}

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/external/get-files.d.ts

@@ -0,0 +1,3 @@
+import { type ContainsSource } from './native-types.js';
+/** Obtain an array of the dragged `File`s */
+export declare function getFiles({ source }: ContainsSource): File[];

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/external/get-files.js

@@ -0,0 +1,12 @@
+/** Obtain an array of the dragged `File`s */
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
+export function getFiles({
+  source
+}) {
+  return source.items
+  // unlike other media types, for files:
+  // item.kind is 'file'
+  // item.type is the type of file eg 'image/jpg'
+  // for other media types, item.type is the mime format
+  .filter(item => item.kind === 'file').map(item => item.getAsFile()).filter(file => file != null);
+}

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/external/native-types.d.ts

@@ -0,0 +1,12 @@
+import type { ExternalDragPayload } from '../../internal-types.js';
+/** `ContainsSource` works for
+ * 1. `monitorForNative` > `canMonitor()`
+ * 2. `dropTargetForNative` > `canDrop()`
+ *
+ * We are also using `SourcePayload` as the parameter type for all native getters.
+ * For example, `getFiles({source}: SourcePayload)`
+ */
+export type ContainsSource = {
+    source: ExternalDragPayload;
+};
+export type PredicateFn = (args: ContainsSource) => boolean;

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/changing-window/is-entering-window-in-safari.js

@@ -0,0 +1,10 @@
+import { isSafari } from '../is-safari.js';
+import { symbols } from './count-events-for-safari.js';
+export function isEnteringWindowInSafari({
+  dragEnter
+}) {
+  if (!isSafari()) {
+    return false;
+  }
+  return dragEnter.hasOwnProperty(symbols.isEnteringWindow);
+}

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/changing-window/is-entering-window.js

@@ -0,0 +1,55 @@
+import { isFirefox } from '../is-firefox.js';
+import { isSafari } from '../is-safari.js';
+import { isEnteringWindowInSafari } from './is-entering-window-in-safari.js';
+import { isFromAnotherWindow } from './is-from-another-window.js';
+export function isEnteringWindow({
+  dragEnter
+}) {
+  const {
+    type,
+    relatedTarget
+  } = dragEnter;
+  if (type !== 'dragenter') {
+    return false;
+  }
+  if (isSafari()) {
+    return isEnteringWindowInSafari({
+      dragEnter
+    });
+  }
+
+  // standard check
+  if (relatedTarget == null) {
+    return true;
+  }
+
+  /**
+   * 🦊 Exception: `iframe` in Firefox (`125.0`)
+   *
+   * Case 1: parent `window` → child `iframe`
+   * `relatedTarget` is the `iframe` element in the parent `window`
+   * (foreign element)
+   *
+   * Case 2: child `iframe` → parent `window`
+   * `relatedTarget` is an element inside the child `iframe`
+   * (foreign element)
+   */
+
+  if (isFirefox()) {
+    return isFromAnotherWindow(relatedTarget);
+  }
+
+  /**
+   * 🌏 Exception: `iframe` in Chrome (`124.0`)
+   *
+   * Case 1: parent `window` → child `iframe`
+   * `relatedTarget` is `null` *(standard check)*
+   *
+   * Case 2: child `iframe` → parent `window`
+   * `relatedTarget` is the `iframe` element in the parent `window`
+   */
+
+  // Case 2
+  // Using `instanceof` check as the element will be in the same `window`
+  return relatedTarget instanceof HTMLIFrameElement;
+}

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/entry-point/external.d.ts

@@ -0,0 +1,4 @@
+import type { ExternalDragType, CleanupFn } from '../../pragmatic-drag-and-drop/entry-point/types.js';
+import type { ElementAutoScrollArgs, WindowAutoScrollArgs } from '../internal-types.js';
+export declare const autoScrollForExternal: (args: ElementAutoScrollArgs<ExternalDragType>) => CleanupFn;
+export declare const autoScrollWindowForExternal: (args?: WindowAutoScrollArgs<ExternalDragType>) => CleanupFn;

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/entry-point/external.js

@@ -0,0 +1,8 @@
+import { monitorForExternal } from '../../pragmatic-drag-and-drop/adapter/monitor-for-external.js';
+import { makeApi } from '../over-element/make-api.js';
+const api = makeApi({
+  monitor: monitorForExternal
+});
+export const autoScrollForExternal = api.autoScroll;
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
+export const autoScrollWindowForExternal = api.autoScrollWindow;

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/internal-types.d.ts

@@ -37,13 +37,9 @@ export type PublicConfig = Partial<{
 export type ElementAutoScrollArgs<DragType extends AllDragTypes> = {
     element: Element;
     canScroll?: (args: ElementGetFeedbackArgs<DragType>) => boolean;
-    getAllowedAxis?: (args: ElementGetFeedbackArgs<DragType>) => AllowedAxis;
-    getConfiguration?: (args: ElementGetFeedbackArgs<DragType>) => PublicConfig;
 };
 export type WindowAutoScrollArgs<DragType extends AllDragTypes> = {
     canScroll?: (args: WindowGetFeedbackArgs<DragType>) => boolean;
-    getAllowedAxis?: (args: WindowGetFeedbackArgs<DragType>) => AllowedAxis;
-    getConfiguration?: (args: WindowGetFeedbackArgs<DragType>) => PublicConfig;
 };
 export type Side = 'start' | 'end';
 export type Axis = 'vertical' | 'horizontal';

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/over-element/get-scroll-by.js

@@ -1,8 +1,7 @@
 import { canScrollOnEdge } from '../shared/can-scroll-on-edge.js';
-import { edgeAxisLookup, edges } from '../shared/edges.js';
+import { edges } from '../shared/edges.js';
 import { getOverElementHitbox } from '../shared/get-over-element-hitbox.js';
 import { getScrollChange } from '../shared/get-scroll-change.js';
-import { isAxisAllowed } from '../shared/is-axis-allowed.js';
 import { isWithin } from '../shared/is-within.js';
 function getRectDefault(element) {
   return element.getBoundingClientRect();
@@ -13,7 +12,6 @@ export function getScrollBy({
   timeSinceLastFrame,
   engagement,
   config,
-  allowedAxis,
   getRect = getRectDefault
 }) {
   const client = {
@@ -26,15 +24,6 @@ export function getScrollBy({
       clientRect,
       config
     });
-    const axis = edgeAxisLookup[edge];
-
-    // Note: changing the allowed axis during a drag will not
-    // reset time dampening. It was decided it would be too
-    // complex to implement initially, and we can add it
-    // later if needed.
-    if (!isAxisAllowed(axis, allowedAxis)) {
-      return map;
-    }
     if (!isWithin({
       client,
       clientRect: hitbox
@@ -50,66 +39,21 @@ export function getScrollBy({
     });
     return map;
   }, new Map());
-  const left = (() => {
-    const axis = 'horizontal';
-    const leftEdge = scrollableEdges.get('left');
-    if (leftEdge) {
-      return getScrollChange({
-        client,
-        edge: leftEdge.edge,
-        hitbox: leftEdge.hitbox,
-        axis,
-        timeSinceLastFrame,
-        engagement,
-        isDistanceDampeningEnabled: true,
-        config
-      });
-    }
-    const rightEdge = scrollableEdges.get('right');
-    if (rightEdge) {
-      return getScrollChange({
-        client,
-        edge: rightEdge.edge,
-        hitbox: rightEdge.hitbox,
-        axis,
-        timeSinceLastFrame,
-        engagement,
-        isDistanceDampeningEnabled: true,
-        config
-      });
-    }
-    return 0;
-  })();
-  const top = (() => {
-    const axis = 'vertical';
-    const bottomEdge = scrollableEdges.get('bottom');
-    if (bottomEdge) {
-      return getScrollChange({
-        client,
-        edge: bottomEdge.edge,
-        hitbox: bottomEdge.hitbox,
-        axis,
-        timeSinceLastFrame,
-        engagement,
-        isDistanceDampeningEnabled: true,
-        config
-      });
-    }
-    const topEdge = scrollableEdges.get('top');
-    if (topEdge) {
-      return getScrollChange({
-        client,
-        edge: topEdge.edge,
-        hitbox: topEdge.hitbox,
-        axis,
-        timeSinceLastFrame,
-        engagement,
-        isDistanceDampeningEnabled: true,
-        config
-      });
-    }
-    return 0;
-  })();
+  // edytor: one change per axis, the first of its edges the pointer is over.
+  const change = (axis, first, second) => {
+    const entry = scrollableEdges.get(first) ?? scrollableEdges.get(second);
+    return entry ? getScrollChange({
+      client,
+      edge: entry.edge,
+      hitbox: entry.hitbox,
+      axis,
+      timeSinceLastFrame,
+      engagement,
+      config
+    }) : 0;
+  };
+  const left = change('horizontal', 'left', 'right');
+  const top = change('vertical', 'bottom', 'top');
   return {
     left,
     top

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/over-element/try-scroll.js

@@ -1,4 +1,4 @@
-import { getInternalConfig } from '../shared/configuration.js';
+import { internalConfig as config } from '../shared/configuration.js';
 import { markAndGetEngagement } from '../shared/engagement-history.js';
 import { selector } from './data-attributes.js';
 import { getScrollBy } from './get-scroll-by.js';
@@ -16,7 +16,6 @@ function tryScrollElements({
     left: true
   }
 }) {
-  var _container$getConfigu, _container$getAllowed, _container$getAllowed2;
   // we cannot do any more scrolling
   if (!isScrollingAvailable(available)) {
     return available;
@@ -64,14 +63,11 @@ function tryScrollElements({
   // Marking engagement even if no edges are scrollable.
   // We are marking engagement as soon as the element is scrolled over
   const engagement = markAndGetEngagement(element);
-  const config = getInternalConfig((_container$getConfigu = container.getConfiguration) === null || _container$getConfigu === void 0 ? void 0 : _container$getConfigu.call(container, feedback));
-  const allowedAxis = (_container$getAllowed = (_container$getAllowed2 = container.getAllowedAxis) === null || _container$getAllowed2 === void 0 ? void 0 : _container$getAllowed2.call(container, feedback)) !== null && _container$getAllowed !== void 0 ? _container$getAllowed : 'all';
   const scrollBy = getScrollBy({
     element,
     engagement,
     input,
     timeSinceLastFrame,
-    allowedAxis,
     config
   });
 
@@ -111,7 +107,6 @@ function tryScrollWindow({
     element
   };
   for (const entry of entries) {
-    var _entry$getConfigurati, _entry$getAllowedAxis, _entry$getAllowedAxis2;
     // this entry is not allowing scrolling, we need to look for another
     if (entry.canScroll && !entry.canScroll(feedback)) {
       continue;
@@ -120,14 +115,11 @@ function tryScrollWindow({
     // Note: if we had an event for when the user is leaving a tab
     // we _could_ conceptually reset the engagement
     const engagement = markAndGetEngagement(element);
-    const config = getInternalConfig((_entry$getConfigurati = entry.getConfiguration) === null || _entry$getConfigurati === void 0 ? void 0 : _entry$getConfigurati.call(entry, feedback));
-    const allowedAxis = (_entry$getAllowedAxis = (_entry$getAllowedAxis2 = entry.getAllowedAxis) === null || _entry$getAllowedAxis2 === void 0 ? void 0 : _entry$getAllowedAxis2.call(entry, feedback)) !== null && _entry$getAllowedAxis !== void 0 ? _entry$getAllowedAxis : 'all';
     const scrollBy = getScrollBy({
       element,
       engagement,
       input,
       config,
-      allowedAxis,
       getRect: element => DOMRect.fromRect({
         y: 0,
         x: 0,

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/configuration.js

@@ -17,33 +17,8 @@ const baseConfig = {
   maxMainAxisHitboxSize: 180
 };
 
-/** What the max scroll should be per second. Using "per second" rather than "per frame"
- * as we want a consistent scroll speed regardless of frame rate.
- *
- *
- * I explored trying to make the max scroll speed dynamic based on particular factors.
- * However, it ended up being difficult to find a _perfect_ formula.
- *
- * Likely the perfect answer would involve:
- * - the size of the scrollable element
- * - the size of the scrollable element relative to the screen size
- * - the size of the drag preview
- * - the size of elements being scrolled in scrollable elements (expensive and difficult to compute)
- */
-const maxPixelScrollPerSecond = {
-  // What the value would be if we were scrolling at 15px per frame at 60fps.
-  // This is the default as it works well for most experiences.
-  // In certain scenarios though it can feel a bit slow.
-  standard: 15 * 60,
-  // What the value would be if we were scrolling at 25px per frame at 60fps.
-  // This is not the default as it feels too fast for a lot of experiences.
-  fast: 25 * 60
+// edytor: no element sets `getConfiguration`: the standard speed only.
+export const internalConfig = {
+  ...baseConfig,
+  maxPixelScrollPerSecond: 15 * 60
 };
-export function getInternalConfig(provided) {
-  var _provided$maxScrollSp;
-  return {
-    ...baseConfig,
-    // only allowing limited control over the config at this stage
-    maxPixelScrollPerSecond: maxPixelScrollPerSecond[(_provided$maxScrollSp = provided === null || provided === void 0 ? void 0 : provided.maxScrollSpeed) !== null && _provided$maxScrollSp !== void 0 ? _provided$maxScrollSp : 'standard']
-  };
-}

package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/get-scroll-change.js

@@ -62,7 +62,6 @@ export function getScrollChange({
   axis,
   hitbox,
   edge,
-  isDistanceDampeningEnabled,
   config
 }) {
   // We have two forms of speed dampening:
@@ -77,13 +76,13 @@ export function getScrollChange({
     timeSinceLastFrame,
     config
   });
-  const percentageDistanceDampening = isDistanceDampeningEnabled ? getDistanceDampening({
+  const percentageDistanceDampening = getDistanceDampening({
     client,
     edge,
     hitbox,
     axis,
     config
-  }) : 1;
+  });
 
   // Dampen speed by time
   const percentageThroughTimeDampening = getPercentageInRange({

package/dist/edytor.svelte.d.ts

@@ -18,6 +18,15 @@ import { Dispatcher } from './session/commands.js';
 import { type KindRow } from './kinds.js';
 export type EdytorOptions = {
     readonly?: boolean;
+    /**
+     * Let users nest blocks under other blocks (default `false`): Tab and
+     * Shift+Tab nest and unnest, a drop or a handle's Alt+→ may place a block
+     * inside another. Off, those gestures nest nothing and Tab is left to the
+     * browser (the focus moves on); containers (lists, toggles, callouts,
+     * columns) keep their bodies, and nested blocks already in the document
+     * still render and edit.
+     */
+    allowNesting?: boolean;
     /** Chords (`mod+s`, `shift+alt+enter`) the view binds before plugins and built-ins. */
     hotkeys?: Partial<Record<HotKeyCombination, HotKey>>;
     plugins?: Plugin[];
@@ -25,12 +34,9 @@ export type EdytorOptions = {
      * The assembled document this view renders — shared facade, history,
      * awareness and semantics live on it (see `crdt/document.ts`). When
      * injected the view borrows it: `destroy()` releases only view-owned
-     * resources. When absent the view internally owns a document built
-     * around `doc`/`awareness` (the legacy path — same behavior as before).
+     * resources. When absent the view owns a fresh one.
      */
     document?: EdytorDocument;
-    doc?: YDoc;
-    awareness?: Awareness;
     /** The local author of a view-owned document (with `document`, set it there). */
     actor?: DocumentActor;
     /** A view-owned document's `requireHydration` (with `document`, set it there). */
@@ -100,11 +106,13 @@ export declare class Edytor {
     /** What the components render: one cell per visible block, patched from change reports. */
     cells: Cells | undefined;
     /**
-     * The document's properties, read-your-writes and reactive. Write them
-     * with `edytor.patchData(null, patches)`. Type them by augmenting
-     * {@link EdytorDocData}.
+     * The document's properties, as plain state: reactive at any depth, and
+     * writable (`edytor.data.title = 'Notes'`, `edytor.data.tags.push('x')`,
+     * `delete edytor.data.draft`). Each write is the `patchData` operation,
+     * dispatched; the writes of one task are one undo step. Type them by
+     * augmenting {@link EdytorDocData}.
      */
-    get data(): Readonly<EdytorDocData>;
+    get data(): EdytorDocData;
     /** The chrome layer outside the host: handles, menus, remote carets. */
     readonly overlay: Overlay;
     /** The chrome popups open on this view (`surface/popups`): what the root's ARIA names. */
@@ -113,6 +121,8 @@ export declare class Edytor {
     readonly announcer: AnnouncerState;
     /** The words the view was given (`<Edytor labels>`); its plugins read their section through `labelsOf`. */
     readonly labels: PartialLabels;
+    /** Whether users may nest blocks (`allowNesting`, read once; the rule is `session/moves.ts` `nestsInto`). */
+    readonly allowNesting: boolean;
     private off;
     private onChange?;
     private onDocChange?;
@@ -208,7 +218,7 @@ export declare class Edytor {
      * discarded.
      *
      * Releases every listener the editor holds on potentially-SHARED objects
-     * — an injected doc/awareness outlives a single editor, so an
+     * — an injected document outlives a single editor, so an
      * undestroyed mount leaks a facade `update` listener and the undo
      * manager's doc observers forever.
      *