@lexical/file 0.44.1-nightly.20260519.0 → 0.45.1-dev.0

package/{LexicalFile.dev.js → dist/LexicalFile.dev.js}

@@ -10,7 +10,7 @@
 
 var lexical = require('lexical');
 
-var version = "0.44.1-nightly.20260519.0";
+var version = "0.45.1-dev.0";
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.

package/{LexicalFile.dev.mjs → dist/LexicalFile.dev.mjs}

@@ -8,7 +8,7 @@
 
 import { CLEAR_HISTORY_COMMAND } from 'lexical';
 
-var version = "0.44.1-nightly.20260519.0";
+var version = "0.45.1-dev.0";
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.

package/dist/LexicalFile.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";var e=require("lexical");function t(e,t=Object.freeze({})){return{editorState:e.toJSON(),lastSaved:t.lastSaved||Date.now(),source:t.source||"Lexical",version:"0.45.1-dev.0"}}function o(e,t){const o="string"==typeof t?JSON.parse(t):t;return e.parseEditorState(o.editorState)}exports.editorStateFromSerializedDocument=o,exports.exportFile=function(e,o=Object.freeze({})){const n=new Date;!function(e,t){const o=document.createElement("a"),n=document.body;if(null===n)return;n.appendChild(o),o.style.display="none";const r=JSON.stringify(e),i=new Blob([r],{type:"octet/stream"}),a=window.URL.createObjectURL(i);o.href=a,o.download=t,o.click(),window.URL.revokeObjectURL(a),o.remove()}(t(e.getEditorState(),{...o,lastSaved:n.getTime()}),`${o.fileName||n.toISOString()}.lexical`)},exports.importFile=function(t){!function(e){const t=document.createElement("input");t.type="file",t.accept=".lexical",t.addEventListener("change",t=>{const o=t.target;if(o.files){const t=o.files[0],n=new FileReader;n.readAsText(t,"UTF-8"),n.onload=t=>{if(t.target){const o=t.target.result;e(o)}}}}),t.click()}(n=>{t.setEditorState(o(t,n)),t.dispatchCommand(e.CLEAR_HISTORY_COMMAND,void 0)})},exports.serializedDocumentFromEditorState=t;

package/dist/LexicalFile.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{CLEAR_HISTORY_COMMAND as e}from"lexical";function t(e,t=Object.freeze({})){return{editorState:e.toJSON(),lastSaved:t.lastSaved||Date.now(),source:t.source||"Lexical",version:"0.45.1-dev.0"}}function n(e,t){const n="string"==typeof t?JSON.parse(t):t;return e.parseEditorState(n.editorState)}function o(t){!function(e){const t=document.createElement("input");t.type="file",t.accept=".lexical",t.addEventListener("change",t=>{const n=t.target;if(n.files){const t=n.files[0],o=new FileReader;o.readAsText(t,"UTF-8"),o.onload=t=>{if(t.target){const n=t.target.result;e(n)}}}}),t.click()}(o=>{t.setEditorState(n(t,o)),t.dispatchCommand(e,void 0)})}function i(e,n=Object.freeze({})){const o=new Date;!function(e,t){const n=document.createElement("a"),o=document.body;if(null===o)return;o.appendChild(n),n.style.display="none";const i=JSON.stringify(e),a=new Blob([i],{type:"octet/stream"}),c=window.URL.createObjectURL(a);n.href=c,n.download=t,n.click(),window.URL.revokeObjectURL(c),n.remove()}(t(e.getEditorState(),{...n,lastSaved:o.getTime()}),`${n.fileName||o.toISOString()}.lexical`)}export{n as editorStateFromSerializedDocument,i as exportFile,o as importFile,t as serializedDocumentFromEditorState};

package/package.json

@@ -10,34 +10,48 @@
     "export"
   ],
   "license": "MIT",
-  "version": "0.44.1-nightly.20260519.0",
-  "main": "LexicalFile.js",
-  "types": "index.d.ts",
+  "version": "0.45.1-dev.0",
+  "main": "./dist/LexicalFile.js",
+  "types": "./dist/index.d.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/facebook/lexical.git",
     "directory": "packages/lexical-file"
   },
-  "module": "LexicalFile.mjs",
+  "module": "./dist/LexicalFile.mjs",
   "sideEffects": false,
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "import": {
-        "types": "./index.d.ts",
-        "development": "./LexicalFile.dev.mjs",
-        "production": "./LexicalFile.prod.mjs",
-        "node": "./LexicalFile.node.mjs",
-        "default": "./LexicalFile.mjs"
+        "types": "./dist/index.d.ts",
+        "development": "./dist/LexicalFile.dev.mjs",
+        "production": "./dist/LexicalFile.prod.mjs",
+        "node": "./dist/LexicalFile.node.mjs",
+        "default": "./dist/LexicalFile.mjs"
       },
       "require": {
-        "types": "./index.d.ts",
-        "development": "./LexicalFile.dev.js",
-        "production": "./LexicalFile.prod.js",
-        "default": "./LexicalFile.js"
+        "types": "./dist/index.d.ts",
+        "development": "./dist/LexicalFile.dev.js",
+        "production": "./dist/LexicalFile.prod.js",
+        "default": "./dist/LexicalFile.js"
       }
     }
   },
   "dependencies": {
-    "lexical": "0.44.1-nightly.20260519.0"
-  }
+    "lexical": "0.45.1-dev.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/__tests__",
+    "!src/__bench__",
+    "!src/__mocks__",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.bench.ts",
+    "!src/**/*.bench.tsx",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/src/fileImportExport.ts

@@ -0,0 +1,145 @@
+/**
+ * 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 type {EditorState, LexicalEditor, SerializedEditorState} from 'lexical';
+
+import {CLEAR_HISTORY_COMMAND} from 'lexical';
+
+import {version} from '../package.json';
+
+export interface SerializedDocument {
+  /** The serialized editorState produced by editorState.toJSON() */
+  editorState: SerializedEditorState;
+  /** The time this document was created in epoch milliseconds (Date.now()) */
+  lastSaved: number;
+  /** The source of the document, defaults to Lexical */
+  source: string | 'Lexical';
+  /** The version of Lexical that produced this document */
+  version: string;
+}
+
+/**
+ * Generates a SerializedDocument from the given EditorState
+ * @param editorState - the EditorState to serialize
+ * @param config - An object that optionally contains source and lastSaved.
+ * source defaults to Lexical and lastSaved defaults to the current time in
+ * epoch milliseconds.
+ */
+export function serializedDocumentFromEditorState(
+  editorState: EditorState,
+  config: Readonly<{
+    source?: string;
+    lastSaved?: number;
+  }> = Object.freeze({}),
+): SerializedDocument {
+  return {
+    editorState: editorState.toJSON(),
+    lastSaved: config.lastSaved || Date.now(),
+    source: config.source || 'Lexical',
+    version,
+  };
+}
+
+/**
+ * Parse an EditorState from the given editor and document
+ *
+ * @param editor - The lexical editor
+ * @param maybeStringifiedDocument - The contents of a .lexical file (as a JSON string, or already parsed)
+ */
+export function editorStateFromSerializedDocument(
+  editor: LexicalEditor,
+  maybeStringifiedDocument: SerializedDocument | string,
+): EditorState {
+  const json =
+    typeof maybeStringifiedDocument === 'string'
+      ? JSON.parse(maybeStringifiedDocument)
+      : maybeStringifiedDocument;
+  return editor.parseEditorState(json.editorState);
+}
+
+/**
+ * Takes a file and inputs its content into the editor state as an input field.
+ * @param editor - The lexical editor.
+ */
+export function importFile(editor: LexicalEditor) {
+  readTextFileFromSystem(text => {
+    editor.setEditorState(editorStateFromSerializedDocument(editor, text));
+    editor.dispatchCommand(CLEAR_HISTORY_COMMAND, undefined);
+  });
+}
+
+function readTextFileFromSystem(callback: (text: string) => void) {
+  const input = document.createElement('input');
+  input.type = 'file';
+  input.accept = '.lexical';
+  input.addEventListener('change', (event: Event) => {
+    const target = event.target as HTMLInputElement;
+
+    if (target.files) {
+      const file = target.files[0];
+      const reader = new FileReader();
+      reader.readAsText(file, 'UTF-8');
+
+      reader.onload = readerEvent => {
+        if (readerEvent.target) {
+          const content = readerEvent.target.result;
+          callback(content as string);
+        }
+      };
+    }
+  });
+  input.click();
+}
+
+/**
+ * Generates a .lexical file to be downloaded by the browser containing the current editor state.
+ * @param editor - The lexical editor.
+ * @param config - An object that optionally contains fileName and source. fileName defaults to
+ * the current date (as a string) and source defaults to Lexical.
+ */
+export function exportFile(
+  editor: LexicalEditor,
+  config: Readonly<{
+    fileName?: string;
+    source?: string;
+  }> = Object.freeze({}),
+) {
+  const now = new Date();
+  const serializedDocument = serializedDocumentFromEditorState(
+    editor.getEditorState(),
+    {
+      ...config,
+      lastSaved: now.getTime(),
+    },
+  );
+  const fileName = config.fileName || now.toISOString();
+  exportBlob(serializedDocument, `${fileName}.lexical`);
+}
+
+// Adapted from https://stackoverflow.com/a/19328891/2013580
+function exportBlob(data: SerializedDocument, fileName: string) {
+  const a = document.createElement('a');
+  const body = document.body;
+
+  if (body === null) {
+    return;
+  }
+
+  body.appendChild(a);
+  a.style.display = 'none';
+  const json = JSON.stringify(data);
+  const blob = new Blob([json], {
+    type: 'octet/stream',
+  });
+  const url = window.URL.createObjectURL(blob);
+  a.href = url;
+  a.download = fileName;
+  a.click();
+  window.URL.revokeObjectURL(url);
+  a.remove();
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ *
+ */
+
+export {
+  editorStateFromSerializedDocument,
+  exportFile,
+  importFile,
+  type SerializedDocument,
+  serializedDocumentFromEditorState,
+} from './fileImportExport';

package/LexicalFile.prod.js

@@ -1,9 +0,0 @@
-/**
- * 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 e=require("lexical");function t(e,t=Object.freeze({})){return{editorState:e.toJSON(),lastSaved:t.lastSaved||Date.now(),source:t.source||"Lexical",version:"0.44.1-nightly.20260519.0"}}function o(e,t){const o="string"==typeof t?JSON.parse(t):t;return e.parseEditorState(o.editorState)}exports.editorStateFromSerializedDocument=o,exports.exportFile=function(e,o=Object.freeze({})){const n=new Date;!function(e,t){const o=document.createElement("a"),n=document.body;if(null===n)return;n.appendChild(o),o.style.display="none";const i=JSON.stringify(e),r=new Blob([i],{type:"octet/stream"}),a=window.URL.createObjectURL(r);o.href=a,o.download=t,o.click(),window.URL.revokeObjectURL(a),o.remove()}(t(e.getEditorState(),{...o,lastSaved:n.getTime()}),`${o.fileName||n.toISOString()}.lexical`)},exports.importFile=function(t){!function(e){const t=document.createElement("input");t.type="file",t.accept=".lexical",t.addEventListener("change",t=>{const o=t.target;if(o.files){const t=o.files[0],n=new FileReader;n.readAsText(t,"UTF-8"),n.onload=t=>{if(t.target){const o=t.target.result;e(o)}}}}),t.click()}(n=>{t.setEditorState(o(t,n)),t.dispatchCommand(e.CLEAR_HISTORY_COMMAND,void 0)})},exports.serializedDocumentFromEditorState=t;

package/LexicalFile.prod.mjs

@@ -1,9 +0,0 @@
-/**
- * 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{CLEAR_HISTORY_COMMAND as e}from"lexical";function t(e,t=Object.freeze({})){return{editorState:e.toJSON(),lastSaved:t.lastSaved||Date.now(),source:t.source||"Lexical",version:"0.44.1-nightly.20260519.0"}}function n(e,t){const n="string"==typeof t?JSON.parse(t):t;return e.parseEditorState(n.editorState)}function o(t){!function(e){const t=document.createElement("input");t.type="file",t.accept=".lexical",t.addEventListener("change",t=>{const n=t.target;if(n.files){const t=n.files[0],o=new FileReader;o.readAsText(t,"UTF-8"),o.onload=t=>{if(t.target){const n=t.target.result;e(n)}}}}),t.click()}(o=>{t.setEditorState(n(t,o)),t.dispatchCommand(e,void 0)})}function i(e,n=Object.freeze({})){const o=new Date;!function(e,t){const n=document.createElement("a"),o=document.body;if(null===o)return;o.appendChild(n),n.style.display="none";const i=JSON.stringify(e),a=new Blob([i],{type:"octet/stream"}),c=window.URL.createObjectURL(a);n.href=c,n.download=t,n.click(),window.URL.revokeObjectURL(c),n.remove()}(t(e.getEditorState(),{...n,lastSaved:o.getTime()}),`${n.fileName||o.toISOString()}.lexical`)}export{n as editorStateFromSerializedDocument,i as exportFile,o as importFile,t as serializedDocumentFromEditorState};