@kwirthmagnify/kwirth-common-front 0.5.52 → 0.5.53

package/dist/HelpButton.js

@@ -7,15 +7,10 @@ exports.HelpButton = void 0;
 const react_1 = __importDefault(require("react"));
 const material_1 = require("@mui/material");
 const HelpOutline_1 = __importDefault(require("@mui/icons-material/HelpOutline"));
-// Botón de ayuda reutilizable para dialogs de configuración: abre la guía (docsify) en un NUEVO tab en
-// una sección concreta, deep-link vía hash routing (p.ej. …/#/admin/06-sla-settings). `section` puede
-// llevar ancla de heading (…?id=slug). Pensado para la barra de título de un dialog.
-// Regla de proyecto: si un dialog tiene sección de ayuda, llevar este botón (ver memoria dialog-help-button).
-const DEFAULT_DOCS_URL = 'http://localhost:4000'; // fallback si no hay docsUrl configurado
 const HelpButton = ({ docsUrl, section }) => {
     const open = () => {
         var _a, _b, _c, _d;
-        const base = (docsUrl || DEFAULT_DOCS_URL).replace(/\/+$/, '');
+        const base = (docsUrl !== null && docsUrl !== void 0 ? docsUrl : '').replace(/\/+$/, '');
         // Popup del navegador (ventana aparte, no pestaña): las features de tamaño fuerzan el popup.
         // Tamaño: 48% ancho × 64% alto de la pantalla ACTUAL. Centrado en su monitor (multi-monitor) vía
         // availLeft/availTop (origen del monitor donde está la ventana). left/top solo los respeta si es popup real.
@@ -36,6 +31,8 @@ const HelpButton = ({ docsUrl, section }) => {
             w.focus();
         } // opener=null = seguridad (equiv. noopener, que aquí forzaría pestaña)
     };
+    if (!docsUrl)
+        return null;
     return (react_1.default.createElement(material_1.Tooltip, { arrow: true, title: 'Open the guide for this section' },
         react_1.default.createElement(material_1.IconButton, { size: 'small', "aria-label": 'help', onClick: open },
             react_1.default.createElement(HelpOutline_1.default, { fontSize: 'small' }))));

package/dist/docsUrl.d.ts

@@ -0,0 +1,3 @@
+export declare const docsUrl: (clusterUrl: string | undefined, targetType: string, id: string) => string;
+/** Atajo para el caso corriente: la guía de un plugin. */
+export declare const pluginDocsUrl: (clusterUrl: string | undefined, pluginId: string) => string;

package/dist/docsUrl.js

@@ -0,0 +1,18 @@
+"use strict";
+// La guía de una extensión la sirve el propio core, en /core/docs/<tipo>/<id>, desde que 'docs' es un tipo
+// de extensión instalable. Así que la URL es DERIVABLE del cluster y no hay nada que configurar.
+//
+// Existe aquí, y no copiada en cada plugin, por un fallo real: agora la pedía en un campo de su pantalla de
+// settings, alguien la tecleó sin el `/core`, y su botón de ayuda estuvo dando 404 durante meses sin que
+// nadie lo notara — porque HelpButton, si no le pasabas base, se iba a un `http://localhost:4000` que no
+// existe en ningún cluster. Ese default ya no está: sin base, el botón no se pinta.
+//
+// Excubitor repetía la misma cadena a mano en 20 ficheros e iter en 9. Repetirla no es solo feo: es que
+// cuando la ruta cambie habrá que acordarse de treinta sitios.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluginDocsUrl = exports.docsUrl = void 0;
+const docsUrl = (clusterUrl, targetType, id) => `${(clusterUrl !== null && clusterUrl !== void 0 ? clusterUrl : '').replace(/\/+$/, '')}/core/docs/${targetType}/${id}`;
+exports.docsUrl = docsUrl;
+/** Atajo para el caso corriente: la guía de un plugin. */
+const pluginDocsUrl = (clusterUrl, pluginId) => (0, exports.docsUrl)(clusterUrl, 'plugin', pluginId);
+exports.pluginDocsUrl = pluginDocsUrl;

package/dist/index.d.ts

@@ -123,6 +123,7 @@ export { UserPicker } from './UserPicker';
 export type { IUserPickerProps } from './UserPicker';
 export { HelpButton } from './HelpButton';
 export type { IHelpButtonProps } from './HelpButton';
+export { docsUrl, pluginDocsUrl } from './docsUrl';
 export { DialogTitleHelp } from './DialogTitleHelp';
 export type { IDialogTitleHelpProps } from './DialogTitleHelp';
 export { MenuNotification } from './MenuNotification';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MenuNotification = exports.DialogTitleHelp = exports.HelpButton = exports.UserPicker = exports.MsgBoxWaitCancel = exports.MsgBoxWait = exports.MsgBoxYesNoCancel = exports.MsgBoxYesNo = exports.MsgBoxOkCancel = exports.MsgBoxOkError = exports.MsgBoxOkWarning = exports.MsgBoxOk = exports.MsgBoxButtons = exports.MiniGauge = exports.MarkdownViewer = exports.cleanANSI = exports.MetricDefinition = exports.ERemoteConnState = exports.ENotifyLevel = exports.EChannelRefreshAction = exports.useKeyboard = void 0;
+exports.MenuNotification = exports.DialogTitleHelp = exports.pluginDocsUrl = exports.docsUrl = exports.HelpButton = exports.UserPicker = exports.MsgBoxWaitCancel = exports.MsgBoxWait = exports.MsgBoxYesNoCancel = exports.MsgBoxYesNo = exports.MsgBoxOkCancel = exports.MsgBoxOkError = exports.MsgBoxOkWarning = exports.MsgBoxOk = exports.MsgBoxButtons = exports.MiniGauge = exports.MarkdownViewer = exports.cleanANSI = exports.MetricDefinition = exports.ERemoteConnState = exports.ENotifyLevel = exports.EChannelRefreshAction = exports.useKeyboard = void 0;
 const react_1 = require("react");
 const kwirth_common_1 = require("@kwirthmagnify/kwirth-common");
 Object.defineProperty(exports, "EChannelRefreshAction", { enumerable: true, get: function () { return kwirth_common_1.EChannelRefreshAction; } });
@@ -64,6 +64,9 @@ var UserPicker_1 = require("./UserPicker");
 Object.defineProperty(exports, "UserPicker", { enumerable: true, get: function () { return UserPicker_1.UserPicker; } });
 var HelpButton_1 = require("./HelpButton");
 Object.defineProperty(exports, "HelpButton", { enumerable: true, get: function () { return HelpButton_1.HelpButton; } });
+var docsUrl_1 = require("./docsUrl");
+Object.defineProperty(exports, "docsUrl", { enumerable: true, get: function () { return docsUrl_1.docsUrl; } });
+Object.defineProperty(exports, "pluginDocsUrl", { enumerable: true, get: function () { return docsUrl_1.pluginDocsUrl; } });
 var DialogTitleHelp_1 = require("./DialogTitleHelp");
 Object.defineProperty(exports, "DialogTitleHelp", { enumerable: true, get: function () { return DialogTitleHelp_1.DialogTitleHelp; } });
 var MenuNotification_1 = require("./MenuNotification");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kwirthmagnify/kwirth-common-front",
-  "version": "0.5.52",
+  "version": "0.5.53",
   "description": "Frontend channel interfaces for Kwirth plugins and channels",
   "scripts": {
     "build": "del .\\dist\\* /s /q && tsc"