@lexical/internal 0.45.0

package/package.json

@@ -0,0 +1,289 @@
+{
+  "name": "@lexical/internal",
+  "description": "Internal Lexical utilities shared across packages. Do not import directly; no semver guarantees apply to its API.",
+  "keywords": [
+    "lexical",
+    "editor",
+    "rich-text",
+    "internal"
+  ],
+  "license": "MIT",
+  "version": "0.45.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/facebook/lexical.git",
+    "directory": "packages/lexical-internal"
+  },
+  "sideEffects": false,
+  "exports": {
+    "./devInvariant": {
+      "source": "./src/devInvariant.ts",
+      "import": {
+        "types": "./dist/devInvariant.d.ts",
+        "development": "./dist/LexicalInternalDevInvariant.dev.mjs",
+        "production": "./dist/LexicalInternalDevInvariant.prod.mjs",
+        "node": "./dist/LexicalInternalDevInvariant.node.mjs",
+        "default": "./dist/LexicalInternalDevInvariant.mjs"
+      },
+      "require": {
+        "types": "./dist/devInvariant.d.ts",
+        "development": "./dist/LexicalInternalDevInvariant.dev.js",
+        "production": "./dist/LexicalInternalDevInvariant.prod.js",
+        "default": "./dist/LexicalInternalDevInvariant.js"
+      }
+    },
+    "./devInvariant.js": {
+      "source": "./src/devInvariant.ts",
+      "import": {
+        "types": "./dist/devInvariant.d.ts",
+        "development": "./dist/LexicalInternalDevInvariant.dev.mjs",
+        "production": "./dist/LexicalInternalDevInvariant.prod.mjs",
+        "node": "./dist/LexicalInternalDevInvariant.node.mjs",
+        "default": "./dist/LexicalInternalDevInvariant.mjs"
+      },
+      "require": {
+        "types": "./dist/devInvariant.d.ts",
+        "development": "./dist/LexicalInternalDevInvariant.dev.js",
+        "production": "./dist/LexicalInternalDevInvariant.prod.js",
+        "default": "./dist/LexicalInternalDevInvariant.js"
+      }
+    },
+    "./formatDevErrorMessage": {
+      "source": "./src/formatDevErrorMessage.ts",
+      "import": {
+        "types": "./dist/formatDevErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevErrorMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatDevErrorMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatDevErrorMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatDevErrorMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatDevErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevErrorMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatDevErrorMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatDevErrorMessage.js"
+      }
+    },
+    "./formatDevErrorMessage.js": {
+      "source": "./src/formatDevErrorMessage.ts",
+      "import": {
+        "types": "./dist/formatDevErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevErrorMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatDevErrorMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatDevErrorMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatDevErrorMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatDevErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevErrorMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatDevErrorMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatDevErrorMessage.js"
+      }
+    },
+    "./formatDevWarningMessage": {
+      "source": "./src/formatDevWarningMessage.ts",
+      "import": {
+        "types": "./dist/formatDevWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevWarningMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatDevWarningMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatDevWarningMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatDevWarningMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatDevWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevWarningMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatDevWarningMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatDevWarningMessage.js"
+      }
+    },
+    "./formatDevWarningMessage.js": {
+      "source": "./src/formatDevWarningMessage.ts",
+      "import": {
+        "types": "./dist/formatDevWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevWarningMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatDevWarningMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatDevWarningMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatDevWarningMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatDevWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatDevWarningMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatDevWarningMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatDevWarningMessage.js"
+      }
+    },
+    "./formatProdErrorMessage": {
+      "source": "./src/formatProdErrorMessage.ts",
+      "import": {
+        "types": "./dist/formatProdErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdErrorMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatProdErrorMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatProdErrorMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatProdErrorMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatProdErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdErrorMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatProdErrorMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatProdErrorMessage.js"
+      }
+    },
+    "./formatProdErrorMessage.js": {
+      "source": "./src/formatProdErrorMessage.ts",
+      "import": {
+        "types": "./dist/formatProdErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdErrorMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatProdErrorMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatProdErrorMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatProdErrorMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatProdErrorMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdErrorMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatProdErrorMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatProdErrorMessage.js"
+      }
+    },
+    "./formatProdWarningMessage": {
+      "source": "./src/formatProdWarningMessage.ts",
+      "import": {
+        "types": "./dist/formatProdWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdWarningMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatProdWarningMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatProdWarningMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatProdWarningMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatProdWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdWarningMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatProdWarningMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatProdWarningMessage.js"
+      }
+    },
+    "./formatProdWarningMessage.js": {
+      "source": "./src/formatProdWarningMessage.ts",
+      "import": {
+        "types": "./dist/formatProdWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdWarningMessage.dev.mjs",
+        "production": "./dist/LexicalInternalFormatProdWarningMessage.prod.mjs",
+        "node": "./dist/LexicalInternalFormatProdWarningMessage.node.mjs",
+        "default": "./dist/LexicalInternalFormatProdWarningMessage.mjs"
+      },
+      "require": {
+        "types": "./dist/formatProdWarningMessage.d.ts",
+        "development": "./dist/LexicalInternalFormatProdWarningMessage.dev.js",
+        "production": "./dist/LexicalInternalFormatProdWarningMessage.prod.js",
+        "default": "./dist/LexicalInternalFormatProdWarningMessage.js"
+      }
+    },
+    "./invariant": {
+      "source": "./src/invariant.ts",
+      "import": {
+        "types": "./dist/invariant.d.ts",
+        "development": "./dist/LexicalInternalInvariant.dev.mjs",
+        "production": "./dist/LexicalInternalInvariant.prod.mjs",
+        "node": "./dist/LexicalInternalInvariant.node.mjs",
+        "default": "./dist/LexicalInternalInvariant.mjs"
+      },
+      "require": {
+        "types": "./dist/invariant.d.ts",
+        "development": "./dist/LexicalInternalInvariant.dev.js",
+        "production": "./dist/LexicalInternalInvariant.prod.js",
+        "default": "./dist/LexicalInternalInvariant.js"
+      }
+    },
+    "./invariant.js": {
+      "source": "./src/invariant.ts",
+      "import": {
+        "types": "./dist/invariant.d.ts",
+        "development": "./dist/LexicalInternalInvariant.dev.mjs",
+        "production": "./dist/LexicalInternalInvariant.prod.mjs",
+        "node": "./dist/LexicalInternalInvariant.node.mjs",
+        "default": "./dist/LexicalInternalInvariant.mjs"
+      },
+      "require": {
+        "types": "./dist/invariant.d.ts",
+        "development": "./dist/LexicalInternalInvariant.dev.js",
+        "production": "./dist/LexicalInternalInvariant.prod.js",
+        "default": "./dist/LexicalInternalInvariant.js"
+      }
+    },
+    "./version": {
+      "source": "./src/version.ts",
+      "import": {
+        "types": "./dist/version.d.ts",
+        "development": "./dist/LexicalInternalVersion.dev.mjs",
+        "production": "./dist/LexicalInternalVersion.prod.mjs",
+        "node": "./dist/LexicalInternalVersion.node.mjs",
+        "default": "./dist/LexicalInternalVersion.mjs"
+      },
+      "require": {
+        "types": "./dist/version.d.ts",
+        "development": "./dist/LexicalInternalVersion.dev.js",
+        "production": "./dist/LexicalInternalVersion.prod.js",
+        "default": "./dist/LexicalInternalVersion.js"
+      }
+    },
+    "./version.js": {
+      "source": "./src/version.ts",
+      "import": {
+        "types": "./dist/version.d.ts",
+        "development": "./dist/LexicalInternalVersion.dev.mjs",
+        "production": "./dist/LexicalInternalVersion.prod.mjs",
+        "node": "./dist/LexicalInternalVersion.node.mjs",
+        "default": "./dist/LexicalInternalVersion.mjs"
+      },
+      "require": {
+        "types": "./dist/version.d.ts",
+        "development": "./dist/LexicalInternalVersion.dev.js",
+        "production": "./dist/LexicalInternalVersion.prod.js",
+        "default": "./dist/LexicalInternalVersion.js"
+      }
+    },
+    "./warnOnlyOnce": {
+      "source": "./src/warnOnlyOnce.ts",
+      "import": {
+        "types": "./dist/warnOnlyOnce.d.ts",
+        "development": "./dist/LexicalInternalWarnOnlyOnce.dev.mjs",
+        "production": "./dist/LexicalInternalWarnOnlyOnce.prod.mjs",
+        "node": "./dist/LexicalInternalWarnOnlyOnce.node.mjs",
+        "default": "./dist/LexicalInternalWarnOnlyOnce.mjs"
+      },
+      "require": {
+        "types": "./dist/warnOnlyOnce.d.ts",
+        "development": "./dist/LexicalInternalWarnOnlyOnce.dev.js",
+        "production": "./dist/LexicalInternalWarnOnlyOnce.prod.js",
+        "default": "./dist/LexicalInternalWarnOnlyOnce.js"
+      }
+    },
+    "./warnOnlyOnce.js": {
+      "source": "./src/warnOnlyOnce.ts",
+      "import": {
+        "types": "./dist/warnOnlyOnce.d.ts",
+        "development": "./dist/LexicalInternalWarnOnlyOnce.dev.mjs",
+        "production": "./dist/LexicalInternalWarnOnlyOnce.prod.mjs",
+        "node": "./dist/LexicalInternalWarnOnlyOnce.node.mjs",
+        "default": "./dist/LexicalInternalWarnOnlyOnce.mjs"
+      },
+      "require": {
+        "types": "./dist/warnOnlyOnce.d.ts",
+        "development": "./dist/LexicalInternalWarnOnlyOnce.dev.js",
+        "production": "./dist/LexicalInternalWarnOnlyOnce.prod.js",
+        "default": "./dist/LexicalInternalWarnOnlyOnce.js"
+      }
+    }
+  },
+  "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/devInvariant.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 __DEV__ = process.env.NODE_ENV !== 'production';
+
+/**
+ * If `!cond`, throw in `__DEV__` like an invariant and warn in prod.
+ *
+ * A production build rewrites call sites via `transformErrorMessages`
+ * (throwing dev message in dev, `formatProdWarningMessage` in prod), so this
+ * body is only reached when consumed as untransformed source. It interpolates
+ * `%s` placeholders and throws outside production, otherwise warns.
+ */
+export default function devInvariant(
+  cond?: boolean,
+  message = 'Internal Lexical error: devInvariant() called without a message',
+  ...args: string[]
+): void {
+  if (cond) {
+    return;
+  }
+
+  const formatted = args.reduce(
+    (msg, arg) => msg.replace('%s', String(arg)),
+    message,
+  );
+  if (__DEV__) {
+    throw new Error(formatted);
+  } else {
+    console.warn(formatted);
+  }
+}

package/src/formatDevErrorMessage.ts

@@ -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.
+ *
+ */
+
+// Do not require this module directly! Use normal `invariant` calls.
+
+export default function formatDevErrorMessage(message: string): never {
+  throw new Error(message);
+}

package/src/formatDevWarningMessage.ts

@@ -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.
+ *
+ */
+
+// Do not require this module directly! Use normal `invariant` calls.
+
+export default function formatDevWarningMessage(message: string): void {
+  console.warn(message);
+}

package/src/formatProdErrorMessage.ts

@@ -0,0 +1,28 @@
+/**
+ * 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 with
+// template literal strings. The messages will be replaced with error codes
+// during build.
+
+export default function formatProdErrorMessage(
+  code: string,
+  ...args: string[]
+): never {
+  const url = new URL('https://lexical.dev/docs/error');
+  const params = new URLSearchParams();
+  params.append('code', code);
+  for (const arg of args) {
+    params.append('v', arg);
+  }
+  url.search = params.toString();
+
+  throw Error(
+    `Minified Lexical error #${code}; visit ${url.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`,
+  );
+}

package/src/formatProdWarningMessage.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 default function formatProdWarningMessage(
+  code: string,
+  ...args: string[]
+): void {
+  const url = new URL('https://lexical.dev/docs/error');
+  const params = new URLSearchParams();
+  params.append('code', code);
+  for (const arg of args) {
+    params.append('v', arg);
+  }
+  url.search = params.toString();
+
+  console.warn(
+    `Minified Lexical warning #${code}; visit ${url.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`,
+  );
+}

package/src/invariant.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ *
+ */
+
+// invariant(condition, message) will refine types based on "condition", and
+// if "condition" is false will throw an error. This function is special-cased
+// in flow itself, so we can't name it anything else.
+//
+// In a production build the `transformErrorMessages` Babel plugin replaces
+// every call site with a hoisted `if (!cond)` check plus a
+// `formatProdErrorMessage(code, ...args)` call, so this body is only reached
+// when the source is consumed without that transform (the `source` export
+// condition or an untransformed dev build). It must therefore stand on its
+// own: interpolate `%s` placeholders against args and throw.
+export default function invariant(
+  cond?: boolean,
+  message = 'Internal Lexical error: invariant() called without a message',
+  ...args: string[]
+): asserts cond {
+  if (cond) {
+    return;
+  }
+
+  throw new Error(
+    args.reduce((msg, arg) => msg.replace('%s', String(arg)), message),
+  );
+}

package/src/version.ts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ *
+ */
+
+// `process.env.LEXICAL_VERSION` is statically replaced with the build-specific
+// version string in a Rollup build, and a consumer's bundler `define` can
+// inject it the same way — so the exact `process.env.LEXICAL_VERSION` member
+// expression must be preserved for that substitution to match. Reading it
+// inside a try/catch lets the source be consumed directly (via the `source`
+// export condition) in a browser bundle, where `process` is undefined and
+// nothing replaced the reference, without throwing a ReferenceError; it falls
+// back to the literal below instead. The literal is regenerated by
+// `pnpm run update-version`.
+let envLexicalVersion: string | undefined;
+try {
+  envLexicalVersion = process.env.LEXICAL_VERSION;
+} catch {
+  // `process` is not defined in some browser bundles; use the fallback.
+}
+export const LEXICAL_VERSION: string = envLexicalVersion ?? '0.45.0+source';

package/src/warnOnlyOnce.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 __DEV__ = process.env.NODE_ENV !== 'production';
+
+/*@__INLINE__*/
+export default function warnOnlyOnce(message: string): () => void {
+  if (__DEV__) {
+    let run = false;
+    return () => {
+      if (!run) {
+        console.warn(message);
+      }
+      run = true;
+    };
+  } else {
+    return () => {};
+  }
+}