@matfsw/docusaurus-plantuml-plugin 1.0.2 → 1.1.0

package/dist/theme/codeBlockMeta.js

@@ -81,6 +81,27 @@ export function parseBooleanMeta(props, key) {
         return false;
     return undefined;
 }
+/**
+ * Reads a `key=value` pair from the fence metastring, accepting `engine=neato`,
+ * `engine="neato"` and `engine='neato'` alike.
+ *
+ * Unlike {@link parseBooleanMeta} this runs against the raw metastring, because the value it
+ * is looking for may itself be the quoted part. Returns `undefined` when the key is absent or
+ * carries no value, which the caller reads as "fall back to the plugin option".
+ */
+export function parseStringMeta(props, key) {
+    const metastring = props.metastring;
+    if (typeof metastring !== 'string' || metastring === '')
+        return undefined;
+    // Word boundaries by hand, matching parseBooleanMeta: `subengine=` must not match `engine`.
+    const pattern = new RegExp(`(?:^|\\s)${key}=(?:"([^"]*)"|'([^']*)'|(\\S+))(?=\\s|$)`, 'i');
+    const match = pattern.exec(metastring);
+    if (!match)
+        return undefined;
+    const value = match[1] ?? match[2] ?? match[3];
+    const trimmed = value?.trim();
+    return trimmed !== undefined && trimmed !== '' ? trimmed : undefined;
+}
 /** Reads `title="..."` (or `title='...'`) from the fence metastring. */
 export function parseTitle(props) {
     if (typeof props.title === 'string' && props.title !== '')

package/dist/theme/usePlantUmlConfig.d.ts

@@ -1,4 +1,4 @@
-import type { ResolvedPlantUmlOptions } from '../options.js';
+import { type ResolvedPlantUmlOptions } from '../options.js';
 export interface PlantUmlRuntimeConfig {
     options: ResolvedPlantUmlOptions;
     /** Absolute, `baseUrl`-prefixed URL of the directory holding the runtime assets. */

package/dist/theme/usePlantUmlConfig.js

@@ -2,6 +2,7 @@ import { useMemo } from 'react';
 import useBaseUrl from '@docusaurus/useBaseUrl';
 import { useAllPluginInstancesData } from '@docusaurus/useGlobalData';
 import { PLUGIN_NAME } from '../constants.js';
+import { DEFAULT_GRAPHVIZ_OPTIONS } from '../options.js';
 function isGlobalData(value) {
     if (typeof value !== 'object' || value === null)
         return false;
@@ -25,5 +26,23 @@ export function usePlantUmlConfig() {
     // Memoized because consumers use this object as an effect dependency. Returning a fresh
     // object on every render would restart the render effect on every state update, which
     // re-enters rendering forever.
-    return useMemo(() => (first ? { options: first.options, assetsBaseUrl, coreVersion: first.coreVersion } : null), [first, assetsBaseUrl]);
+    return useMemo(() => first
+        ? {
+            options: withGraphvizDefaults(first.options),
+            assetsBaseUrl,
+            coreVersion: first.coreVersion,
+        }
+        : null, [first, assetsBaseUrl]);
+}
+/**
+ * Fills in the `graphviz` group when it is missing from global data.
+ *
+ * `resolveOptions` always produces it, so this only matters for data written by an older
+ * version of the plugin — a stale `.docusaurus` cache surviving an upgrade, most plausibly.
+ * Substituting the defaults keeps such a site rendering instead of failing on a missing key.
+ */
+function withGraphvizDefaults(options) {
+    if (options.graphviz)
+        return options;
+    return { ...options, graphviz: DEFAULT_GRAPHVIZ_OPTIONS };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matfsw/docusaurus-plantuml-plugin",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Render PlantUML diagrams in Docusaurus 3 entirely in the browser - no Java, no PlantUML server, no CDN.",
   "keywords": [
     "docusaurus",
@@ -41,7 +41,7 @@
     "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.9.0"
   },
   "scripts": {
     "clean": "node scripts/clean.mjs",
@@ -70,7 +70,7 @@
   },
   "dependencies": {
     "@plantuml/core": "^1.2026.6",
-    "copy-webpack-plugin": "^12.0.2",
+    "copy-webpack-plugin": "^14.0.0",
     "dompurify": "^3.2.7"
   },
   "peerDependencies": {
@@ -91,19 +91,19 @@
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
-    "@types/node": "^22.18.13",
-    "@types/react": "^18.3.27",
-    "@types/react-dom": "^18.3.7",
+    "@types/node": "^26.1.2",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
     "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
-    "globals": "^16.5.0",
+    "globals": "^17.9.0",
     "jsdom": "^26.1.0",
     "prettier": "^3.6.2",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "tsup": "^8.5.0",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.46.4",