use latest docusaurus

lebalz · lebalz · commit c30a6ff17a83 · 2026-01-01T18:31:53.000+01:00
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
@@ -0,0 +1,38 @@
+{
+    "name": "docusaurus-live-brython",
+    "image": "mcr.microsoft.com/devcontainers/typescript-node:24-bookworm",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "pomdtr.excalidraw-editor",
+                "zhuangtongfa.Material-theme",
+                "mhutchie.git-graph",
+                "esbenp.prettier-vscode",
+                "dbaeumer.vscode-eslint",
+                "unifiedjs.vscode-mdx",
+                "motivesoft.vscode-uuid-generator",
+                "lukas-tr.materialdesignicons-intellisense"
+            ],
+            "settings": {
+                "workbench.colorTheme": "One Dark Pro",
+                "extensions.ignoreRecommendations": true,
+                "git.autofetch": true,
+                "editor.tabSize": 4,
+                "[mdx]": {
+                    "editor.defaultFormatter": "unifiedjs.vscode-mdx"
+                }
+            }
+        }
+    },
+    "remoteEnv": {
+        "OFFLINE_API": "true"
+    },
+    "postStartCommand": "yarn install",
+    "forwardPorts": [3000],
+    "features": {
+        "ghcr.io/devcontainers/features/node:1": {
+            "version": "24.12"
+        }
+    },
+    "runArgs": ["--network=host"]
+}
diff --git a/README.md b/README.md
@@ -117,6 +117,9 @@ yarn link docusaurus-live-brython
 
 Then start the website
 ```sh
+# in root
+yarn run watch
+# in website/
 yarn run start
 ```
 
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-live-brython",
-  "version": "3.0.0-beta.28",
+  "version": "3.0.1",
   "description": "Docusaurus live code block component for python.",
   "publishConfig": {
     "access": "public"
@@ -132,8 +132,8 @@
     "typescript": "^5.4.5"
   },
   "peerDependencies": {
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
   },
   "engines": {
     "node": ">=18"
diff --git a/src/options.ts b/src/options.ts
@@ -47,8 +47,8 @@ export type ThemeOptions = {
 export type Options = Partial<ThemeOptions>;
 
 export const DEFAULT_OPTIONS: ThemeOptions = {
-    brythonSrc: 'https://cdn.jsdelivr.net/npm/brython@3.12.4/brython.min.js',
-    brythonStdlibSrc: 'https://cdn.jsdelivr.net/npm/brython@3.12.4/brython_stdlib.js',
+    brythonSrc: 'https://cdn.jsdelivr.net/npm/brython@3.14/brython.min.js',
+    brythonStdlibSrc: 'https://cdn.jsdelivr.net/npm/brython@3.14/brython_stdlib.js',
     libDir: '/bry-libs/',
     skipCopyAssetsToLibDir: false,
     syncMaxOnceEvery: 1000
diff --git a/src/theme/CodeBlock/index.tsx b/src/theme/CodeBlock/index.tsx
@@ -34,18 +34,18 @@ const extractMetaProps = (props: { metastring?: string }): MetaProps => {
                 value === 'true'
                     ? true
                     : value === 'false'
-                      ? false
-                      : !Number.isNaN(Number(value))
-                        ? Number(value)
-                        : value || true;
+                        ? false
+                        : !Number.isNaN(Number(value))
+                            ? Number(value)
+                            : value || true;
             acc[key] = val;
             return acc;
         },
         {} as { [key: string]: number | string | boolean }
     );
 };
 
-export default function CodeBlockWrapper(props: Props): JSX.Element {
+export default function CodeBlockWrapper(props: Props): React.ReactNode {
     const metaProps = extractMetaProps(props);
     const langMatch = ((props.className || '') as string).match(/language-(?<lang>\w*)/);
     let lang = langMatch?.groups?.lang?.toLocaleLowerCase() ?? '';
diff --git a/src/theme/CodeEditor/Editor/Result/Graphics/index.tsx b/src/theme/CodeEditor/Editor/Result/Graphics/index.tsx
@@ -7,8 +7,8 @@ import { useStore, useScript } from '@theme/CodeEditor/hooks';
 import Button from '@theme/CodeEditor/Button';
 import clsx from 'clsx';
 export interface Props {
-    controls?: JSX.Element;
-    main?: JSX.Element;
+    controls?: React.ReactNode;
+    main?: React.ReactNode;
 }
 const Graphics = (props: Props) => {
     const store = useStore();
diff --git a/src/typings.d.ts b/src/typings.d.ts
@@ -7,5 +7,5 @@ declare module '@theme/Details' {
     readonly children: ReactNode;
     [key: string]: any;
   }
-  export default function Details(props: Props): JSX.Element;
+  export default function Details(props: Props): React.ReactNode;
 }
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
@@ -10,7 +10,6 @@ const config: Config = {
     url: 'https://lebalz.github.io',
     baseUrl: BASE_URL,
     onBrokenLinks: 'throw',
-    onBrokenMarkdownLinks: 'warn',
     favicon: 'img/favicon.ico',
     organizationName: 'lebalz', // Usually your GitHub org/user name.
     projectName: 'docusaurus-live-brython', // Usually your repo name.
@@ -20,9 +19,15 @@ const config: Config = {
         locales: ['en', 'zh-Hant']
     },
     future: {
+        v4: true,
         experimental_faster: true,
         experimental_router: 'browser',
     },
+    markdown: {
+        hooks: {
+            onBrokenMarkdownLinks: 'warn',
+        }
+    },
     themeConfig: {
         navbar: {
             title: 'Live Brython',
diff --git a/website/package.json b/website/package.json
@@ -14,10 +14,10 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.6.3",
-    "@docusaurus/faster": "^3.6.3",
-    "@docusaurus/preset-classic": "^3.6.3",
-    "@docusaurus/tsconfig": "^3.6.3",
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/faster": "^3.9.2",
+    "@docusaurus/preset-classic": "^3.9.2",
+    "@docusaurus/tsconfig": "^3.9.2",
     "@mdx-js/react": "3.0.1",
     "clsx": "^2.1.1",
     "docusaurus-live-brython": "link:../lib/",
@@ -39,9 +39,12 @@
     ]
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.6.3",
-    "@docusaurus/types": "^3.6.3",
+    "@docusaurus/module-type-aliases": "^3.9.2",
+    "@docusaurus/types": "^3.9.2",
     "@types/react": "^18.3.1",
     "typescript": "^5.2.2"
+  },
+  "resolutions": {
+    "@rspack/core": "1.6.5"
   }
 }
diff --git a/website/src/components/BrowserWindow/index.tsx b/website/src/components/BrowserWindow/index.tsx
@@ -25,7 +25,7 @@ export default function BrowserWindow({
     url = 'http://localhost:3000',
     style,
     bodyStyle
-}: Props): JSX.Element {
+}: Props): React.ReactNode {
     return (
         <div className={styles.browserWindow} style={{ ...style, minHeight }}>
             <div className={styles.browserWindowHeader}>
diff --git a/website/src/components/HomepageFeatures/index.tsx b/website/src/components/HomepageFeatures/index.tsx
@@ -6,7 +6,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 type FeatureItem = {
     title: string;
     Img?: string;
-    description: JSX.Element;
+    description: React.ReactNode;
 };
 
 const FeatureList: FeatureItem[] = [
@@ -54,7 +54,7 @@ function Feature({ title, Img, description }: FeatureItem) {
     );
 }
 
-export default function HomepageFeatures(): JSX.Element {
+export default function HomepageFeatures(): React.ReactNode {
     return (
         <section className={styles.features}>
             <div className="container">
diff --git a/website/src/pages/index.tsx b/website/src/pages/index.tsx
@@ -39,7 +39,7 @@ function HomepageHeader() {
     );
 }
 
-export default function Home(): JSX.Element {
+export default function Home(): React.ReactNode {
     const { siteConfig } = useDocusaurusContext();
     return (
         <Layout title={'Interactive Python Codeblocks'} description={siteConfig.tagline}>
diff --git a/website/src/pages/snippets.tsx b/website/src/pages/snippets.tsx
@@ -52,7 +52,7 @@ const encodeSnippet = (snippet: CodeSnippet): string => {
     return encodeURIComponent(encodeToBase64(JSON.stringify(snippet)));
 };
 
-function Snippet(): JSX.Element {
+function Snippet(): React.ReactNode {
     const [code, setCode] = React.useState('');
     const [init, setInit] = React.useState<CodeSnippet>({ ...DEFAULT_SNIPPET });
     const [title, setTitle] = React.useState('');
@@ -126,7 +126,7 @@ export default function SnippetPage(): JSX.Element {
     }, [copyied]);
 
     return (
-        <Layout 
+        <Layout
             title={'Interactive Python Codeblocks'}
             description={
                 `Create, execute, and share your Python code seamlessly in your browser using our interactive playground. Perfect for coding enthusiasts and learners alike!`
diff --git a/website/yarn.lock b/website/yarn.lock
diff --git a/yarn.lock b/yarn.lock

Original file line number	Diff line number	Diff line change
`@@ -7,5 +7,5 @@ declare module '@theme/Details' {`
`7`	`7`	`readonly children: ReactNode;`
`8`	`8`	`[key: string]: any;`
`9`	`9`	`}`
`10`		`- export default function Details(props: Props): JSX.Element;`
	`10`	`+ export default function Details(props: Props): React.ReactNode;`
`11`	`11`	`}`