@lexical/internal 0.51.1-nightly.20260925.0 → 0.52.0

package/README.md

@@ -2,7 +2,7 @@
 
 > [!WARNING]
 > This package contains **internal** utilities shared across the Lexical
-> packages: `invariant`/`devInvariant`, dev/prod error- and warning-message
+> packages: `invariant`/`devInvariant`, `createError`, dev/prod error- and warning-message
 > formatting, `warnOnlyOnce`, and the `LEXICAL_VERSION` constant. These are
 > bound to the build's transforms and are inlined into every other package
 > rather than shipped as a runtime dependency, so it is published only so the
@@ -12,3 +12,20 @@
 > It is **not** a public API. Import from `lexical` and the `@lexical/*`
 > feature packages instead. Nothing here follows semver and any export may
 > change or disappear without notice.
+
+`createError('Message with %s', value)` constructs an `Error` without throwing
+it, for example to pass to an editor's `onWarn` handler. It shares invariant's
+literal-message and `%s` argument convention, including production error-code
+extraction, and can be used inside expressions.
+
+The transform recognizes the default import from
+`@lexical/internal/createError` (or its `.js` alias), including renamed imports.
+Unrelated or shadowed functions with the same name are left alone. Generated
+calls use separate `createDevError` and `createProdError` runtime helpers so
+bundled output can pass through the transform again.
+
+Warnings routed through `createError`, including the update-cascade warning,
+use the minified error message in production builds with extracted error codes.
+Arguments such as the editor namespace are encoded as `v` parameters in the
+decoder URL instead of appearing directly in the message text. Telemetry that
+matches the full development warning text must account for that production form.

package/dist/LexicalInternalCreateDevError.dev.js

@@ -0,0 +1,22 @@
+/**
+ * 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.
+ *
+ */
+
+// Used by the error-message transform. Call createError in source.
+function createDevError(message) {
+  return new Error(message);
+}
+
+export { createDevError as default };

package/dist/LexicalInternalCreateDevError.js

@@ -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 './LexicalInternalCreateDevError.dev.js';
+import * as modProd from './LexicalInternalCreateDevError.prod.js';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export default mod.default;

package/dist/LexicalInternalCreateDevError.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+declare export default function createDevError(message: string): Error;

package/dist/LexicalInternalCreateDevError.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.
+ *
+ */
+
+function r(r){return new Error(r)}export{r as default};

package/dist/LexicalInternalCreateError.dev.js

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ *
+ */
+
+// Used by the error-message transform. Call createError in source.
+function createDevError(message) {
+  return new Error(message);
+}
+
+/**
+ * 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.
+ *
+ */
+
+
+/**
+ * Construct an error without throwing it. Like invariant, the message must be
+ * a literal with %s placeholders so builds can replace it with an error code.
+ * The source implementation also works without the build transform.
+ */
+function createError(message, ...args) {
+  let index = 0;
+  return createDevError(args.length === 0 ? message : message.replace(/%s/g, () => String(args[index++])));
+}
+
+export { createError as default };

package/dist/LexicalInternalCreateError.js

@@ -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 './LexicalInternalCreateError.dev.js';
+import * as modProd from './LexicalInternalCreateError.prod.js';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export default mod.default;

package/dist/LexicalInternalCreateError.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
+ */
+
+declare export default function createError(
+  message: string,
+  ...args: string[]
+): Error;

package/dist/LexicalInternalCreateError.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.
+ *
+ */
+
+function r(r,...e){let n=0;return function(r){return new Error(r)}(0===e.length?r:r.replace(/%s/g,()=>String(e[n++])))}export{r as default};

package/dist/LexicalInternalCreateProdError.dev.js

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ *
+ */
+
+// Used by the error-message transform. Call createError or invariant in source.
+function createProdError(code, ...args) {
+  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();
+  return new 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.`);
+}
+
+export { createProdError as default };

package/dist/LexicalInternalCreateProdError.js

@@ -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 './LexicalInternalCreateProdError.dev.js';
+import * as modProd from './LexicalInternalCreateProdError.prod.js';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export default mod.default;

package/dist/LexicalInternalCreateProdError.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
+ */
+
+declare export default function createProdError(
+  code: string,
+  ...args: string[]
+): Error;

package/dist/LexicalInternalCreateProdError.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.
+ *
+ */
+
+function e(e,...r){const n=new URL("https://lexical.dev/docs/error"),o=new URLSearchParams;o.append("code",e);for(const e of r)o.append("v",e);return n.search=o.toString(),new Error(`Minified Lexical error #${e}; visit ${n.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}export{e as default};

package/dist/LexicalInternalFormatProdErrorMessage.dev.js

@@ -14,11 +14,8 @@
  *
  */
 
-// Do not require this module directly! Use normal `invariant` calls with
-// template literal strings. The messages will be replaced with error codes
-// during build.
-
-function formatProdErrorMessage(code, ...args) {
+// Used by the error-message transform. Call createError or invariant in source.
+function createProdError(code, ...args) {
   const url = new URL('https://lexical.dev/docs/error');
   const params = new URLSearchParams();
   params.append('code', code);
@@ -26,7 +23,24 @@ function formatProdErrorMessage(code, ...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.`);
+  return new 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.`);
+}
+
+/**
+ * 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.
+
+function formatProdErrorMessage(code, ...args) {
+  throw createProdError(code, ...args);
 }
 
 export { formatProdErrorMessage as default };

package/dist/LexicalInternalFormatProdErrorMessage.prod.js

@@ -6,4 +6,4 @@
  *
  */
 
-function e(e,...r){const n=new URL("https://lexical.dev/docs/error"),o=new URLSearchParams;o.append("code",e);for(const e of r)o.append("v",e);throw n.search=o.toString(),Error(`Minified Lexical error #${e}; visit ${n.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}export{e as default};
+function e(e,...r){throw function(e,...r){const n=new URL("https://lexical.dev/docs/error"),o=new URLSearchParams;o.append("code",e);for(const e of r)o.append("v",e);return n.search=o.toString(),new Error(`Minified Lexical error #${e}; visit ${n.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}(e,...r)}export{e as default};

package/dist/LexicalInternalVersion.dev.js

@@ -15,9 +15,9 @@
  */
 
 /**
- * `"0.51.1-nightly.20260925.0+dev.esm"` is statically replaced with the build-specific
+ * `"0.52.0+dev.esm"` 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 `"0.51.1-nightly.20260925.0+dev.esm"` member
+ * inject it the same way — so the exact `"0.52.0+dev.esm"` 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
@@ -35,7 +35,7 @@
 function readLexicalVersion() {
   let envLexicalVersion;
   try {
-    envLexicalVersion = "0.51.1-nightly.20260925.0+dev.esm";
+    envLexicalVersion = "0.52.0+dev.esm";
   } catch {
     // `process` is not defined in some browser bundles; use the fallback.
   }

package/dist/LexicalInternalVersion.prod.js

@@ -6,4 +6,4 @@
  *
  */
 
-function n(){let n;try{n="0.51.1-nightly.20260925.0+prod.esm"}catch{}return n??'"<unknown>+source"'}const t=/* @__PURE__ */n();export{t as LEXICAL_VERSION};
+function n(){let n;try{n="0.52.0+prod.esm"}catch{}return n??'"<unknown>+source"'}const t=/* @__PURE__ */n();export{t as LEXICAL_VERSION};

package/dist/createDevError.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 createDevError(message: string): Error;

package/dist/createError.d.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.
+ *
+ */
+/**
+ * Construct an error without throwing it. Like invariant, the message must be
+ * a literal with %s placeholders so builds can replace it with an error code.
+ * The source implementation also works without the build transform.
+ */
+export default function createError(message: string, ...args: string[]): Error;

package/dist/createProdError.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 createProdError(code: string, ...args: string[]): Error;

package/package.json

@@ -8,7 +8,7 @@
     "internal"
   ],
   "license": "MIT",
-  "version": "0.51.1-nightly.20260925.0",
+  "version": "0.52.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/facebook/lexical.git",
@@ -16,6 +16,54 @@
   },
   "sideEffects": false,
   "exports": {
+    "./createDevError": {
+      "source": "./src/createDevError.ts",
+      "types@<5.2": "./dist/typescript-too-old.d.ts",
+      "types": "./dist/createDevError.d.ts",
+      "development": "./dist/LexicalInternalCreateDevError.dev.js",
+      "production": "./dist/LexicalInternalCreateDevError.prod.js",
+      "default": "./dist/LexicalInternalCreateDevError.js"
+    },
+    "./createDevError.js": {
+      "source": "./src/createDevError.ts",
+      "types@<5.2": "./dist/typescript-too-old.d.ts",
+      "types": "./dist/createDevError.d.ts",
+      "development": "./dist/LexicalInternalCreateDevError.dev.js",
+      "production": "./dist/LexicalInternalCreateDevError.prod.js",
+      "default": "./dist/LexicalInternalCreateDevError.js"
+    },
+    "./createError": {
+      "source": "./src/createError.ts",
+      "types@<5.2": "./dist/typescript-too-old.d.ts",
+      "types": "./dist/createError.d.ts",
+      "development": "./dist/LexicalInternalCreateError.dev.js",
+      "production": "./dist/LexicalInternalCreateError.prod.js",
+      "default": "./dist/LexicalInternalCreateError.js"
+    },
+    "./createError.js": {
+      "source": "./src/createError.ts",
+      "types@<5.2": "./dist/typescript-too-old.d.ts",
+      "types": "./dist/createError.d.ts",
+      "development": "./dist/LexicalInternalCreateError.dev.js",
+      "production": "./dist/LexicalInternalCreateError.prod.js",
+      "default": "./dist/LexicalInternalCreateError.js"
+    },
+    "./createProdError": {
+      "source": "./src/createProdError.ts",
+      "types@<5.2": "./dist/typescript-too-old.d.ts",
+      "types": "./dist/createProdError.d.ts",
+      "development": "./dist/LexicalInternalCreateProdError.dev.js",
+      "production": "./dist/LexicalInternalCreateProdError.prod.js",
+      "default": "./dist/LexicalInternalCreateProdError.js"
+    },
+    "./createProdError.js": {
+      "source": "./src/createProdError.ts",
+      "types@<5.2": "./dist/typescript-too-old.d.ts",
+      "types": "./dist/createProdError.d.ts",
+      "development": "./dist/LexicalInternalCreateProdError.dev.js",
+      "production": "./dist/LexicalInternalCreateProdError.prod.js",
+      "default": "./dist/LexicalInternalCreateProdError.js"
+    },
     "./devInvariant": {
       "source": "./src/devInvariant.ts",
       "types@<5.2": "./dist/typescript-too-old.d.ts",

package/src/createDevError.ts

@@ -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.
+ *
+ */
+
+// Used by the error-message transform. Call createError in source.
+export default function createDevError(message: string): Error {
+  return new Error(message);
+}

package/src/createError.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 createDevError from './createDevError';
+
+/**
+ * Construct an error without throwing it. Like invariant, the message must be
+ * a literal with %s placeholders so builds can replace it with an error code.
+ * The source implementation also works without the build transform.
+ */
+export default function createError(message: string, ...args: string[]): Error {
+  let index = 0;
+  return createDevError(
+    args.length === 0
+      ? message
+      : message.replace(/%s/g, () => String(args[index++])),
+  );
+}

package/src/createProdError.ts

@@ -0,0 +1,25 @@
+/**
+ * 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.
+ *
+ */
+
+// Used by the error-message transform. Call createError or invariant in source.
+export default function createProdError(
+  code: string,
+  ...args: string[]
+): Error {
+  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();
+
+  return new 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/formatProdErrorMessage.ts

@@ -6,6 +6,8 @@
  *
  */
 
+import createProdError from './createProdError';
+
 // Do not require this module directly! Use normal `invariant` calls with
 // template literal strings. The messages will be replaced with error codes
 // during build.
@@ -14,15 +16,5 @@ 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.`,
-  );
+  throw createProdError(code, ...args);
 }