TypeCellOS · YousefED · Oct 13, 2025 · Oct 13, 2025 · Oct 16, 2025 · Oct 16, 2025
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -1,6 +1,9 @@
 {
   "editor.defaultFormatter": "esbenp.prettier-vscode",
   "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.addMissingImports": "explicit"
+  },
   "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
   "[typescriptreact]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"

diff --git a/examples/01-basic/01-minimal/package.json b/examples/01-basic/01-minimal/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/02-block-objects/package.json b/examples/01-basic/02-block-objects/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/03-multi-column/package.json b/examples/01-basic/03-multi-column/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "@blocknote/xl-multi-column": "latest"
   },
   "devDependencies": {

diff --git a/examples/01-basic/04-default-blocks/package.json b/examples/01-basic/04-default-blocks/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/05-removing-default-blocks/package.json b/examples/01-basic/05-removing-default-blocks/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/06-block-manipulation/package.json b/examples/01-basic/06-block-manipulation/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/07-selection-blocks/package.json b/examples/01-basic/07-selection-blocks/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/08-ariakit/package.json b/examples/01-basic/08-ariakit/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/09-shadcn/package.json b/examples/01-basic/09-shadcn/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "tailwindcss": "^4.1.12",
     "tw-animate-css": "^1.3.7"
   },

diff --git a/examples/01-basic/10-localization/package.json b/examples/01-basic/10-localization/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/11-custom-placeholder/package.json b/examples/01-basic/11-custom-placeholder/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/12-multi-editor/package.json b/examples/01-basic/12-multi-editor/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/13-custom-paste-handler/package.json b/examples/01-basic/13-custom-paste-handler/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/01-basic/testing/package.json b/examples/01-basic/testing/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/02-backend/01-file-uploading/package.json b/examples/02-backend/01-file-uploading/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/02-backend/02-saving-loading/package.json b/examples/02-backend/02-saving-loading/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/02-backend/03-s3/package.json b/examples/02-backend/03-s3/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "@aws-sdk/client-s3": "^3.609.0",
     "@aws-sdk/s3-request-presigner": "^3.609.0"
   },

diff --git a/examples/02-backend/04-rendering-static-documents/package.json b/examples/02-backend/04-rendering-static-documents/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "@blocknote/server-util": "latest"
   },
   "devDependencies": {

diff --git a/examples/03-ui-components/01-ui-elements-remove/package.json b/examples/03-ui-components/01-ui-elements-remove/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/03-ui-components/02-formatting-toolbar-buttons/package.json b/examples/03-ui-components/02-formatting-toolbar-buttons/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/03-ui-components/03-formatting-toolbar-block-type-items/package.json b/examples/03-ui-components/03-formatting-toolbar-block-type-items/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "react-icons": "^5.2.1"
   },
   "devDependencies": {

diff --git a/examples/03-ui-components/03-formatting-toolbar-block-type-items/src/Alert.tsx b/examples/03-ui-components/03-formatting-toolbar-block-type-items/src/Alert.tsx
@@ -1,8 +1,9 @@
-import { defaultProps } from "@blocknote/core";
 import { createReactBlockSpec } from "@blocknote/react";
 import { Menu } from "@mantine/core";
 import { MdCancel, MdCheckCircle, MdError, MdInfo } from "react-icons/md";
+import { z } from "zod/v4";
 
+import { createPropSchemaFromZod, defaultZodPropSchema } from "@blocknote/core";
 import "./styles.css";
 
 // The types of alerts that users can choose from.
@@ -53,14 +54,18 @@ export const alertTypes = [
 export const Alert = createReactBlockSpec(
   {
     type: "alert",
-    propSchema: {
-      textAlignment: defaultProps.textAlignment,
-      textColor: defaultProps.textColor,
-      type: {
-        default: "warning",
-        values: ["warning", "error", "info", "success"],
-      },
-    },
+    propSchema: createPropSchemaFromZod(
+      defaultZodPropSchema
+        .pick({
+          textAlignment: true,
+          textColor: true,
+        })
+        .extend({
+          type: z
+            .enum(["warning", "error", "info", "success"])
+            .default("warning"),
+        }),
+    ),
     content: "inline",
   },
   {

diff --git a/examples/03-ui-components/04-side-menu-buttons/package.json b/examples/03-ui-components/04-side-menu-buttons/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "react-icons": "^5.2.1"
   },
   "devDependencies": {

diff --git a/examples/03-ui-components/05-side-menu-drag-handle-items/package.json b/examples/03-ui-components/05-side-menu-drag-handle-items/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "react-icons": "^5.2.1"
   },
   "devDependencies": {

diff --git a/examples/03-ui-components/06-suggestion-menus-slash-menu-items/package.json b/examples/03-ui-components/06-suggestion-menus-slash-menu-items/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "react-icons": "^5.2.1"
   },
   "devDependencies": {

diff --git a/examples/03-ui-components/07-suggestion-menus-slash-menu-component/package.json b/examples/03-ui-components/07-suggestion-menus-slash-menu-component/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/03-ui-components/08-suggestion-menus-emoji-picker-columns/package.json b/examples/03-ui-components/08-suggestion-menus-emoji-picker-columns/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/03-ui-components/09-suggestion-menus-emoji-picker-component/package.json b/examples/03-ui-components/09-suggestion-menus-emoji-picker-component/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/03-ui-components/10-suggestion-menus-grid-mentions/package.json b/examples/03-ui-components/10-suggestion-menus-grid-mentions/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/03-ui-components/10-suggestion-menus-grid-mentions/src/Mention.tsx b/examples/03-ui-components/10-suggestion-menus-grid-mentions/src/Mention.tsx
@@ -1,14 +1,16 @@
+import { createPropSchemaFromZod } from "@blocknote/core";
 import { createReactInlineContentSpec } from "@blocknote/react";
+import { z } from "zod/v4";
 
 // The Mention inline content.
 export const Mention = createReactInlineContentSpec(
   {
     type: "mention",
-    propSchema: {
-      user: {
-        default: "Unknown",
-      },
-    },
+    propSchema: createPropSchemaFromZod(
+      z.object({
+        user: z.string().default("Unknown"),
+      }),
+    ),
     content: "none",
   },
   {

diff --git a/examples/03-ui-components/11-uppy-file-panel/package.json b/examples/03-ui-components/11-uppy-file-panel/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "@uppy/core": "^3.13.1",
     "@uppy/dashboard": "^3.9.1",
     "@uppy/drag-drop": "^3.1.1",

diff --git a/examples/03-ui-components/11-uppy-file-panel/src/FileReplaceButton.tsx b/examples/03-ui-components/11-uppy-file-panel/src/FileReplaceButton.tsx
@@ -1,8 +1,11 @@
 import {
-  BlockSchema,
+  baseFileZodPropSchema,
   blockHasType,
+  BlockSchema,
   InlineContentSchema,
+  optionalFileZodPropSchema,
   StyleSchema,
+  createPropSchemaFromZod
 } from "@blocknote/core";
 import {
   useBlockNoteEditor,
@@ -41,7 +44,15 @@ export const FileReplaceButton = () => {
 
   if (
     block === undefined ||
-    !blockHasType(block, editor, "file", { url: "string" }) ||
+    !blockHasType(
+      block,
+      editor,
+      block.type,
+      // TODO
+      createPropSchemaFromZod(baseFileZodPropSchema.extend({
+        ...optionalFileZodPropSchema.pick({ url: true }).shape,
+      })),
+    ) ||
     !editor.isEditable
   ) {
     return null;

diff --git a/examples/03-ui-components/12-static-formatting-toolbar/package.json b/examples/03-ui-components/12-static-formatting-toolbar/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",

diff --git a/examples/03-ui-components/13-custom-ui/package.json b/examples/03-ui-components/13-custom-ui/package.json
@@ -21,6 +21,7 @@
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "zod": "^4.0.0",
     "@emotion/react": "^11.11.4",
     "@emotion/styled": "^11.11.5",
     "@mui/icons-material": "^5.16.1",

diff --git a/examples/03-ui-components/14-experimental-mobile-formatting-toolbar/package.json b/examples/03-ui-components/14-experimental-mobile-formatting-toolbar/package.json
@@ -20,7 +20,8 @@
     "@mantine/hooks": "^8.3.4",
     "@mantine/utils": "^6.0.22",
     "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react-dom": "^19.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",