cx 24.9.3 → 24.10.0

package/src/widgets/drag-drop/DragSource.js

@@ -1,160 +1,160 @@
-import { Widget, VDOM } from "../../ui/Widget";
-import { Container } from "../../ui/Container";
-import { ddMouseDown, ddDetect, ddMouseUp, initiateDragDrop, isDragHandleEvent } from "./ops";
-import { preventFocus } from "../../ui/FocusManager";
-import { parseStyle } from "../../util/parseStyle";
-
-export class DragSource extends Container {
-   init() {
-      this.cloneStyle = parseStyle(this.cloneStyle);
-      this.draggedStyle = parseStyle(this.draggedStyle);
-      super.init();
-   }
-
-   declareData() {
-      super.declareData(...arguments, {
-         id: undefined,
-         data: { structured: true },
-         cloneStyle: { structured: true },
-         cloneClass: { structured: true },
-         draggedClass: { structured: true },
-         draggedStyle: { structured: true },
-      });
-   }
-
-   explore(context, instance) {
-      context.push("dragHandles", (instance.dragHandles = []));
-      super.explore(context, instance);
-   }
-
-   exploreCleanup(context, instance) {
-      context.pop("dragHandles");
-   }
-
-   render(context, instance, key) {
-      return (
-         <DragSourceComponent key={key} instance={instance} handled={this.handled || instance.dragHandles.length > 0}>
-            {this.renderChildren(context, instance)}
-         </DragSourceComponent>
-      );
-   }
-}
-
-DragSource.prototype.styled = true;
-DragSource.prototype.baseClass = "dragsource";
-DragSource.prototype.hideOnDrag = false;
-DragSource.prototype.handled = false;
-
-Widget.alias("dragsource", DragSource);
-
-class DragSourceComponent extends VDOM.Component {
-   constructor(props) {
-      super(props);
-      this.state = { dragged: false };
-      this.beginDragDrop = this.beginDragDrop.bind(this);
-      this.onMouseMove = this.onMouseMove.bind(this);
-      this.onMouseDown = this.onMouseDown.bind(this);
-      this.setRef = (el) => {
-         this.el = el;
-      };
-   }
-
-   render() {
-      let { instance, children, handled } = this.props;
-      let { data, widget } = instance;
-      let { CSS } = widget;
-
-      if (this.state.dragged && widget.hideOnDrag) return null;
-
-      let classes = [
-         data.classNames,
-         CSS.state({
-            dragged: this.state.dragged,
-            draggable: !handled,
-         }),
-      ];
-
-      let style = data.style;
-
-      if (this.state.dragged) {
-         if (data.draggedClass) classes.push(data.draggedClass);
-         if (data.draggedStyle)
-            style = {
-               ...style,
-               ...data.draggedStyle,
-            };
-      }
-
-      let eventHandlers = {
-         ...instance.getJsxEventProps(),
-         onTouchStart: this.onMouseDown,
-         onMouseDown: this.onMouseDown,
-         onTouchMove: this.onMouseMove,
-         onMouseMove: this.onMouseMove,
-         onTouchEnd: ddMouseUp,
-         onMouseUp: ddMouseUp,
-      };
-
-      delete eventHandlers.onDragStart;
-      delete eventHandlers.onDragEnd;
-
-      return (
-         <div id={data.id} ref={this.setRef} className={CSS.expand(classes)} style={style} {...eventHandlers}>
-            {children}
-         </div>
-      );
-   }
-
-   onMouseDown(e) {
-      ddMouseDown(e);
-      if (isDragHandleEvent(e) || !this.props.handled) {
-         preventFocus(e); //disables text selection in Firefox
-         e.stopPropagation();
-      }
-   }
-
-   onMouseMove(e) {
-      if (ddDetect(e)) {
-         if (isDragHandleEvent(e) || !this.props.handled) {
-            this.beginDragDrop(e);
-         }
-      }
-   }
-
-   beginDragDrop(e) {
-      let { instance } = this.props;
-      let { data, widget, store } = instance;
-
-      if (widget.onDragStart && instance.invoke("onDragStart", e, instance) === false) return;
-
-      initiateDragDrop(
-         e,
-         {
-            sourceEl: this.el,
-            source: {
-               store: store,
-               data: data.data,
-            },
-            clone: {
-               widget: widget.clone || widget,
-               store,
-               class: data.cloneClass,
-               style: data.cloneStyle,
-               cloneContent: !widget.clone,
-               matchSize: !widget.clone,
-               matchCursorOffset: !widget.clone,
-            },
-         },
-         (e) => {
-            this.setState({
-               dragged: false,
-            });
-            if (widget.onDragEnd) instance.invoke("onDragEnd", e, instance);
-         }
-      );
-
-      this.setState({
-         dragged: true,
-      });
-   }
-}
+import { Widget, VDOM } from "../../ui/Widget";
+import { Container } from "../../ui/Container";
+import { ddMouseDown, ddDetect, ddMouseUp, initiateDragDrop, isDragHandleEvent } from "./ops";
+import { preventFocus } from "../../ui/FocusManager";
+import { parseStyle } from "../../util/parseStyle";
+
+export class DragSource extends Container {
+   init() {
+      this.cloneStyle = parseStyle(this.cloneStyle);
+      this.draggedStyle = parseStyle(this.draggedStyle);
+      super.init();
+   }
+
+   declareData() {
+      super.declareData(...arguments, {
+         id: undefined,
+         data: { structured: true },
+         cloneStyle: { structured: true },
+         cloneClass: { structured: true },
+         draggedClass: { structured: true },
+         draggedStyle: { structured: true },
+      });
+   }
+
+   explore(context, instance) {
+      context.push("dragHandles", (instance.dragHandles = []));
+      super.explore(context, instance);
+   }
+
+   exploreCleanup(context, instance) {
+      context.pop("dragHandles");
+   }
+
+   render(context, instance, key) {
+      return (
+         <DragSourceComponent key={key} instance={instance} handled={this.handled || instance.dragHandles.length > 0}>
+            {this.renderChildren(context, instance)}
+         </DragSourceComponent>
+      );
+   }
+}
+
+DragSource.prototype.styled = true;
+DragSource.prototype.baseClass = "dragsource";
+DragSource.prototype.hideOnDrag = false;
+DragSource.prototype.handled = false;
+
+Widget.alias("dragsource", DragSource);
+
+class DragSourceComponent extends VDOM.Component {
+   constructor(props) {
+      super(props);
+      this.state = { dragged: false };
+      this.beginDragDrop = this.beginDragDrop.bind(this);
+      this.onMouseMove = this.onMouseMove.bind(this);
+      this.onMouseDown = this.onMouseDown.bind(this);
+      this.setRef = (el) => {
+         this.el = el;
+      };
+   }
+
+   render() {
+      let { instance, children, handled } = this.props;
+      let { data, widget } = instance;
+      let { CSS } = widget;
+
+      if (this.state.dragged && widget.hideOnDrag) return null;
+
+      let classes = [
+         data.classNames,
+         CSS.state({
+            dragged: this.state.dragged,
+            draggable: !handled,
+         }),
+      ];
+
+      let style = data.style;
+
+      if (this.state.dragged) {
+         if (data.draggedClass) classes.push(data.draggedClass);
+         if (data.draggedStyle)
+            style = {
+               ...style,
+               ...data.draggedStyle,
+            };
+      }
+
+      let eventHandlers = {
+         ...instance.getJsxEventProps(),
+         onTouchStart: this.onMouseDown,
+         onMouseDown: this.onMouseDown,
+         onTouchMove: this.onMouseMove,
+         onMouseMove: this.onMouseMove,
+         onTouchEnd: ddMouseUp,
+         onMouseUp: ddMouseUp,
+      };
+
+      delete eventHandlers.onDragStart;
+      delete eventHandlers.onDragEnd;
+
+      return (
+         <div id={data.id} ref={this.setRef} className={CSS.expand(classes)} style={style} {...eventHandlers}>
+            {children}
+         </div>
+      );
+   }
+
+   onMouseDown(e) {
+      ddMouseDown(e);
+      if (isDragHandleEvent(e) || !this.props.handled) {
+         preventFocus(e); //disables text selection in Firefox
+         e.stopPropagation();
+      }
+   }
+
+   onMouseMove(e) {
+      if (ddDetect(e)) {
+         if (isDragHandleEvent(e) || !this.props.handled) {
+            this.beginDragDrop(e);
+         }
+      }
+   }
+
+   beginDragDrop(e) {
+      let { instance } = this.props;
+      let { data, widget, store } = instance;
+
+      if (widget.onDragStart && instance.invoke("onDragStart", e, instance) === false) return;
+
+      initiateDragDrop(
+         e,
+         {
+            sourceEl: this.el,
+            source: {
+               store: store,
+               data: data.data,
+            },
+            clone: {
+               widget: widget.clone || widget,
+               store,
+               class: data.cloneClass,
+               style: data.cloneStyle,
+               cloneContent: !widget.clone,
+               matchSize: !widget.clone,
+               matchCursorOffset: !widget.clone,
+            },
+         },
+         (e) => {
+            this.setState({
+               dragged: false,
+            });
+            if (widget.onDragEnd) instance.invoke("onDragEnd", e, instance);
+         }
+      );
+
+      this.setState({
+         dragged: true,
+      });
+   }
+}

package/src/widgets/drag-drop/DragSource.scss

@@ -1,25 +1,25 @@
-@mixin cx-dragsource(
-   $name: 'dragsource',
-   $besm: $cx-besm
-) {
-   $block: map-get($besm, block);
-   $element: map-get($besm, element);
-   $state: map-get($besm, state);
-   $mod: map-get($besm, mod);
-
-   .#{$block}#{$name} {
-      box-sizing: border-box;
-
-      &.#{$state}dragged {
-         opacity: 0.3;
-      }
-
-      &.#{$state}draggable {
-         touch-action: none;
-      }
-   }
-}
-
-@if (cx-should-include('cx/widgets/DragSource')) {
-   @include cx-dragsource();
+@mixin cx-dragsource(
+   $name: 'dragsource',
+   $besm: $cx-besm
+) {
+   $block: map-get($besm, block);
+   $element: map-get($besm, element);
+   $state: map-get($besm, state);
+   $mod: map-get($besm, mod);
+
+   .#{$block}#{$name} {
+      box-sizing: border-box;
+
+      &.#{$state}dragged {
+         opacity: 0.3;
+      }
+
+      &.#{$state}draggable {
+         touch-action: none;
+      }
+   }
+}
+
+@if (cx-should-include('cx/widgets/DragSource')) {
+   @include cx-dragsource();
 }

package/src/widgets/drag-drop/DropZone.d.ts

@@ -1,98 +1,98 @@
-import * as Cx from "../../core";
-
-import { Instance } from "../../ui/Instance";
-import { DragEvent } from "./ops";
-
-interface DropZoneProps extends Cx.StyledContainerProps {
-   /** CSS styles to be applied when drag cursor is over the drop zone. */
-   overStyle?: Cx.StyleProp;
-
-   /** CSS styles to be applied when drag cursor is near the drop zone. */
-   nearStyle?: Cx.StyleProp;
-
-   /** CSS styles to be applied when drag operations begin used to highlight drop zones. */
-   farStyle?: Cx.StyleProp;
-
-   /** Additional CSS class to be applied when drag cursor is over the drop zone. */
-   overClass?: Cx.ClassProp;
-
-   /** Additional CSS class to be applied when drag cursor is near the drop zone. */
-   nearClass?: Cx.ClassProp;
-
-   /** Additional CSS class to be applied when drag operations begin used to highlight drop zones. */
-   farClass?: Cx.ClassProp;
-
-   /** Distance in `px` used to determine if cursor is near the dropzone. If not configured, cursor is never considered near. */
-   nearDistance?: number;
-
-   /** Bindable data related to the DropZone that might be useful inside onDrop operations. */
-   data?: Cx.StructuredProp;
-
-   /**
-    * Inflate the drop zone's bounding box so it activates on cursor proximity.
-    * Useful for invisible drop-zones that are only a few pixels tall/wide.
-    */
-   inflate?: number;
-
-   /**
-    * Inflate the drop zone's bounding box horizontally so it activates on cursor proximity.
-    * Useful for invisible drop-zones that are only a few pixels tall/wide.
-    */
-   hinflate?: number;
-
-   /**
-    * Inflate the drop zone's bounding box vertically so it activates on cursor proximity.
-    * Useful for invisible drop-zones that are only a few pixels tall/wide.
-    */
-   vinflate?: number;
-
-   /** Base CSS class to be applied to the element. Defaults to 'dropzone'. */
-   baseClass?: string;
-
-   /** A callback method invoked when dragged item is finally dropped.
-    The callback takes two arguments:
-    * dragDropEvent - An object containing information related to the source
-    * instance
-    Return value is written into dragDropEvent.result and can be passed
-    to the source's onDragEnd callback. */
-   onDrop?: string | ((event?: DragEvent, instance?: Instance) => any);
-
-   /** A callback method used to test if dragged item (source) is compatible
-    with the drop zone. */
-   onDropTest?: string | ((event?: DragEvent, instance?: Instance) => boolean);
-
-   /** A callback method invoked when the dragged item gets close to the drop zone.
-    See also `nearDistance`. */
-   onDragNear?: string | ((event?: DragEvent, instance?: Instance) => void);
-
-   /** A callback method invoked when the dragged item is dragged away. */
-   onDragAway?: string | ((event?: DragEvent, instance?: Instance) => void);
-
-   /** A callback method invoked when the dragged item is dragged over the drop zone.
-    The callback is called for each `mousemove` or `touchmove` event. */
-   onDragOver?: string | ((event?: DragEvent, instance?: Instance) => void);
-
-   /** A callback method invoked when the dragged item is dragged over the drop zone
-    for the first time. */
-   onDragEnter?: string | ((event?: DragEvent, instance?: Instance) => void);
-
-   /** A callback method invoked when the dragged item leaves the drop zone area. */
-   onDragLeave?: string | ((event?: DragEvent, instance?: Instance) => void);
-
-   /** A callback method invoked when at the beginning of the drag & drop operation. */
-   onDragStart?: string | ((event?: DragEvent, instance?: Instance) => void);
-
-   /** A callback method invoked when at the end of the drag & drop operation. */
-   onDragEnd?: string | ((event?: DragEvent, instance?: Instance) => void);
-
-   /** Match height of the item being dragged */
-   matchHeight?: boolean;
-
-   /** Match width of the item being dragged */
-   matchWidth?: boolean;
-
-   /** Match margin of the item being dragged */
-   matchMargin?: boolean;
-}
-
-export class DropZone extends Cx.Widget<DropZoneProps> {}
+import * as Cx from "../../core";
+
+import { Instance } from "../../ui/Instance";
+import { DragEvent } from "./ops";
+
+interface DropZoneProps extends Cx.StyledContainerProps {
+   /** CSS styles to be applied when drag cursor is over the drop zone. */
+   overStyle?: Cx.StyleProp;
+
+   /** CSS styles to be applied when drag cursor is near the drop zone. */
+   nearStyle?: Cx.StyleProp;
+
+   /** CSS styles to be applied when drag operations begin used to highlight drop zones. */
+   farStyle?: Cx.StyleProp;
+
+   /** Additional CSS class to be applied when drag cursor is over the drop zone. */
+   overClass?: Cx.ClassProp;
+
+   /** Additional CSS class to be applied when drag cursor is near the drop zone. */
+   nearClass?: Cx.ClassProp;
+
+   /** Additional CSS class to be applied when drag operations begin used to highlight drop zones. */
+   farClass?: Cx.ClassProp;
+
+   /** Distance in `px` used to determine if cursor is near the dropzone. If not configured, cursor is never considered near. */
+   nearDistance?: number;
+
+   /** Bindable data related to the DropZone that might be useful inside onDrop operations. */
+   data?: Cx.StructuredProp;
+
+   /**
+    * Inflate the drop zone's bounding box so it activates on cursor proximity.
+    * Useful for invisible drop-zones that are only a few pixels tall/wide.
+    */
+   inflate?: number;
+
+   /**
+    * Inflate the drop zone's bounding box horizontally so it activates on cursor proximity.
+    * Useful for invisible drop-zones that are only a few pixels tall/wide.
+    */
+   hinflate?: number;
+
+   /**
+    * Inflate the drop zone's bounding box vertically so it activates on cursor proximity.
+    * Useful for invisible drop-zones that are only a few pixels tall/wide.
+    */
+   vinflate?: number;
+
+   /** Base CSS class to be applied to the element. Defaults to 'dropzone'. */
+   baseClass?: string;
+
+   /** A callback method invoked when dragged item is finally dropped.
+    The callback takes two arguments:
+    * dragDropEvent - An object containing information related to the source
+    * instance
+    Return value is written into dragDropEvent.result and can be passed
+    to the source's onDragEnd callback. */
+   onDrop?: string | ((event?: DragEvent, instance?: Instance) => any);
+
+   /** A callback method used to test if dragged item (source) is compatible
+    with the drop zone. */
+   onDropTest?: string | ((event?: DragEvent, instance?: Instance) => boolean);
+
+   /** A callback method invoked when the dragged item gets close to the drop zone.
+    See also `nearDistance`. */
+   onDragNear?: string | ((event?: DragEvent, instance?: Instance) => void);
+
+   /** A callback method invoked when the dragged item is dragged away. */
+   onDragAway?: string | ((event?: DragEvent, instance?: Instance) => void);
+
+   /** A callback method invoked when the dragged item is dragged over the drop zone.
+    The callback is called for each `mousemove` or `touchmove` event. */
+   onDragOver?: string | ((event?: DragEvent, instance?: Instance) => void);
+
+   /** A callback method invoked when the dragged item is dragged over the drop zone
+    for the first time. */
+   onDragEnter?: string | ((event?: DragEvent, instance?: Instance) => void);
+
+   /** A callback method invoked when the dragged item leaves the drop zone area. */
+   onDragLeave?: string | ((event?: DragEvent, instance?: Instance) => void);
+
+   /** A callback method invoked when at the beginning of the drag & drop operation. */
+   onDragStart?: string | ((event?: DragEvent, instance?: Instance) => void);
+
+   /** A callback method invoked when at the end of the drag & drop operation. */
+   onDragEnd?: string | ((event?: DragEvent, instance?: Instance) => void);
+
+   /** Match height of the item being dragged */
+   matchHeight?: boolean;
+
+   /** Match width of the item being dragged */
+   matchWidth?: boolean;
+
+   /** Match margin of the item being dragged */
+   matchMargin?: boolean;
+}
+
+export class DropZone extends Cx.Widget<DropZoneProps> {}