@aglyn/besigner 1.0.0-beta.143

package/src/lib/text-entry/text-entry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * Copyright 2026 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.
+ */
+/**
+ * "Is the user typing?" — the single predicate every besigner shortcut that
+ * lives on `window`/`document` must consult before it acts (AGL-2211).
+ *
+ * A global shortcut is registered once and fires wherever focus happens to
+ * be. The canvas shortcuts (Cmd+C/V/A) and the picker's Escape are only
+ * meaningful when focus is on the element tree; inside a text-entry surface
+ * the surface — or the browser — owns the keystroke, and the canvas handler
+ * must return without calling `preventDefault()`.
+ *
+ * The surfaces are enumerated from what the besigner actually mounts, not
+ * guessed:
+ *
+ * - `INPUT` / `TEXTAREA` / `SELECT` — every attributes-panel field, dialog
+ *   field, and the plugin-settings raw-JSON `TextField`.
+ * - `contenteditable` — the inline text and markdown editors' light-DOM
+ *   halves, and MUI's rich fields.
+ * - `role="textbox"` / `role="searchbox"` — ARIA-labelled custom inputs.
+ * - **Monaco** (`.monaco-editor`), which is what `Edit -> Raw JSON` is.
+ *   Monaco 0.52+ ships the `EditContext` API and `editor.editContext`
+ *   DEFAULTS TO `true` (monaco-editor 0.56 —
+ *   `esm/vs/editor/common/config/editorOptions.js`), so the focused node is
+ *   a bare `<div class="native-edit-context" tabindex="0">`: **not** a
+ *   textarea, **not** contenteditable, no role. Every tag/attribute test
+ *   above misses it, which is exactly how Cmd+C in the raw JSON editor came
+ *   to copy canvas ELEMENTS. `.native-edit-context` is matched too so the
+ *   guard holds even if Monaco is ever mounted without its outer chrome.
+ *
+ * Deliberately DOM-only and dependency-free: `pick-manager` (this lib) and
+ * the designer's clipboard shortcuts (the feature lib) both need it, so it
+ * cannot reach for the inline-editor stores — the designer's
+ * `isEditingText()` layers those on top.
+ */
+/**
+ * Ancestors that make everything inside them a text-entry surface. Matched
+ * with `closest()`, so a click target deep inside Monaco's view still reads
+ * as "the user is typing".
+ */
+export declare const TEXT_ENTRY_HOST_SELECTOR: string;
+/**
+ * True when `target` is (or sits inside) a surface that owns the keystroke.
+ *
+ * Accepts an `EventTarget` so a handler can pass `event.target` straight
+ * through; anything that is not an element answers `false`.
+ */
+export declare function isTextEntryElement(target: EventTarget | Node | null | undefined): boolean;
+/**
+ * True when focus currently rests in a text-entry surface.
+ *
+ * Descends through OPEN shadow roots: `document.activeElement` reports the
+ * shadow HOST, so a field inside a web component would otherwise read as
+ * "not text". The besigner canvas uses a CLOSED root, which is unreachable
+ * by design — the designer's inline-edit stores answer for that surface.
+ */
+export declare function isTextEntryFocused(doc?: Document): boolean;

package/src/lib/text-entry/text-entry.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 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.
+ */ /**
+ * "Is the user typing?" — the single predicate every besigner shortcut that
+ * lives on `window`/`document` must consult before it acts (AGL-2211).
+ *
+ * A global shortcut is registered once and fires wherever focus happens to
+ * be. The canvas shortcuts (Cmd+C/V/A) and the picker's Escape are only
+ * meaningful when focus is on the element tree; inside a text-entry surface
+ * the surface — or the browser — owns the keystroke, and the canvas handler
+ * must return without calling `preventDefault()`.
+ *
+ * The surfaces are enumerated from what the besigner actually mounts, not
+ * guessed:
+ *
+ * - `INPUT` / `TEXTAREA` / `SELECT` — every attributes-panel field, dialog
+ *   field, and the plugin-settings raw-JSON `TextField`.
+ * - `contenteditable` — the inline text and markdown editors' light-DOM
+ *   halves, and MUI's rich fields.
+ * - `role="textbox"` / `role="searchbox"` — ARIA-labelled custom inputs.
+ * - **Monaco** (`.monaco-editor`), which is what `Edit -> Raw JSON` is.
+ *   Monaco 0.52+ ships the `EditContext` API and `editor.editContext`
+ *   DEFAULTS TO `true` (monaco-editor 0.56 —
+ *   `esm/vs/editor/common/config/editorOptions.js`), so the focused node is
+ *   a bare `<div class="native-edit-context" tabindex="0">`: **not** a
+ *   textarea, **not** contenteditable, no role. Every tag/attribute test
+ *   above misses it, which is exactly how Cmd+C in the raw JSON editor came
+ *   to copy canvas ELEMENTS. `.native-edit-context` is matched too so the
+ *   guard holds even if Monaco is ever mounted without its outer chrome.
+ *
+ * Deliberately DOM-only and dependency-free: `pick-manager` (this lib) and
+ * the designer's clipboard shortcuts (the feature lib) both need it, so it
+ * cannot reach for the inline-editor stores — the designer's
+ * `isEditingText()` layers those on top.
+ */ /**
+ * Ancestors that make everything inside them a text-entry surface. Matched
+ * with `closest()`, so a click target deep inside Monaco's view still reads
+ * as "the user is typing".
+ */ export const TEXT_ENTRY_HOST_SELECTOR = [
+    '.monaco-editor',
+    '.native-edit-context',
+    '[contenteditable=""]',
+    '[contenteditable="true"]',
+    '[contenteditable="plaintext-only"]'
+].join(',');
+/** Element tags that are always text entry. */ const TEXT_ENTRY_TAGS = new Set([
+    'INPUT',
+    'TEXTAREA',
+    'SELECT'
+]);
+/** ARIA roles that are always text entry. */ const TEXT_ENTRY_ROLES = new Set([
+    'textbox',
+    'searchbox'
+]);
+/**
+ * True when `target` is (or sits inside) a surface that owns the keystroke.
+ *
+ * Accepts an `EventTarget` so a handler can pass `event.target` straight
+ * through; anything that is not an element answers `false`.
+ */ export function isTextEntryElement(target) {
+    const element = target;
+    if (!element || element.nodeType !== 1) return false;
+    if (element.isContentEditable) return true;
+    if (TEXT_ENTRY_TAGS.has(element.tagName)) return true;
+    const role = element.getAttribute == null ? void 0 : element.getAttribute.call(element, 'role');
+    if (role && TEXT_ENTRY_ROLES.has(role)) return true;
+    return typeof element.closest === 'function' ? !!element.closest(TEXT_ENTRY_HOST_SELECTOR) : false;
+}
+/**
+ * True when focus currently rests in a text-entry surface.
+ *
+ * Descends through OPEN shadow roots: `document.activeElement` reports the
+ * shadow HOST, so a field inside a web component would otherwise read as
+ * "not text". The besigner canvas uses a CLOSED root, which is unreachable
+ * by design — the designer's inline-edit stores answer for that surface.
+ */ export function isTextEntryFocused(doc) {
+    const root = doc != null ? doc : typeof document === 'undefined' ? null : document;
+    if (!root) return false;
+    let active = root.activeElement;
+    while(active){
+        var _active_shadowRoot;
+        if (isTextEntryElement(active)) return true;
+        const inner = (_active_shadowRoot = active.shadowRoot) == null ? void 0 : _active_shadowRoot.activeElement;
+        if (!inner || inner === active) return false;
+        active = inner;
+    }
+    return false;
+}
+
+//# sourceMappingURL=text-entry.js.map

package/src/lib/text-entry/text-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/besigner/core/src/lib/text-entry/text-entry.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 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\n/**\n * \"Is the user typing?\" — the single predicate every besigner shortcut that\n * lives on `window`/`document` must consult before it acts (AGL-2211).\n *\n * A global shortcut is registered once and fires wherever focus happens to\n * be. The canvas shortcuts (Cmd+C/V/A) and the picker's Escape are only\n * meaningful when focus is on the element tree; inside a text-entry surface\n * the surface — or the browser — owns the keystroke, and the canvas handler\n * must return without calling `preventDefault()`.\n *\n * The surfaces are enumerated from what the besigner actually mounts, not\n * guessed:\n *\n * - `INPUT` / `TEXTAREA` / `SELECT` — every attributes-panel field, dialog\n *   field, and the plugin-settings raw-JSON `TextField`.\n * - `contenteditable` — the inline text and markdown editors' light-DOM\n *   halves, and MUI's rich fields.\n * - `role=\"textbox\"` / `role=\"searchbox\"` — ARIA-labelled custom inputs.\n * - **Monaco** (`.monaco-editor`), which is what `Edit -> Raw JSON` is.\n *   Monaco 0.52+ ships the `EditContext` API and `editor.editContext`\n *   DEFAULTS TO `true` (monaco-editor 0.56 —\n *   `esm/vs/editor/common/config/editorOptions.js`), so the focused node is\n *   a bare `<div class=\"native-edit-context\" tabindex=\"0\">`: **not** a\n *   textarea, **not** contenteditable, no role. Every tag/attribute test\n *   above misses it, which is exactly how Cmd+C in the raw JSON editor came\n *   to copy canvas ELEMENTS. `.native-edit-context` is matched too so the\n *   guard holds even if Monaco is ever mounted without its outer chrome.\n *\n * Deliberately DOM-only and dependency-free: `pick-manager` (this lib) and\n * the designer's clipboard shortcuts (the feature lib) both need it, so it\n * cannot reach for the inline-editor stores — the designer's\n * `isEditingText()` layers those on top.\n */\n\n/**\n * Ancestors that make everything inside them a text-entry surface. Matched\n * with `closest()`, so a click target deep inside Monaco's view still reads\n * as \"the user is typing\".\n */\nexport const TEXT_ENTRY_HOST_SELECTOR = [\n  '.monaco-editor',\n  '.native-edit-context',\n  '[contenteditable=\"\"]',\n  '[contenteditable=\"true\"]',\n  '[contenteditable=\"plaintext-only\"]',\n].join(',')\n\n/** Element tags that are always text entry. */\nconst TEXT_ENTRY_TAGS = new Set(['INPUT', 'TEXTAREA', 'SELECT'])\n\n/** ARIA roles that are always text entry. */\nconst TEXT_ENTRY_ROLES = new Set(['textbox', 'searchbox'])\n\n/**\n * True when `target` is (or sits inside) a surface that owns the keystroke.\n *\n * Accepts an `EventTarget` so a handler can pass `event.target` straight\n * through; anything that is not an element answers `false`.\n */\nexport function isTextEntryElement(\n  target: EventTarget | Node | null | undefined,\n): boolean {\n  const element = target as HTMLElement | null\n  if (!element || element.nodeType !== 1) return false\n  if (element.isContentEditable) return true\n  if (TEXT_ENTRY_TAGS.has(element.tagName)) return true\n  const role = element.getAttribute?.('role')\n  if (role && TEXT_ENTRY_ROLES.has(role)) return true\n  return typeof element.closest === 'function'\n    ? !!element.closest(TEXT_ENTRY_HOST_SELECTOR)\n    : false\n}\n\n/**\n * True when focus currently rests in a text-entry surface.\n *\n * Descends through OPEN shadow roots: `document.activeElement` reports the\n * shadow HOST, so a field inside a web component would otherwise read as\n * \"not text\". The besigner canvas uses a CLOSED root, which is unreachable\n * by design — the designer's inline-edit stores answer for that surface.\n */\nexport function isTextEntryFocused(doc?: Document): boolean {\n  const root = doc ?? (typeof document === 'undefined' ? null : document)\n  if (!root) return false\n  let active: Element | null = root.activeElement\n  while (active) {\n    if (isTextEntryElement(active)) return true\n    const inner = (active as HTMLElement).shadowRoot?.activeElement\n    if (!inner || inner === active) return false\n    active = inner\n  }\n  return false\n}\n"],"names":["TEXT_ENTRY_HOST_SELECTOR","join","TEXT_ENTRY_TAGS","Set","TEXT_ENTRY_ROLES","isTextEntryElement","target","element","nodeType","isContentEditable","has","tagName","role","getAttribute","closest","isTextEntryFocused","doc","root","document","active","activeElement","inner","shadowRoot"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCC,GAED;;;;CAIC,GACD,OAAO,MAAMA,2BAA2B;IACtC;IACA;IACA;IACA;IACA;CACD,CAACC,IAAI,CAAC,KAAI;AAEX,6CAA6C,GAC7C,MAAMC,kBAAkB,IAAIC,IAAI;IAAC;IAAS;IAAY;CAAS;AAE/D,2CAA2C,GAC3C,MAAMC,mBAAmB,IAAID,IAAI;IAAC;IAAW;CAAY;AAEzD;;;;;CAKC,GACD,OAAO,SAASE,mBACdC,MAA6C;IAE7C,MAAMC,UAAUD;IAChB,IAAI,CAACC,WAAWA,QAAQC,QAAQ,KAAK,GAAG,OAAO;IAC/C,IAAID,QAAQE,iBAAiB,EAAE,OAAO;IACtC,IAAIP,gBAAgBQ,GAAG,CAACH,QAAQI,OAAO,GAAG,OAAO;IACjD,MAAMC,OAAOL,QAAQM,YAAY,oBAApBN,QAAQM,YAAY,MAApBN,SAAuB;IACpC,IAAIK,QAAQR,iBAAiBM,GAAG,CAACE,OAAO,OAAO;IAC/C,OAAO,OAAOL,QAAQO,OAAO,KAAK,aAC9B,CAAC,CAACP,QAAQO,OAAO,CAACd,4BAClB;AACN;AAEA;;;;;;;CAOC,GACD,OAAO,SAASe,mBAAmBC,GAAc;IAC/C,MAAMC,OAAOD,cAAAA,MAAQ,OAAOE,aAAa,cAAc,OAAOA;IAC9D,IAAI,CAACD,MAAM,OAAO;IAClB,IAAIE,SAAyBF,KAAKG,aAAa;IAC/C,MAAOD,OAAQ;YAEC;QADd,IAAId,mBAAmBc,SAAS,OAAO;QACvC,MAAME,SAAQ,qBAAA,AAACF,OAAuBG,UAAU,qBAAlC,mBAAoCF,aAAa;QAC/D,IAAI,CAACC,SAASA,UAAUF,QAAQ,OAAO;QACvCA,SAASE;IACX;IACA,OAAO;AACT"}