docusaurus-plugin-myog 0.1.0 → 0.2.0

package/README.md

@@ -13,12 +13,16 @@ the image service requires a paid plan or card trial.
 
 ## Requirements and tested support
 
-- Docusaurus **3.10.2**. The peer and runtime checks require that exact release.
-  Other releases need compatibility verification before widening support.
+- Docusaurus **3.10 or a later 3.x release**: stable `@docusaurus/core`
+  `>=3.10.0 <4.0.0`. Tested with 3.10.0 and 3.10.2. The runtime check rejects
+  older releases, prereleases and Docusaurus 4, which is not supported yet.
+- Docusaurus 3.10.0 itself fails plain webpack builds with webpack 5.106 or
+  newer, before any plugin runs (its webpackbar 6 dependency). 3.10.1 fixed
+  this. Use 3.10.1 or later, or Rspack.
 - Tested with the classic preset, React/react-dom **19.3.1** and **18.3.1**,
   Node.js **24.1.0** and **20.11.0**, plain **webpack** and **Rspack** builds.
-  Rspack uses `@docusaurus/faster` 3.10.2 with `future.v4: true`; the webpack
-  fixture explicitly disables `future.v4` and `future.faster`.
+  Rspack uses `@docusaurus/faster` at the core version with `future.v4: true`;
+  the webpack fixture explicitly disables `future.v4` and `future.faster`.
   These are representative combinations, not every combination of those values.
 - Node.js 20.11.0 or newer is required. Later Node releases are not all tested.
 - A MyOG account with the site's domain registered and an active subscription
@@ -31,17 +35,16 @@ the image service requires a paid plan or card trial.
 The integration uses the documented `configureWebpack` hook, but remapping the
 resolved theme alias and relying on core App's metadata render order are
 **undocumented internal contracts**. The build fails if the required alias is
-missing, unsafe to wrap, or the core version is unsupported. Keep this exact
-Docusaurus version until a newer release has been checked. See
+missing, unsafe to wrap, or the core version is unsupported. See
 [DEVELOPMENT.md](https://github.com/MyOG-social/docusaurus-plugin-myog/blob/main/DEVELOPMENT.md)
 for the verification recipe.
 
 ## Install
 
-In your Docusaurus 3.10.2 site:
+In your Docusaurus 3.10+ site:
 
 ```sh
-pnpm add --save-exact docusaurus-plugin-myog@0.1.0
+pnpm add docusaurus-plugin-myog@^0.2.0
 ```
 
 Add the plugin to `docusaurus.config.ts` (or `.js`):

package/lib/siteMetadata.d.ts

@@ -1,3 +1,4 @@
+export declare const SUPPORTED_CORE_RANGE = ">=3.10.0 <4.0.0";
 export declare function assertSupportedVersion(version: string): void;
 export declare function wrapSiteMetadata({ aliases, wrapper }: {
     aliases: unknown;

package/lib/siteMetadata.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_CORE_RANGE = void 0;
 exports.assertSupportedVersion = assertSupportedVersion;
 exports.wrapSiteMetadata = wrapSiteMetadata;
 const node_path_1 = require("node:path");
 const options_1 = require("./options");
+exports.SUPPORTED_CORE_RANGE = ">=3.10.0 <4.0.0";
 function assertSupportedVersion(version) {
-    if (version !== "3.10.2") {
-        throw new Error(`[${options_1.PLUGIN_NAME}] Docusaurus ${version} is not supported. Use @docusaurus/core 3.10.2 or remove this plugin and use the manual guide at https://myog.social/docs/docusaurus. The SiteMetadata integration requires the tested theme alias and App render-order contracts.`);
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
+    if (!match || Number(match[1]) !== 3 || Number(match[2]) < 10) {
+        throw new Error(`[${options_1.PLUGIN_NAME}] Docusaurus ${version} is not supported. Use a stable @docusaurus/core ${exports.SUPPORTED_CORE_RANGE} release or remove this plugin and use the manual guide at https://myog.social/docs/docusaurus. The SiteMetadata integration requires the tested theme alias and App render-order contracts.`);
     }
 }
 function wrapSiteMetadata({ aliases, wrapper }) {
@@ -18,7 +21,7 @@ function wrapSiteMetadata({ aliases, wrapper }) {
         !(0, node_path_1.isAbsolute)(original) ||
         original === wrapper ||
         resolved["@myog-original/SiteMetadata"] !== undefined) {
-        throw new Error(`[${options_1.PLUGIN_NAME}] Cannot wrap the resolved @theme/SiteMetadata alias safely. Use Docusaurus 3.10.2 and remove competing SiteMetadata alias remaps, or remove this plugin and use https://myog.social/docs/docusaurus. No fallback is substituted because it could discard your site's metadata.`);
+        throw new Error(`[${options_1.PLUGIN_NAME}] Cannot wrap the resolved @theme/SiteMetadata alias safely. Use a supported Docusaurus release (>=3.10.0 <4.0.0) and remove competing SiteMetadata alias remaps, or remove this plugin and use https://myog.social/docs/docusaurus. No fallback is substituted because it could discard your site's metadata.`);
     }
     return {
         resolve: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-plugin-myog",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Adds a MyOG.social og:image and twitter:image to every Docusaurus page, generated from each page's URL",
   "keywords": [
     "docusaurus",
@@ -28,8 +28,8 @@
     "node": ">=20.11.0"
   },
   "peerDependencies": {
-    "@docusaurus/core": "3.10.2",
-    "@docusaurus/types": "3.10.2",
+    "@docusaurus/core": ">=3.10.0 <4.0.0",
+    "@docusaurus/types": ">=3.10.0 <4.0.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {