@lexical/headless 0.35.1-nightly.20250924.0 → 0.36.0

package/LexicalHeadlessDom.browser.dev.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+'use strict';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+// Do not require this module directly! Use normal `invariant` calls.
+
+function formatDevErrorMessage(message) {
+  throw new Error(message);
+}
+
+function withDOM(f) {
+  if (!!!globalThis.window) {
+    formatDevErrorMessage(`@lexical/headless/dom compiled for browser used in an environment without a global window`);
+  }
+  return f(globalThis.window);
+}
+
+exports.withDOM = withDOM;

package/LexicalHeadlessDom.browser.dev.mjs

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+// Do not require this module directly! Use normal `invariant` calls.
+
+function formatDevErrorMessage(message) {
+  throw new Error(message);
+}
+
+function withDOM(f) {
+  if (!!!globalThis.window) {
+    formatDevErrorMessage(`@lexical/headless/dom compiled for browser used in an environment without a global window`);
+  }
+  return f(globalThis.window);
+}
+
+export { withDOM };

package/LexicalHeadlessDom.browser.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+'use strict'
+const LexicalHeadlessDom.browser = process.env.NODE_ENV !== 'production' ? require('./LexicalHeadlessDom.browser.dev.js') : require('./LexicalHeadlessDom.browser.prod.js');
+module.exports = LexicalHeadlessDom.browser;

package/LexicalHeadlessDom.browser.mjs

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import * as modDev from './LexicalHeadlessDom.browser.dev.mjs';
+import * as modProd from './LexicalHeadlessDom.browser.prod.mjs';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export const withDOM = mod.withDOM;

package/LexicalHeadlessDom.browser.node.mjs

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+const mod = await (process.env.NODE_ENV !== 'production' ? import('./LexicalHeadlessDom.browser.dev.mjs') : import('./LexicalHeadlessDom.browser.prod.mjs'));
+export const withDOM = mod.withDOM;

package/LexicalHeadlessDom.browser.prod.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+"use strict";exports.withDOM=function(r){return globalThis.window||function(r,...e){const n=new URL("https://lexical.dev/docs/error"),o=new URLSearchParams;o.append("code",r);for(const r of e)o.append("v",r);throw n.search=o.toString(),Error(`Minified Lexical error #${r}; visit ${n.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}(318),r(globalThis.window)};

package/LexicalHeadlessDom.browser.prod.mjs

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+function r(r){return globalThis.window||function(r,...e){const n=new URL("https://lexical.dev/docs/error"),o=new URLSearchParams;o.append("code",r);for(const r of e)o.append("v",r);throw n.search=o.toString(),Error(`Minified Lexical error #${r}; visit ${n.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}(318),r(globalThis.window)}export{r as withDOM};

package/LexicalHeadlessDom.dev.js

@@ -0,0 +1,79 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+'use strict';
+
+var HappyDOM = require('happy-dom');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    for (var k in e) {
+      n[k] = e[k];
+    }
+  }
+  n.default = e;
+  return n;
+}
+
+var HappyDOM__namespace = /*#__PURE__*/_interopNamespaceDefault(HappyDOM);
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+function createWindow() {
+  if ('Window' in HappyDOM__namespace) {
+    // @ts-expect-error -- DOMWindow is not exactly Window
+    return new HappyDOM__namespace.Window();
+  } else {
+    const jsdom = HappyDOM__namespace;
+    // @ts-expect-error -- this is jsdom in www
+    return new jsdom.JSDOM().window;
+  }
+}
+
+/**
+ * Call the given synchronous function with a window object,
+ * either from the browser or happy-dom in a non-browser
+ * environment. It will also set window, document, and MutationObserver
+ * on globalThis while the callback is running. This is
+ * useful primarily to parse and render HTML server-side.
+ *
+ * It is not safe to do anything asynchronous during this callback.
+ *
+ * @param f A function that uses the window object
+ * @returns The result of that function.
+ */
+function withDOM(f) {
+  const prevWindow = globalThis.window;
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- handle recursive case
+  if (prevWindow) {
+    return f(globalThis.window);
+  }
+  const prevMutationObserver = globalThis.MutationObserver;
+  const prevDocument = globalThis.document;
+  const newWindow = createWindow();
+  globalThis.window = newWindow;
+  globalThis.document = newWindow.document;
+  globalThis.MutationObserver = newWindow.MutationObserver;
+  try {
+    return f(newWindow);
+  } finally {
+    globalThis.MutationObserver = prevMutationObserver;
+    globalThis.document = prevDocument;
+    globalThis.window = prevWindow;
+    newWindow.close();
+  }
+}
+
+exports.withDOM = withDOM;

package/LexicalHeadlessDom.dev.mjs

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import * as HappyDOM from 'happy-dom';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+function createWindow() {
+  if ('Window' in HappyDOM) {
+    // @ts-expect-error -- DOMWindow is not exactly Window
+    return new HappyDOM.Window();
+  } else {
+    const jsdom = HappyDOM;
+    // @ts-expect-error -- this is jsdom in www
+    return new jsdom.JSDOM().window;
+  }
+}
+
+/**
+ * Call the given synchronous function with a window object,
+ * either from the browser or happy-dom in a non-browser
+ * environment. It will also set window, document, and MutationObserver
+ * on globalThis while the callback is running. This is
+ * useful primarily to parse and render HTML server-side.
+ *
+ * It is not safe to do anything asynchronous during this callback.
+ *
+ * @param f A function that uses the window object
+ * @returns The result of that function.
+ */
+function withDOM(f) {
+  const prevWindow = globalThis.window;
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- handle recursive case
+  if (prevWindow) {
+    return f(globalThis.window);
+  }
+  const prevMutationObserver = globalThis.MutationObserver;
+  const prevDocument = globalThis.document;
+  const newWindow = createWindow();
+  globalThis.window = newWindow;
+  globalThis.document = newWindow.document;
+  globalThis.MutationObserver = newWindow.MutationObserver;
+  try {
+    return f(newWindow);
+  } finally {
+    globalThis.MutationObserver = prevMutationObserver;
+    globalThis.document = prevDocument;
+    globalThis.window = prevWindow;
+    newWindow.close();
+  }
+}
+
+export { withDOM };

package/LexicalHeadlessDom.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+'use strict'
+const LexicalHeadlessDom = process.env.NODE_ENV !== 'production' ? require('./LexicalHeadlessDom.dev.js') : require('./LexicalHeadlessDom.prod.js');
+module.exports = LexicalHeadlessDom;

package/LexicalHeadlessDom.js.flow

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ */
+
+/**
+ * LexicalHeadlessDom
+ */
+declare export function withDOM<T>(f: (window: typeof globalThis.window) => T): T;

package/LexicalHeadlessDom.mjs

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import * as modDev from './LexicalHeadlessDom.dev.mjs';
+import * as modProd from './LexicalHeadlessDom.prod.mjs';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export const withDOM = mod.withDOM;

package/LexicalHeadlessDom.node.mjs

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+const mod = await (process.env.NODE_ENV !== 'production' ? import('./LexicalHeadlessDom.dev.mjs') : import('./LexicalHeadlessDom.prod.mjs'));
+export const withDOM = mod.withDOM;

package/LexicalHeadlessDom.prod.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+"use strict";function o(o){var i=Object.create(null);if(o)for(var n in o)i[n]=o[n];return i.default=o,i}var i=o(require("happy-dom"));exports.withDOM=function(o){const n=globalThis.window;if(n)return o(globalThis.window);const t=globalThis.MutationObserver,e=globalThis.document,l="Window"in i?new i.Window:(new i.JSDOM).window;globalThis.window=l,globalThis.document=l.document,globalThis.MutationObserver=l.MutationObserver;try{return o(l)}finally{globalThis.MutationObserver=t,globalThis.document=e,globalThis.window=n,l.close()}};

package/LexicalHeadlessDom.prod.mjs

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+
+import*as o from"happy-dom";function i(i){const n=globalThis.window;if(n)return i(globalThis.window);const l=globalThis.MutationObserver,t=globalThis.document,e="Window"in o?new o.Window:(new o.JSDOM).window;globalThis.window=e,globalThis.document=e.document,globalThis.MutationObserver=e.MutationObserver;try{return i(e)}finally{globalThis.MutationObserver=l,globalThis.document=t,globalThis.window=n,e.close()}}export{i as withDOM};

package/dom.browser.d.ts

@@ -0,0 +1 @@
+export declare function withDOM<T>(f: (window: Window) => T): T;

package/dom.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * Call the given synchronous function with a window object,
+ * either from the browser or happy-dom in a non-browser
+ * environment. It will also set window, document, and MutationObserver
+ * on globalThis while the callback is running. This is
+ * useful primarily to parse and render HTML server-side.
+ *
+ * It is not safe to do anything asynchronous during this callback.
+ *
+ * @param f A function that uses the window object
+ * @returns The result of that function.
+ */
+export declare function withDOM<T>(f: (window: Window) => T): T;

package/package.json

@@ -8,17 +8,35 @@
     "headless"
   ],
   "license": "MIT",
-  "version": "0.35.1-nightly.20250924.0",
-  "main": "LexicalHeadless.js",
-  "types": "index.d.ts",
+  "version": "0.36.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/facebook/lexical",
     "directory": "packages/lexical-headless"
   },
-  "module": "LexicalHeadless.mjs",
   "sideEffects": false,
   "exports": {
+    "./dom": {
+      "browser": {
+        "types": "./LexicalHeadlessDom.d.ts",
+        "development": "./LexicalHeadlessDom.dev.browser.mjs",
+        "production": "./LexicalHeadlessDom.prod.browser.mjs",
+        "default": "./LexicalHeadlessDom.browser.mjs"
+      },
+      "import": {
+        "types": "./LexicalHeadlessDom.d.ts",
+        "development": "./LexicalHeadlessDom.dev.mjs",
+        "production": "./LexicalHeadlessDom.prod.mjs",
+        "node": "./LexicalHeadlessDom.node.mjs",
+        "default": "./LexicalHeadlessDom.mjs"
+      },
+      "require": {
+        "types": "./LexicalHeadlessDom.d.ts",
+        "development": "./LexicalHeadlessDom.dev.js",
+        "production": "./LexicalHeadlessDom.prod.js",
+        "default": "./LexicalHeadlessDom.js"
+      }
+    },
     ".": {
       "import": {
         "types": "./index.d.ts",
@@ -36,6 +54,9 @@
     }
   },
   "dependencies": {
-    "lexical": "0.35.1-nightly.20250924.0"
+    "lexical": "0.36.0"
+  },
+  "devDependencies": {
+    "happy-dom": "^18.0.1"
   }
 }