@globalbrain/sefirot 4.59.1 → 4.61.0

package/lib/support/Dom.ts

@@ -17,6 +17,75 @@ export function isTextLikeInput(target: EventTarget | null): boolean {
   return ['text', 'search', 'url', 'email', 'tel', 'password', 'number'].includes(type)
 }
 
+export type EditorSubmitShortcut = 'enter' | 'command-enter' | 'control-enter'
+
+/**
+ * The user-facing shortcut to show for the currently focused editor control.
+ * Plain Enter is truthful only for simple text-like inputs; other controls need
+ * the platform's primary modifier to avoid clashing with their own Enter key
+ * behavior. A text input nested inside a dropdown (its search filter, see
+ * `SDropdownSectionFilter` / `SInputAsyncDropdown`) keeps Enter to itself
+ * too, so only the modifier gesture reaches the editor from there.
+ */
+export function editorSubmitShortcutForTarget(
+  target: EventTarget | null,
+  platform = currentPlatform()
+): EditorSubmitShortcut {
+  if (
+    isTextLikeInput(target)
+    && !(target as HTMLElement).closest('.SDropdown, .SInputAsyncDropdown')
+  ) {
+    return 'enter'
+  }
+
+  return hasCommandShortcutModifier(platform) ? 'command-enter' : 'control-enter'
+}
+
+const commandShortcutPlatforms = new Set([
+  'ios',
+  'ipados',
+  'macos',
+
+  // `navigator.platform` fallback values.
+  'ipad',
+  'iphone',
+  'macintel'
+])
+
+function hasCommandShortcutModifier(platform: string): boolean {
+  return commandShortcutPlatforms.has(platform.toLowerCase())
+}
+
+function currentPlatform(): string {
+  if (typeof navigator === 'undefined') {
+    return ''
+  }
+
+  const nav = navigator as Navigator & { userAgentData?: { platform?: string } }
+
+  return nav.userAgentData?.platform ?? nav.platform ?? ''
+}
+
+/**
+ * Keydown handler for a text input nested inside a dropdown-like control (a
+ * search filter): Enter operates the control, not an enclosing inline editor,
+ * so it is stopped — with its default prevented — unless it carries the
+ * universal submit modifier (Cmd/Ctrl, see {@link isEditorSubmitKeydown}).
+ * Shift/Alt+Enter are contained too: the editor's submit predicate would read
+ * them off a text-like input as a plain submitting Enter. The Enter that
+ * commits an IME composition belongs to the IME — swallowing its default would
+ * drop the composed text — so it passes untouched (the editor ignores it).
+ */
+export function stopNonSubmitEnterKeydown(event: KeyboardEvent): void {
+  if (event.isComposing) {
+    return
+  }
+  if (event.key === 'Enter' && !event.metaKey && !event.ctrlKey) {
+    event.stopPropagation()
+    event.preventDefault()
+  }
+}
+
 /**
  * Whether an Enter keydown should submit an inline editor. Ctrl/Cmd+Enter
  * submits from any control — it's the near-universal "submit" gesture (GitHub,
@@ -65,8 +134,9 @@ export function isEditorCancelKeydown(event: KeyboardEvent): boolean {
  * throw on `formInputComponent()` (not yet editable). When making one editable,
  * if its input is a composite control with its own nested text input (e.g. a
  * dropdown's search filter), that nested input must keep Enter/Escape from
- * bubbling to this handler — see `SDropdownSectionFilter` — otherwise typing a
- * value and pressing Enter would submit/cancel the whole editor.
+ * bubbling to this handler — {@link stopNonSubmitEnterKeydown} is the Enter
+ * half; see `SDropdownSectionFilter` — otherwise typing a value and pressing
+ * Enter would submit/cancel the whole editor.
  */
 export function dispatchEditorKeydown(
   event: KeyboardEvent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@globalbrain/sefirot",
-  "version": "4.59.1",
+  "version": "4.61.0",
   "description": "Vue Components for Global Brain Design System.",
   "keywords": [
     "components",
@@ -56,11 +56,12 @@
     "release": "npm whoami >/dev/null 2>&1 || npm login && release-it"
   },
   "dependencies": {
+    "@iconify-json/lucide": "^1.2.116",
     "@iconify-json/ph": "^1.2.2",
     "@iconify-json/ri": "^1.2.10",
     "@popperjs/core": "^2.11.8",
-    "@sentry/browser": "^10.62.0",
-    "@sentry/vue": "^10.62.0",
+    "@sentry/browser": "^10.63.0",
+    "@sentry/vue": "^10.63.0",
     "@tanstack/vue-virtual": "3.0.0-beta.62",
     "@tinyhttp/content-disposition": "^2.2.4",
     "@tinyhttp/cookie": "^2.1.1",
@@ -84,11 +85,11 @@
     "jsdom": "^29.1.1",
     "lodash-es": "^4.18.1",
     "magic-string": "^0.30.21",
-    "markdown-it": "^14.2.0",
+    "markdown-it": "^14.3.0",
     "normalize.css": "^8.0.1",
     "ofetch": "^1.5.1",
     "pinia": "^3.0.4",
-    "postcss": "^8.5.15",
+    "postcss": "^8.5.16",
     "postcss-nested": "^7.0.2",
     "punycode": "^2.3.1",
     "qs": "^6.15.3",
@@ -104,8 +105,8 @@
     "@histoire/plugin-vue": "1.0.0-beta.1",
     "@release-it/conventional-changelog": "^11.0.1",
     "@types/jsdom": "^28.0.3",
-    "@types/node": "^26.0.1",
-    "@typescript-eslint/rule-tester": "^8.62.0",
+    "@types/node": "^26.1.0",
+    "@typescript-eslint/rule-tester": "^8.62.1",
     "@vitest/coverage-v8": "^4.1.9",
     "@vue/test-utils": "^2.4.11",
     "eslint": "^9.39.4",
@@ -115,7 +116,7 @@
     "typescript": "~6.0.3",
     "vitepress": "^2.0.0-alpha.17",
     "vitest": "^4.1.9",
-    "vue-tsc": "^3.3.5"
+    "vue-tsc": "^3.3.6"
   },
   "packageManager": "pnpm@11.9.0"
 }