@ckeditor/ckeditor5-dev-manual-server 56.5.0 → 57.0.0-alpha.0

package/dist/debug-plugin/plugin.d.ts

@@ -0,0 +1,6 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md.
+*/
+import type { Plugin } from "vite";
+export declare function ckDebugPlugin(): Plugin;

package/dist/index.d.ts

@@ -4,6 +4,7 @@
 */
 export { manualTestsPlugin } from "./manual-test-plugin/plugin.js";
 export type { ManualData, ManualTestsPluginOptions } from "./manual-test-plugin/plugin.js";
+export { ckDebugPlugin } from "./debug-plugin/plugin.js";
 export { refreshPlugin } from "./refresh-plugin/plugin.js";
 export { rawHtmlPlugin } from "./raw-plugin/plugin.js";
 export { stringifyValues } from "./utils.js";

package/dist/index.js

@@ -514,6 +514,41 @@ function getRequiredElementByTagName(root, tagName) {
 	return query(root, (candidate) => isElementNode(candidate) && candidate.tagName == tagName);
 }
 //#endregion
+//#region src/debug-plugin/plugin.ts
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md.
+*/
+const SOURCE_FILE_REGEXP = /\.[cm]?[jt]sx?$/;
+function ckDebugPlugin() {
+	const debugFlags = getDebugFlags(process.env.CK_DEBUG);
+	const plugin = {
+		name: "ck-debug",
+		enforce: "pre"
+	};
+	if (!debugFlags.size) return plugin;
+	return {
+		...plugin,
+		transform: {
+			filter: { id: { include: SOURCE_FILE_REGEXP } },
+			handler(code) {
+				if (!code.includes("// @if ")) return null;
+				const transformedCode = code.replace(/(^[ \t]*)\/\/ @if (!?[\w]+) \/\/(.*)$/gm, (match, indentation, flagName, body) => {
+					if (!debugFlags.has(flagName)) return match;
+					return `${indentation}/* @if ${flagName} */${body}`;
+				});
+				return transformedCode === code ? null : transformedCode;
+			}
+		}
+	};
+}
+function getDebugFlags(debugOption = "") {
+	if (debugOption === "false") return /* @__PURE__ */ new Set();
+	const flags = /* @__PURE__ */ new Set(["CK_DEBUG"]);
+	debugOption.split(",").map((flag) => flag.trim()).filter(Boolean).forEach((flag) => flags.add(`CK_DEBUG_${flag.toUpperCase()}`));
+	return flags;
+}
+//#endregion
 //#region src/refresh-plugin/plugin.ts
 /**
 * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
@@ -627,4 +662,4 @@ function getFilePathFromId(id) {
 * For licensing, see LICENSE.md.
 */
 //#endregion
-export { manualTestsPlugin, rawHtmlPlugin, refreshPlugin, stringifyValues };
+export { ckDebugPlugin, manualTestsPlugin, rawHtmlPlugin, refreshPlugin, stringifyValues };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-dev-manual-server",
-  "version": "56.5.0",
+  "version": "57.0.0-alpha.0",
   "description": "Used to extend Vite to create a manual test server for CKEditor 5.",
   "keywords": [],
   "author": "CKSource (http://cksource.com/)",

package/theme/shell.ts

@@ -35,6 +35,8 @@ if ( globalTarget.editor instanceof Element ) {
 globalTarget.CKEditorInspector ||= CKEditorInspector;
 globalTarget.CKEDITOR_GLOBAL_LICENSE_KEY ||= LICENSE_KEY;
 
+autoAttachInspector();
+
 /**
  * Clones the injected Shell template, fills it with current test metadata,
  * and prepends it to the page before the test content is wrapped.
@@ -105,6 +107,24 @@ function setupManualRefreshPrompt(): void {
 	} );
 }
 
+function autoAttachInspector(): void {
+	let editor = globalTarget.editor;
+
+	Object.defineProperty( globalTarget, 'editor', {
+		configurable: true,
+		set( value ) {
+			editor = value;
+
+			if ( editor ) {
+				CKEditorInspector.attach( editor );
+			}
+		},
+		get() {
+			return editor;
+		}
+	} );
+}
+
 /**
  * Opens or closes the instructions panel and synchronizes related accessibility state.
  */