@fecommunity/reactpress 4.0.0-beta.1 → 4.0.0-beta.10

package/toolkit/dist/plugin/dev/portRedirect.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEME_PREVIEW_DEV_PORTS = void 0;
+exports.isThemePreviewDevPort = isThemePreviewDevPort;
+exports.resolveDevPortRole = resolveDevPortRole;
+exports.isUnifiedNginxEntryEnabled = isUnifiedNginxEntryEnabled;
+exports.isNginxDevRedirectEnabled = isNginxDevRedirectEnabled;
+exports.resolveNginxEntryUrl = resolveNginxEntryUrl;
+exports.isDirectDevPortAccess = isDirectDevPortAccess;
+exports.shouldRedirectDevPortToNginx = shouldRedirectDevPortToNginx;
+exports.buildDevPortRedirectUrl = buildDevPortRedirectUrl;
+const DEFAULT_NGINX_PORT = 80;
+/** Admin theme preview pool — must not redirect to nginx visitor (active theme). */
+exports.THEME_PREVIEW_DEV_PORTS = [3003, 3004, 3005, 3006, 3007, 3008];
+function isThemePreviewDevPort(port) {
+    return Number.isInteger(port) && exports.THEME_PREVIEW_DEV_PORTS.includes(port);
+}
+function readPortEnv(key, fallback) {
+    const raw = process.env[key]?.trim();
+    if (!raw)
+        return fallback;
+    const parsed = parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function resolveDevPortRole(directPort) {
+    if (isThemePreviewDevPort(directPort))
+        return 'preview';
+    const apiPort = readPortEnv('SERVER_PORT', 3002);
+    const adminPort = readPortEnv('WEB_ADMIN_PORT', 3000);
+    if (directPort === apiPort)
+        return 'api';
+    if (directPort === adminPort)
+        return 'admin';
+    return 'visitor';
+}
+/** Unified nginx entry (:80) — dev (`REACTPRESS_NGINX_ENTRY_URL`) or prod (`NGINX_ENTRY_URL`). */
+function isUnifiedNginxEntryEnabled() {
+    return Boolean(process.env.REACTPRESS_NGINX_ENTRY_URL?.trim() || process.env.NGINX_ENTRY_URL?.trim());
+}
+/** @deprecated Use {@link isUnifiedNginxEntryEnabled} */
+function isNginxDevRedirectEnabled() {
+    return isUnifiedNginxEntryEnabled();
+}
+function resolveNginxEntryUrl() {
+    const override = process.env.REACTPRESS_NGINX_ENTRY_URL?.trim();
+    if (override) {
+        return override.replace(/\/$/, '');
+    }
+    const rawPort = process.env.NGINX_PORT?.trim();
+    const port = rawPort ? parseInt(rawPort, 10) : DEFAULT_NGINX_PORT;
+    if (Number.isFinite(port) && port > 0 && port !== DEFAULT_NGINX_PORT) {
+        return `http://localhost:${port}`;
+    }
+    return 'http://localhost';
+}
+function isDirectDevPortAccess(host, port) {
+    if (!host || !Number.isFinite(port) || port <= 0)
+        return false;
+    const normalized = host.toLowerCase();
+    return (normalized === `localhost:${port}` ||
+        normalized === `127.0.0.1:${port}` ||
+        normalized === `[::1]:${port}`);
+}
+function acceptsHtmlNavigation(accept) {
+    if (!accept)
+        return false;
+    return accept.includes('text/html');
+}
+function shouldRedirectDevPortToNginx(options) {
+    if (process.env.REACTPRESS_SKIP_DEV_PORT_REDIRECT === '1')
+        return false;
+    if (isThemePreviewDevPort(options.directPort))
+        return false;
+    if (!isUnifiedNginxEntryEnabled())
+        return false;
+    const method = (options.method || 'GET').toUpperCase();
+    if (method !== 'GET' && method !== 'HEAD')
+        return false;
+    if (!isDirectDevPortAccess(options.host, options.directPort))
+        return false;
+    if (!acceptsHtmlNavigation(options.accept))
+        return false;
+    const pathname = options.pathname || '/';
+    if (options.skipPathPrefixes?.some((prefix) => pathname.startsWith(prefix))) {
+        return false;
+    }
+    return true;
+}
+function buildDevPortRedirectUrl(options) {
+    const entry = (options.nginxEntryUrl || resolveNginxEntryUrl()).replace(/\/$/, '');
+    const pathname = options.pathname || '/';
+    const search = options.search || '';
+    const role = resolveDevPortRole(options.directPort);
+    if (role === 'api') {
+        if (pathname === '/' || pathname === '') {
+            return `${entry}/api${search}`;
+        }
+        return `${entry}${pathname}${search}`;
+    }
+    if (role === 'admin') {
+        let adminPath = pathname;
+        if (!adminPath.startsWith('/admin')) {
+            adminPath = adminPath === '/' ? '/admin/' : `/admin${adminPath.startsWith('/') ? adminPath : `/${adminPath}`}`;
+        }
+        return `${entry}${adminPath}${search}`;
+    }
+    if (role === 'preview') {
+        return `${entry}${pathname}${search}`;
+    }
+    return `${entry}${pathname}${search}`;
+}

package/toolkit/dist/plugin/dev/vitePortRedirectPlugin.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devPortRedirectPlugin = devPortRedirectPlugin;
+const portRedirect_1 = require("./portRedirect");
+const VITE_DEV_SKIP_PREFIXES = ['/@vite', '/@fs', '/@id', '/node_modules'];
+function createRedirectMiddleware(port) {
+    return (req, res, next) => {
+        const url = req.url || '/';
+        const pathname = url.split('?')[0] || '/';
+        const search = url.includes('?') ? url.slice(url.indexOf('?')) : '';
+        if (!(0, portRedirect_1.shouldRedirectDevPortToNginx)({
+            host: req.headers.host,
+            method: req.method,
+            accept: req.headers.accept,
+            directPort: port,
+            pathname,
+            skipPathPrefixes: VITE_DEV_SKIP_PREFIXES,
+        })) {
+            next();
+            return;
+        }
+        const target = (0, portRedirect_1.buildDevPortRedirectUrl)({
+            directPort: port,
+            pathname,
+            search,
+        });
+        res.statusCode = 302;
+        res.setHeader('Location', target);
+        res.end();
+    };
+}
+/** Redirect direct :3000 browser hits to nginx entry when REACTPRESS_NGINX_ENTRY_URL is set. */
+function devPortRedirectPlugin(port) {
+    return {
+        name: 'reactpress-dev-port-redirect',
+        configureServer(server) {
+            server.middlewares.use(createRedirectMiddleware(port));
+        },
+    };
+}

package/toolkit/dist/plugin/extension/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./plugin-admin-locale"), exports);
+__exportStar(require("./security"), exports);
+__exportStar(require("./validate"), exports);

package/toolkit/dist/plugin/extension/plugin-admin-locale.io.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPluginAdminLocaleFile = readPluginAdminLocaleFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const plugin_admin_locale_1 = require("./plugin-admin-locale");
+function readPluginAdminLocaleFile(pluginDir, locale) {
+    const safeLocale = /^[a-z]{2}(?:-[a-z]{2})?$/i.test(locale) ? locale : 'en';
+    const filePath = path.join(pluginDir, plugin_admin_locale_1.PLUGIN_LOCALE_DIR, `${safeLocale}.json`);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        return raw && typeof raw === 'object' && !Array.isArray(raw)
+            ? raw
+            : null;
+    }
+    catch {
+        return null;
+    }
+}

package/toolkit/dist/plugin/extension/plugin-admin-locale.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNestedLocaleValue = exports.getNestedLocaleString = exports.PLUGIN_LOCALE_DIR = void 0;
+exports.resolvePluginAdminLocaleText = resolvePluginAdminLocaleText;
+exports.localizePluginSettingsSchemaWithLocale = localizePluginSettingsSchemaWithLocale;
+const object_1 = require("../../utils/object");
+Object.defineProperty(exports, "getNestedLocaleString", { enumerable: true, get: function () { return object_1.getNestedLocaleString; } });
+Object.defineProperty(exports, "getNestedLocaleValue", { enumerable: true, get: function () { return object_1.getNestedLocaleValue; } });
+exports.PLUGIN_LOCALE_DIR = 'locales';
+/** Resolve admin copy from plugin locale bundle; falls back to manifest text. */
+function resolvePluginAdminLocaleText(messages, dotPath, fallback) {
+    const fromLocale = messages ? (0, object_1.getNestedLocaleString)(messages, dotPath) : undefined;
+    if (fromLocale)
+        return fromLocale;
+    return fallback?.trim() ?? '';
+}
+function localizeSchemaField(field, pathParts, resolve) {
+    if (typeof field.title === 'string') {
+        field.title = resolve([...pathParts, 'title'].join('.'), field.title);
+    }
+    if (typeof field.description === 'string') {
+        field.description = resolve([...pathParts, 'description'].join('.'), field.description);
+    }
+    if (field.properties) {
+        for (const [key, child] of Object.entries(field.properties)) {
+            localizeSchemaField(child, [...pathParts, key], resolve);
+        }
+    }
+    const items = field.items;
+    if (items && typeof items === 'object' && !Array.isArray(items)) {
+        const itemSchema = items;
+        if (itemSchema.properties) {
+            for (const [key, child] of Object.entries(itemSchema.properties)) {
+                localizeSchemaField(child, [...pathParts, 'items', key], resolve);
+            }
+        }
+        else {
+            localizeSchemaField(itemSchema, [...pathParts, 'items'], resolve);
+        }
+    }
+}
+/** Apply plugin admin locale messages to settings JSON Schema titles/descriptions. */
+function localizePluginSettingsSchemaWithLocale(schema, messages) {
+    if (!schema)
+        return null;
+    const out = structuredClone(schema);
+    const resolve = (dotPath, fallback) => resolvePluginAdminLocaleText(messages, `settings.${dotPath}`, fallback);
+    if (typeof out.title === 'string') {
+        out.title = resolve('title', out.title);
+    }
+    if (typeof out.description === 'string') {
+        out.description = resolve('description', out.description);
+    }
+    if (out.properties) {
+        for (const [key, field] of Object.entries(out.properties)) {
+            localizeSchemaField(field, [key], resolve);
+        }
+    }
+    return out;
+}

package/toolkit/dist/plugin/extension/plugin.js

@@ -0,0 +1,146 @@
+"use strict";
+/** WordPress-style plugin manifest and site plugin state (shared by server / web). */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLUGIN_ADMIN_MODULE_CONVENTION = exports.defaultSitePluginState = void 0;
+exports.isValidPluginId = isValidPluginId;
+exports.parsePluginManifest = parsePluginManifest;
+exports.getPluginStateFromGlobalSetting = getPluginStateFromGlobalSetting;
+exports.mergePluginStateIntoGlobalSetting = mergePluginStateIntoGlobalSetting;
+exports.pluginManifestHasAdminUI = pluginManifestHasAdminUI;
+const slots_1 = require("../admin/slots");
+const security_1 = require("./security");
+exports.defaultSitePluginState = {
+    installedPlugins: [],
+    activePlugins: [],
+    entries: {},
+};
+const PLUGIN_ID_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function isValidPluginId(id) {
+    return typeof id === 'string' && PLUGIN_ID_RE.test(id) && id.length <= 64;
+}
+function parsePluginManifest(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const o = raw;
+    if (typeof o.id !== 'string' || typeof o.name !== 'string')
+        return null;
+    if (!isValidPluginId(o.id))
+        return null;
+    const serverRaw = o.server;
+    const server = serverRaw && typeof serverRaw === 'object'
+        ? (() => {
+            const moduleRaw = serverRaw.module;
+            const modulePath = typeof moduleRaw === 'string' ? moduleRaw.trim() : '';
+            if (!modulePath || !(0, security_1.isSafePluginModuleRel)(modulePath)) {
+                return undefined;
+            }
+            return {
+                module: modulePath,
+                hooks: serverRaw.hooks &&
+                    typeof serverRaw.hooks === 'object'
+                    ? {
+                        subscribe: Array.isArray(serverRaw.hooks
+                            .subscribe)
+                            ? serverRaw.hooks
+                                .subscribe.filter((h) => typeof h === 'string')
+                            : undefined,
+                        provide: Array.isArray(serverRaw.hooks
+                            .provide)
+                            ? serverRaw.hooks
+                                .provide.filter((h) => typeof h === 'string')
+                            : undefined,
+                    }
+                    : undefined,
+            };
+        })()
+        : undefined;
+    const adminRaw = o.admin;
+    const admin = adminRaw && typeof adminRaw === 'object'
+        ? (() => {
+            const raw = adminRaw;
+            const slotsRaw = raw.slots;
+            const subscribe = slotsRaw &&
+                typeof slotsRaw === 'object' &&
+                Array.isArray(slotsRaw.subscribe)
+                ? slotsRaw.subscribe.filter((slot) => typeof slot === 'string' && (0, slots_1.isAdminSlotId)(slot))
+                : undefined;
+            return {
+                entry: typeof raw.entry === 'string' ? raw.entry : undefined,
+                slots: subscribe?.length ? { subscribe } : undefined,
+                menu: raw.menu && typeof raw.menu === 'object'
+                    ? raw.menu
+                    : undefined,
+            };
+        })()
+        : undefined;
+    const settingsRaw = o.settings;
+    const settings = settingsRaw && typeof settingsRaw === 'object'
+        ? {
+            schema: settingsRaw.schema &&
+                typeof settingsRaw.schema === 'object'
+                ? settingsRaw.schema
+                : undefined,
+        }
+        : undefined;
+    const capsRaw = o.capabilities;
+    const capabilities = capsRaw && typeof capsRaw === 'object'
+        ? capsRaw
+        : undefined;
+    return {
+        id: o.id,
+        name: o.name,
+        version: typeof o.version === 'string' ? o.version : '1.0.0',
+        description: typeof o.description === 'string' ? o.description : undefined,
+        author: typeof o.author === 'string' ? o.author : undefined,
+        requires: typeof o.requires === 'string' ? o.requires : undefined,
+        requiresPlugins: Array.isArray(o.requiresPlugins)
+            ? o.requiresPlugins.filter((p) => typeof p === 'string')
+            : undefined,
+        server: server?.module ? server : undefined,
+        admin,
+        settings,
+        permissions: Array.isArray(o.permissions)
+            ? o.permissions.filter((p) => typeof p === 'string')
+            : undefined,
+        capabilities,
+    };
+}
+function getPluginStateFromGlobalSetting(raw) {
+    if (!raw || typeof raw !== 'object')
+        return { ...exports.defaultSitePluginState };
+    const gs = raw;
+    const plugins = gs.plugins;
+    if (!plugins || typeof plugins !== 'object')
+        return { ...exports.defaultSitePluginState };
+    return {
+        installedPlugins: Array.isArray(plugins.installedPlugins)
+            ? plugins.installedPlugins.filter((id) => typeof id === 'string' && isValidPluginId(id))
+            : [],
+        activePlugins: Array.isArray(plugins.activePlugins)
+            ? plugins.activePlugins.filter((id) => typeof id === 'string' && isValidPluginId(id))
+            : [],
+        entries: plugins.entries && typeof plugins.entries === 'object'
+            ? plugins.entries
+            : {},
+    };
+}
+function mergePluginStateIntoGlobalSetting(raw, patch) {
+    const base = raw && typeof raw === 'object'
+        ? { ...raw }
+        : {};
+    const current = getPluginStateFromGlobalSetting(base);
+    base.plugins = {
+        installedPlugins: patch.installedPlugins ?? current.installedPlugins,
+        activePlugins: patch.activePlugins ?? current.activePlugins,
+        entries: patch.entries ?? current.entries,
+    };
+    return base;
+}
+/** Conventional admin module path relative to plugin package root. */
+exports.PLUGIN_ADMIN_MODULE_CONVENTION = 'admin/index';
+/** Whether manifest declares admin UI (slot and/or settings menu). */
+function pluginManifestHasAdminUI(admin) {
+    if (!admin)
+        return false;
+    return Boolean(admin.menu || (admin.slots?.subscribe?.length ?? 0) > 0);
+}

package/toolkit/dist/plugin/extension/security.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSafePluginModuleRel = isSafePluginModuleRel;
+exports.resolvePluginServerModulePath = resolvePluginServerModulePath;
+const path = __importStar(require("path"));
+const ALLOWED_MODULE_EXTENSIONS = new Set(['.js', '.cjs', '.mjs']);
+/** Relative server entry path inside the plugin runtime directory (no `..`, no absolute paths). */
+function isSafePluginModuleRel(moduleRel) {
+    if (typeof moduleRel !== 'string' || !moduleRel.trim())
+        return false;
+    if (path.isAbsolute(moduleRel))
+        return false;
+    if (moduleRel.includes('\0'))
+        return false;
+    const normalized = moduleRel.replace(/^\.\//, '').replace(/\\/g, '/');
+    const segments = normalized.split('/');
+    if (segments.some((segment) => segment === '..'))
+        return false;
+    if (segments.some((segment) => segment === '.'))
+        return false;
+    return segments.every((segment) => segment.length > 0);
+}
+/**
+ * Resolve `server.module` under the plugin root and ensure the result cannot escape it.
+ * Returns `null` when the path is unsafe or uses a disallowed extension.
+ */
+function resolvePluginServerModulePath(pluginRoot, moduleRel) {
+    if (!isSafePluginModuleRel(moduleRel))
+        return null;
+    const rel = moduleRel.replace(/^\.\//, '');
+    const root = path.resolve(pluginRoot);
+    const resolved = path.resolve(root, rel);
+    if (resolved !== root && !resolved.startsWith(`${root}${path.sep}`)) {
+        return null;
+    }
+    const ext = path.extname(resolved).toLowerCase();
+    if (!ext || !ALLOWED_MODULE_EXTENSIONS.has(ext)) {
+        return null;
+    }
+    return resolved;
+}

package/toolkit/dist/plugin/extension/validate.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertPlainPluginConfig = assertPlainPluginConfig;
+exports.validatePluginSettings = validatePluginSettings;
+const ajv_1 = __importDefault(require("ajv"));
+const ajv = new ajv_1.default({ allErrors: true, strict: false, coerceTypes: false });
+const FORBIDDEN_CONFIG_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+function assertPlainPluginConfig(config) {
+    if (!config || typeof config !== 'object' || Array.isArray(config)) {
+        throw new Error('Plugin config must be a JSON object');
+    }
+    for (const key of Object.keys(config)) {
+        if (FORBIDDEN_CONFIG_KEYS.has(key)) {
+            throw new Error(`Invalid config key "${key}"`);
+        }
+    }
+    return config;
+}
+function validatePluginSettings(schema, data) {
+    if (!schema) {
+        if (data &&
+            typeof data === 'object' &&
+            !Array.isArray(data) &&
+            Object.keys(data).length > 0) {
+            return {
+                valid: false,
+                errors: null,
+                message: 'Plugin has no configurable settings',
+            };
+        }
+        return { valid: true, errors: null };
+    }
+    let config;
+    try {
+        config = assertPlainPluginConfig(data);
+    }
+    catch (err) {
+        return {
+            valid: false,
+            errors: null,
+            message: err instanceof Error ? err.message : 'Invalid plugin config',
+        };
+    }
+    const validate = ajv.compile(schema);
+    const valid = validate(config) === true;
+    if (valid) {
+        return { valid: true, errors: null };
+    }
+    const errors = validate.errors ?? [];
+    const message = errors.map((e) => `${e.instancePath || '/'} ${e.message ?? ''}`.trim()).join('; ');
+    return { valid: false, errors, message: message || 'Invalid plugin configuration' };
+}

package/toolkit/dist/plugin/index.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.react = exports.server = exports.extension = exports.dev = exports.client = exports.admin = void 0;
+exports.admin = __importStar(require("./admin"));
+exports.client = __importStar(require("./client"));
+exports.dev = __importStar(require("./dev"));
+exports.extension = __importStar(require("./extension"));
+exports.server = __importStar(require("./server"));
+/** @deprecated Use `plugin/client`; path kept for compatibility. */
+exports.react = __importStar(require("./react"));
+__exportStar(require("./admin"), exports);
+__exportStar(require("./client"), exports);
+__exportStar(require("./dev"), exports);
+__exportStar(require("./extension"), exports);
+__exportStar(require("./server"), exports);
+__exportStar(require("./react"), exports);

package/toolkit/dist/plugin/node.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPluginAdminLocaleFile = void 0;
+/** Node-only plugin helpers (filesystem I/O). */
+var plugin_admin_locale_io_1 = require("./extension/plugin-admin-locale.io");
+Object.defineProperty(exports, "readPluginAdminLocaleFile", { enumerable: true, get: function () { return plugin_admin_locale_io_1.readPluginAdminLocaleFile; } });