@aglyn/besigner 1.0.0-beta.143

package/src/lib/dnd-manager/droppable-region-utils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { DropRegion } from './dnd-manager';
+export type DroppableClientRect = Pick<DOMRect, 'width' | 'height' | 'top' | 'right' | 'bottom' | 'left'> & Partial<Pick<DOMRect, 'x' | 'y'>>;
+export declare function buildDroppableRects(rect: DroppableClientRect): {
+    children: {
+        width: number;
+        height: number;
+        top: number;
+        left: number;
+    };
+    top: {
+        width: number;
+        height: number;
+        top: number;
+        left: number;
+    };
+    right: {
+        width: number;
+        height: number;
+        top: number;
+        left: number;
+    };
+    bottom: {
+        width: number;
+        height: number;
+        top: number;
+        left: number;
+    };
+    left: {
+        width: number;
+        height: number;
+        top: number;
+        left: number;
+    };
+    full: {
+        x: number;
+        y: number;
+        left: number;
+        width: number;
+        top: number;
+        height: number;
+    };
+};
+export declare function withinRegion(rect: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, x: number, y: number): boolean;
+/**
+ * Before/after sibling region for a point over a leaf element, split on the
+ * element's dominant axis: wide elements divide left/right, tall ones divide
+ * top/bottom. Used when the target can't hold node children so its center
+ * never reads as a nest.
+ */
+export declare function determineSiblingRegion(rect: DroppableClientRect, x: number, y: number): DropRegion.TOP | DropRegion.RIGHT | DropRegion.BOTTOM | DropRegion.LEFT;
+export declare function determineDropRegion(clientRect: DroppableClientRect, x: number, y: number, acceptsChildren?: boolean, regions?: ReturnType<typeof buildDroppableRects>): DropRegion;

package/src/lib/dnd-manager/droppable-region-utils.js

@@ -0,0 +1,115 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { DropRegion } from "./dnd-manager.js";
+export function buildDroppableRects(rect) {
+    const { width = 0, height = 0, top = 0, right = 0, bottom = 0, left = 0, x = 0, y = 0 } = rect || {};
+    const isHorz = (width || 0) >= (height || 0);
+    const vertWRaw = width / 6;
+    const vertWidth = vertWRaw > 12 ? 12 : vertWRaw;
+    const vertHeight = height;
+    const horzHRaw = height / 4;
+    const horzWidth = width;
+    const horzHeight = horzHRaw > 12 ? 12 : horzHRaw;
+    const _top = {
+        width: horzWidth,
+        height: horzHeight,
+        top: top,
+        left: left
+    };
+    const _bottom = {
+        width: horzWidth,
+        height: horzHeight,
+        top: top + vertHeight - horzHeight,
+        left: left
+    };
+    const _left = {
+        width: vertWidth,
+        height: vertHeight,
+        top: top,
+        left: left
+    };
+    const _right = {
+        width: vertWidth,
+        height: vertHeight,
+        top: top,
+        left: left + horzWidth - vertWidth
+    };
+    const _children = {
+        width: _top.width - vertWidth * 2,
+        height: height - (_top.height + _bottom.height),
+        top: top + _top.height,
+        left: left + _left.width
+    };
+    const _full = {
+        x,
+        y,
+        left: _left.left,
+        width: _left.width + _children.width + _right.width,
+        top: _top.top,
+        height: _top.height + _children.height + _bottom.height
+    };
+    return {
+        children: _children,
+        top: _top,
+        right: _right,
+        bottom: _bottom,
+        left: _left,
+        full: _full
+    };
+}
+export function withinRegion(rect, x, y) {
+    const { left, top } = rect;
+    const { width, height } = rect;
+    const xis = x >= left && x <= left + width;
+    const yis = y >= top && y <= top + height;
+    return xis && yis;
+}
+/**
+ * Before/after sibling region for a point over a leaf element, split on the
+ * element's dominant axis: wide elements divide left/right, tall ones divide
+ * top/bottom. Used when the target can't hold node children so its center
+ * never reads as a nest.
+ */ export function determineSiblingRegion(rect, x, y) {
+    const { width = 0, height = 0, top = 0, left = 0 } = rect || {};
+    if (width >= height) {
+        return x < left + width / 2 ? DropRegion.LEFT : DropRegion.RIGHT;
+    }
+    return y < top + height / 2 ? DropRegion.TOP : DropRegion.BOTTOM;
+}
+export function determineDropRegion(clientRect, x, y, acceptsChildren = true, regions) {
+    const _regions = regions || buildDroppableRects(clientRect);
+    switch(true){
+        case withinRegion(_regions.top, x, y):
+            return DropRegion.TOP;
+        case withinRegion(_regions.right, x, y):
+            return DropRegion.RIGHT;
+        case withinRegion(_regions.bottom, x, y):
+            return DropRegion.BOTTOM;
+        case withinRegion(_regions.left, x, y):
+            return DropRegion.LEFT;
+        case !acceptsChildren:
+            // Leaf targets (self-closing / text-editable) have no children slot, so
+            // the center resolves to a sibling insert rather than a nest — keeping
+            // the drop indicator and the committed placement in agreement
+            // (AGL-575 parallel for drag-and-drop).
+            return determineSiblingRegion(clientRect, x, y);
+        case withinRegion(_regions.children, x, y):
+        default:
+            return DropRegion.CHILDREN;
+    }
+}
+
+//# sourceMappingURL=droppable-region-utils.js.map

package/src/lib/dnd-manager/droppable-region-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/dnd-manager/droppable-region-utils.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { DropRegion } from './dnd-manager'\n\n// Structural rect type: dnd-kit passes a ClientRect that lacks DOMRect's\n// x/y/toJSON, and x/y are defaulted below anyway.\nexport type DroppableClientRect = Pick<\n  DOMRect,\n  'width' | 'height' | 'top' | 'right' | 'bottom' | 'left'\n> &\n  Partial<Pick<DOMRect, 'x' | 'y'>>\n\nexport function buildDroppableRects(rect: DroppableClientRect) {\n  const {\n    width = 0,\n    height = 0,\n    top = 0,\n    right = 0,\n    bottom = 0,\n    left = 0,\n    x = 0,\n    y = 0,\n  } = rect || {}\n  const isHorz = (width || 0) >= (height || 0)\n\n  const vertWRaw = width / 6\n  const vertWidth = vertWRaw > 12 ? 12 : vertWRaw\n  const vertHeight = height\n\n  const horzHRaw = height / 4\n  const horzWidth = width\n  const horzHeight = horzHRaw > 12 ? 12 : horzHRaw\n\n  const _top = {\n    width: horzWidth,\n    height: horzHeight,\n    top: top,\n    left: left,\n  }\n  const _bottom = {\n    width: horzWidth,\n    height: horzHeight,\n    top: top + vertHeight - horzHeight,\n    left: left,\n  }\n  const _left = {\n    width: vertWidth,\n    height: vertHeight,\n    top: top,\n    left: left,\n  }\n  const _right = {\n    width: vertWidth,\n    height: vertHeight,\n    top: top,\n    left: left + horzWidth - vertWidth,\n  }\n  const _children = {\n    width: _top.width - vertWidth * 2,\n    height: height - (_top.height + _bottom.height),\n    top: top + _top.height,\n    left: left + _left.width,\n  }\n  const _full = {\n    x,\n    y,\n    left: _left.left,\n    width: _left.width + _children.width + _right.width,\n    top: _top.top,\n    height: _top.height + _children.height + _bottom.height,\n  }\n\n  return {\n    children: _children,\n    top: _top,\n    right: _right,\n    bottom: _bottom,\n    left: _left,\n    full: _full,\n  }\n}\n\nexport function withinRegion(rect: { left: number; top: number; width: number; height: number }, x: number, y: number) {\n  const { left, top } = rect\n  const { width, height } = rect\n  const xis = x >= left && x <= left + width\n  const yis = y >= top && y <= top + height\n  return xis && yis\n}\n\n/**\n * Before/after sibling region for a point over a leaf element, split on the\n * element's dominant axis: wide elements divide left/right, tall ones divide\n * top/bottom. Used when the target can't hold node children so its center\n * never reads as a nest.\n */\nexport function determineSiblingRegion(rect: DroppableClientRect, x: number, y: number) {\n  const { width = 0, height = 0, top = 0, left = 0 } = rect || {}\n  if (width >= height) {\n    return x < left + width / 2 ? DropRegion.LEFT : DropRegion.RIGHT\n  }\n  return y < top + height / 2 ? DropRegion.TOP : DropRegion.BOTTOM\n}\n\nexport function determineDropRegion(\n  clientRect: DroppableClientRect,\n  x: number,\n  y: number,\n  acceptsChildren = true,\n  regions?: ReturnType<typeof buildDroppableRects>,\n) {\n  const _regions = regions || buildDroppableRects(clientRect)\n  switch (true) {\n    case withinRegion(_regions.top, x, y):\n      return DropRegion.TOP\n    case withinRegion(_regions.right, x, y):\n      return DropRegion.RIGHT\n    case withinRegion(_regions.bottom, x, y):\n      return DropRegion.BOTTOM\n    case withinRegion(_regions.left, x, y):\n      return DropRegion.LEFT\n    case !acceptsChildren:\n      // Leaf targets (self-closing / text-editable) have no children slot, so\n      // the center resolves to a sibling insert rather than a nest — keeping\n      // the drop indicator and the committed placement in agreement\n      // (AGL-575 parallel for drag-and-drop).\n      return determineSiblingRegion(clientRect, x, y)\n    case withinRegion(_regions.children, x, y):\n    default:\n      return DropRegion.CHILDREN\n  }\n}\n"],"names":["DropRegion","buildDroppableRects","rect","width","height","top","right","bottom","left","x","y","isHorz","vertWRaw","vertWidth","vertHeight","horzHRaw","horzWidth","horzHeight","_top","_bottom","_left","_right","_children","_full","children","full","withinRegion","xis","yis","determineSiblingRegion","LEFT","RIGHT","TOP","BOTTOM","determineDropRegion","clientRect","acceptsChildren","regions","_regions","CHILDREN"],"mappings":"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"}

package/src/lib/dnd-manager/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { default } from './dnd-manager';
+export * from './dnd-manager';
+export * from './confirm-valid-lineal-relationship';
+export * from './droppable-region-utils';

package/src/lib/dnd-manager/index.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ export { default } from "./dnd-manager.js";
+export * from "./dnd-manager.js";
+export * from "./confirm-valid-lineal-relationship.js";
+export * from "./droppable-region-utils.js";
+
+//# sourceMappingURL=index.js.map

package/src/lib/dnd-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/dnd-manager/index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { default } from './dnd-manager'\nexport * from './dnd-manager'\n\nexport * from './confirm-valid-lineal-relationship'\nexport * from './droppable-region-utils'\n"],"names":["default"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,OAAO,QAAQ,mBAAe;AACvC,cAAc,mBAAe;AAE7B,cAAc,yCAAqC;AACnD,cAAc,8BAA0B"}

package/src/lib/focus-manager/focus-manager.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2024 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type * as Aglyn from '@aglyn/aglyn';
+export type HoveredNode = Aglyn.NodeSchema<any> | null;
+export type SelectedNodes = Aglyn.NodeSchema<any>[];
+export type ExpandedNodes = Aglyn.NodeSchema<any>[];
+export type LastSelectedNode = Aglyn.NodeSchema<any> | undefined;
+export declare function getLastSelected(): LastSelectedNode;
+export declare function selectionCount(): number;
+export declare function hasMultipleSelected(): boolean;
+export declare function getHovered(): HoveredNode | undefined;
+export declare function getSelected(): SelectedNodes;
+export declare function getAllExpanded(): ExpandedNodes & SelectedNodes;
+export declare function getManuallyCollapsed(): Aglyn.NodeId[];
+export declare function isNodeSelected(node: Aglyn.NodeSchema<any>): boolean;
+export declare function isNodeOrDescendantSelected(node: Aglyn.NodeSchema<any>): boolean;
+export declare function isNodeHovered(node: Aglyn.NodeSchema<any>): boolean;
+export declare function isNodeExpanded(node: Aglyn.NodeSchema<any>): boolean;
+export declare function isNodeEffectivelyExpanded(node: Aglyn.NodeSchema<any>): boolean;
+export declare function clearFocusStatus(): void;
+export declare function clearSelection(): void;
+export declare function clearHover(): void;
+export declare function expandNode(node: Aglyn.NodeSchema<any>): void;
+export declare function collapseNode(node: Aglyn.NodeSchema<any>): void;
+export declare function toggleNodeExpansion(node: Aglyn.NodeSchema<any>): void;
+/**
+ * What a click on a node means, in the hierarchy and on the canvas alike.
+ *
+ * Toggling belongs to Cmd/Ctrl-click — which is exactly what
+ * `multiSelection` means at both call sites, and what both of their comments
+ * already claimed. A PLAIN click always selects (AGL-2486): it used to
+ * toggle, so clicking the row of a node that was already selected DESELECTED
+ * it, and since the hierarchy's expansion is derived from the selection
+ * (`allExpanded`), the tree then collapsed to the document root and the row
+ * vanished from under the pointer. Every way of putting a new element on the
+ * canvas leaves it selected, so "add an element, then click it in the
+ * hierarchy" hit this every time.
+ */
+export declare function handleNodeSelection(node: Aglyn.NodeSchema<any>, multiSelection?: boolean): void;
+export declare function deselectNode(node: Aglyn.NodeSchema<any>, multiSelection?: boolean): void;
+export declare function setSelectedNode(node: Aglyn.NodeSchema<any>, multiSelection?: boolean): void;
+/**
+ * Where the selection should land once `nodes` are deleted, best first
+ * (AGL-2553).
+ *
+ * Deleting used to clear the selection outright, and the hierarchy collapsing
+ * was the consequence: the tree only holds a branch open to reveal what is
+ * selected, so with nothing selected a subtree the author had navigated into
+ * snapped shut on every delete.
+ *
+ * Order is next sibling, then previous, then the parent. NEXT first because
+ * it slides into the deleted node's slot — the highlight stays where the
+ * author's eye already is, rather than stepping backwards. Previous covers
+ * deleting the last child, and the parent covers an only child, where keeping
+ * the branch open one level up is still better than closing it.
+ *
+ * ⚑ Returns CANDIDATES rather than a node, because it must be called BEFORE
+ * the delete — sibling indices shift once it runs — and the caller selects the
+ * first that survives. That ordering is what makes multi-selection safe
+ * without walking ancestors: a sibling that was itself doomed, or that hung
+ * off a doomed node, is simply absent from the map afterwards and the next
+ * candidate wins.
+ */
+export declare function resolveSelectionAfterDeletion(nodes: readonly Aglyn.NodeSchema<any>[]): Aglyn.NodeSchema<any>[];
+/**
+ * Selects the first of `candidates` that still exists, or clears the
+ * selection when none do. The other half of
+ * {@link resolveSelectionAfterDeletion}; call it AFTER the delete.
+ */
+export declare function selectFirstSurviving(candidates: readonly Aglyn.NodeSchema<any>[]): void;
+/**
+ * Flat, depth-first list of the nodes currently visible in the hierarchy —
+ * children of collapsed nodes are skipped (AGL-6). Range selection resolves
+ * its slice against this order.
+ */
+export declare function getVisibleNodeOrder(): Aglyn.NodeSchema<any>[];
+/**
+ * Shift+Click range selection (AGL-7): selects every visible node between
+ * the current anchor (`lastSelected`) and the target, in document order.
+ * Without an anchor it falls back to single selection.
+ */
+export declare function rangeSelectNode(node: Aglyn.NodeSchema<any>): void;
+/**
+ * Cmd/Ctrl+A helper (AGL-7): selects every visible node at the same tree
+ * depth as the current selection anchor (siblings-and-cousins). No-ops
+ * without an anchor.
+ */
+export declare function selectAllAtDepth(): void;
+export declare function setHoveredNode(node: Aglyn.NodeSchema<any>): void;
+export declare function dehoverNode(node: Aglyn.NodeSchema<any>): void;