@threadlabs/looma 0.23.25 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadlabs/looma",
-  "version": "0.23.25",
+  "version": "0.24.0",
   "type": "module",
   "description": "Looma components as HTML, Vue, and plain DOM, with design tokens.",
   "license": "MIT",

package/vue/editor/LoomaEditor.d.ts

@@ -1,5 +1,5 @@
 import "./looma-editor.css";
-import type { AnyExtension, Editor, JSONContent } from "@tiptap/core";
+import { type AnyExtension, type Editor, type JSONContent } from "@tiptap/core";
 import { type PropType, type VNode } from "vue";
 import { type LoomaSlashCommand, type LoomaMentionItem, type LoomaMentionProvider, type LoomaCodeLanguages } from "@threadlabs/looma/editor";
 import { type LoomaImageActivationDetail, type LoomaImageAttributeResolver, type LoomaImageDescriptor, type LoomaImageRenditionErrorDetail } from "./image-delivery.js";
@@ -23,8 +23,9 @@ export type LoomaImageUploader = (file: File) => Promise<string | LoomaImageUplo
 /**
  * Chooses whether formatting controls follow a selection, occupy persistent
  * editor chrome, or open from an app-owned button (`popover`, with a text-only
- * bubble for selections). `contextual` exposes all commands at a focused caret
- * as well as a selection; it does not alter document commands or stored content.
+ * bubble for selections). Floating tools open on text selection or a held press
+ * and dismiss on Escape/caret movement. `contextual` includes the full command
+ * set. Narrow viewports retain a dock; document commands/content are unchanged.
  */
 export type LoomaEditorToolbarMode = "bubble" | "sticky" | "popover" | "contextual";
 /**

package/vue/editor/index.js

@@ -1,11 +1,11 @@
 import { computed, createApp, defineComponent, h, nextTick, onBeforeUnmount, onMounted, reactive, ref, shallowRef, useId, watch } from "vue";
-import { DEFAULT_MENTION_RESULT_LIMIT, LOOMA_CHIP_COLORS, LOOMA_ICONS, createLoomaMentionExtension, createLoomaSlashCommandExtension, getActiveTableUiState, getDefaultEditorExtensions, getDefaultSlashCommands, getTableOfContentsEntries, getVisualViewportRect, handleTableAction, handleTableOverlayAction, measureTableOverlayGeometry, normalizeActiveTableColumnWidths, normalizeLoomaChipColor, normalizeTableOfContentsConfig, resolveTableCellAt, shouldShowTextFormattingToolbar, siteRelativeHref } from "@threadlabs/looma/editor";
+import { DEFAULT_MENTION_RESULT_LIMIT, LOOMA_CHIP_COLORS, LOOMA_ICONS, createLoomaMentionExtension, createLoomaSlashCommandExtension, getActiveTableUiState, getDefaultEditorExtensions, getDefaultSlashCommands, getTableOfContentsEntries, getVisualViewportRect, handleTableAction, handleTableOverlayAction, measureTableOverlayGeometry, normalizeActiveTableColumnWidths, normalizeLoomaChipColor, normalizeTableOfContentsConfig, resolveTableCellAt, siteRelativeHref } from "@threadlabs/looma/editor";
 import { Button, Card, Checkbox, Cluster, Combobox, Disclosure, EditorInsertTableGrid, EditorMentionMenu, EditorMentionMenuItem, EditorSlashMenu, EditorSlashMenuGroup, EditorSlashMenuItem, EditorTableContextMenu, EditorTableOverlay, EditorTableToolbar, EditorToolbar, EditorToolbar as EditorToolbar$1, FormField, Icon, IconButton, Image, Input, InputGroup, List, Menu, MenuItem, Popover, ScrollArea, SearchResultRow, Separator, Stack, Text, Tooltip } from "@threadlabs/looma/vue";
+import { Extension, Node as Node$1, getText, getTextSerializersFromSchema, mergeAttributes, nodeInputRule, posToDOMRect } from "@tiptap/core";
 import { BubbleMenu, EditorContent, useEditor } from "@tiptap/vue-3";
 import { closeHistory } from "@tiptap/pm/history";
 import { createLowlight } from "lowlight";
 import { NodeSelection, Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
-import { Extension, Node as Node$1, getText, getTextSerializersFromSchema, mergeAttributes, nodeInputRule } from "@tiptap/core";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
 import { DOMParser, DOMSerializer, Fragment as Fragment$1 } from "@tiptap/pm/model";
 export * from "@threadlabs/looma/editor";
@@ -1795,6 +1795,21 @@ var LoomaEditor = defineComponent({
 		const mobileToolbarStyle = ref({});
 		const mobile = ref(typeof window !== "undefined" && window.innerWidth <= 767);
 		const editorFocused = ref(false);
+		let dismissedFormattingSelection = null;
+		let heldFormattingSelection = null;
+		let formattingPopup = null;
+		let heldPressTimer;
+		let heldPress = null;
+		const floatingFormattingMode = () => props.toolbarMode !== "sticky" && !(props.toolbarMode === "popover" && props.toolbarOpen) && !mobile.value;
+		const cancelHeldPress = () => {
+			clearTimeout(heldPressTimer);
+			heldPressTimer = void 0;
+			heldPress = null;
+		};
+		const formattingSelectionActive = (instance) => {
+			const selection = instance.state.selection;
+			return selection instanceof TextSelection && !dismissedFormattingSelection?.eq(selection) && (!selection.empty || Boolean(heldFormattingSelection?.eq(selection)));
+		};
 		const editorStateVersion = ref(0);
 		const mobileToolbarMode = ref("formatting");
 		let dragLeaveTimer = null;
@@ -1995,6 +2010,12 @@ var LoomaEditor = defineComponent({
 			onFocus: ({ editor: instance }) => rememberSelection(instance),
 			onSelectionUpdate: ({ editor: instance }) => {
 				rememberSelection(instance);
+				if (floatingFormattingMode()) {
+					const selection = instance.state.selection;
+					if (!dismissedFormattingSelection?.eq(selection)) dismissedFormattingSelection = null;
+					if (!heldFormattingSelection?.eq(selection)) heldFormattingSelection = null;
+					if (!formattingSelectionActive(instance)) formattingPopup?.hide();
+				}
 				if (linkContextEditing.value && instance.state.selection.from !== linkSelection?.from) linkContextEditing.value = false;
 			},
 			onTransaction: () => {
@@ -2442,7 +2463,10 @@ var LoomaEditor = defineComponent({
 			editor.value?.commands.dismissLoomaSlashMenu();
 		});
 		watch(() => props.editable, (editable) => {
+			cancelHeldPress();
+			heldFormattingSelection = null;
 			editor.value?.setEditable(editable);
+			if (!editable) formattingPopup?.hide();
 			if (editor.value) imageDelivery.reset(editor.value);
 			root.value?.querySelectorAll("[data-looma-chip]").forEach((chip) => {
 				chip.setAttribute("aria-disabled", String(!editable));
@@ -2638,10 +2662,12 @@ var LoomaEditor = defineComponent({
 			updateMobileViewport();
 		};
 		const onEditorBlur = () => {
+			cancelHeldPress();
 			queueMicrotask(updateTableUi);
 			updateCodeUi();
 			setTimeout(() => {
 				if (!tableInteractionActive && !editor.value?.isFocused) editorFocused.value = false;
+				if (!editor.value?.isFocused && !formattingPopup?.popper.contains(document.activeElement)) heldFormattingSelection = null;
 			}, 0);
 		};
 		const bindEditorUi = (instance) => {
@@ -2667,9 +2693,13 @@ var LoomaEditor = defineComponent({
 		}, { immediate: true });
 		const onViewportChange = (event) => {
 			if (event?.type === "scroll" && event.target instanceof Node && (tableToolbarShell.value?.contains(event.target) || tableMenuShell.value?.contains(event.target))) return;
+			cancelHeldPress();
+			const wasMobile = mobile.value;
 			updateMobileViewport();
+			if (wasMobile !== mobile.value) heldFormattingSelection = null;
 			updateTableUi();
 			updateCodeUi();
+			if (floatingFormattingMode() && editor.value && !formattingSelectionActive(editor.value)) formattingPopup?.hide();
 			tableUi.menuOpen = false;
 		};
 		const onDocumentPointerDown = (event) => {
@@ -2682,6 +2712,40 @@ var LoomaEditor = defineComponent({
 			}, 0);
 			if ((tableUi.toolbarOpen || tableUi.overlayOpen || tableUi.menuOpen) && !inElement(root.value) && !inTableUi) closeTableUi();
 		};
+		const onFormattingPointerDown = (event) => {
+			cancelHeldPress();
+			const instance = editor.value;
+			if (!floatingFormattingMode() || tableResizeActive || !props.editable || !instance || event.button !== 0 || !event.isPrimary || !(event.target instanceof Element) || !instance.view.dom.contains(event.target) || event.target.closest("button, input, select, textarea, [data-looma-image-node]")) return;
+			heldPress = {
+				id: event.pointerId,
+				x: event.clientX,
+				y: event.clientY
+			};
+			heldPressTimer = setTimeout(() => {
+				heldPressTimer = void 0;
+				const selection = instance.state.selection;
+				if (!heldPress || !floatingFormattingMode() || tableResizeActive || !props.editable || !instance.isFocused || slash.active || mention.active || !(selection instanceof TextSelection)) return;
+				dismissedFormattingSelection = null;
+				heldFormattingSelection = selection;
+				formattingPopup?.setProps({ getReferenceClientRect: () => posToDOMRect(instance.view, selection.from, selection.to) });
+				formattingPopup?.show();
+			}, 500);
+		};
+		const onFormattingPointerMove = (event) => {
+			if (heldPress?.id === event.pointerId && Math.hypot(event.clientX - heldPress.x, event.clientY - heldPress.y) > 8) cancelHeldPress();
+		};
+		const onFormattingPointerEnd = (event) => {
+			if (heldPress?.id === event.pointerId) cancelHeldPress();
+		};
+		const onFormattingKeyDown = (event) => {
+			cancelHeldPress();
+			if (event.key !== "Escape" || !floatingFormattingMode() || !(event.target instanceof Node) || !(root.value?.contains(event.target) || formattingPopup?.popper.contains(event.target))) return;
+			const selection = editor.value?.state.selection;
+			dismissedFormattingSelection = selection instanceof TextSelection ? selection : null;
+			heldFormattingSelection = null;
+			formattingPopup?.hide();
+			hideTool();
+		};
 		const onResizePointerDown = (event) => {
 			tableResizeActive = event.target instanceof HTMLElement && event.target.classList.contains("column-resize-handle");
 		};
@@ -2770,6 +2834,11 @@ var LoomaEditor = defineComponent({
 			window.visualViewport?.addEventListener("resize", onViewportChange);
 			window.visualViewport?.addEventListener("scroll", onViewportChange);
 			document.addEventListener("pointerdown", onDocumentPointerDown, true);
+			document.addEventListener("pointerdown", onFormattingPointerDown);
+			document.addEventListener("pointermove", onFormattingPointerMove);
+			document.addEventListener("pointerup", onFormattingPointerEnd);
+			document.addEventListener("pointercancel", onFormattingPointerEnd);
+			document.addEventListener("keydown", onFormattingKeyDown);
 			document.addEventListener("pointerdown", onResizePointerDown, true);
 			document.addEventListener("pointerup", onResizePointerUp, true);
 			root.value?.addEventListener("error", onImageError, true);
@@ -2779,7 +2848,14 @@ var LoomaEditor = defineComponent({
 			window.removeEventListener("scroll", onViewportChange, true);
 			window.visualViewport?.removeEventListener("resize", onViewportChange);
 			window.visualViewport?.removeEventListener("scroll", onViewportChange);
+			cancelHeldPress();
+			formattingPopup = null;
 			document.removeEventListener("pointerdown", onDocumentPointerDown, true);
+			document.removeEventListener("pointerdown", onFormattingPointerDown);
+			document.removeEventListener("pointermove", onFormattingPointerMove);
+			document.removeEventListener("pointerup", onFormattingPointerEnd);
+			document.removeEventListener("pointercancel", onFormattingPointerEnd);
+			document.removeEventListener("keydown", onFormattingKeyDown);
 			document.removeEventListener("pointerdown", onResizePointerDown, true);
 			document.removeEventListener("pointerup", onResizePointerUp, true);
 			root.value?.removeEventListener("error", onImageError, true);
@@ -3131,8 +3207,15 @@ var LoomaEditor = defineComponent({
 				instance && props.editable && !mobile.value && (props.toolbarMode === "bubble" || props.toolbarMode === "popover" || props.toolbarMode === "contextual") ? h(BubbleMenu, {
 					editor: instance,
 					pluginKey: "looma-text-formatting-menu",
-					shouldShow: ({ editor: menuEditor, from, to }) => (props.toolbarMode !== "popover" || !props.toolbarOpen) && (props.toolbarMode === "contextual" ? !slash.active && !mention.active && (menuEditor.isFocused || linkContextEditing.value) : shouldShowTextFormattingToolbar(menuEditor, from, to)),
+					updateDelay: 0,
+					shouldShow: ({ editor: menuEditor }) => (props.toolbarMode !== "popover" || !props.toolbarOpen) && !slash.active && !mention.active && (menuEditor.isFocused || linkContextEditing.value) && formattingSelectionActive(menuEditor),
 					tippyOptions: {
+						onCreate: (popup) => {
+							formattingPopup = popup;
+						},
+						onDestroy: () => {
+							formattingPopup = null;
+						},
 						appendTo: () => root.value?.closest("dialog[open], [popover]") ?? document.body,
 						onShow: () => announceOverlayOpen(root.value?.ownerDocument ?? document, root.value),
 						duration: 100,