@dusted/anqst 0.1.3 → 1.0.1

package/dist/src/app.js

@@ -19,7 +19,7 @@ const project_1 = require("./project");
 const layout_1 = require("./layout");
 const parser_1 = require("./parser");
 const verify_1 = require("./verify");
-const build_stamp_1 = require("./build-stamp");
+const ANQSTGEN_ACTIVE_STAMP_FILE = ".anqstgen-version-active.json";
 function renderHelp() {
     const version = readActiveBuildStamp();
     return [
@@ -135,8 +135,27 @@ function runTest(cwd) {
         message: verification.message
     };
 }
+function resolveAnQstGenRoot() {
+    return node_path_1.default.resolve(__dirname, "..", "..");
+}
 function readActiveBuildStamp() {
-    return build_stamp_1.ANQST_BUILD_STAMP;
+    if (process.env.ANQST_BUILD_STAMP && process.env.ANQST_BUILD_STAMP.trim().length > 0) {
+        return process.env.ANQST_BUILD_STAMP.trim();
+    }
+    const activePath = node_path_1.default.join(resolveAnQstGenRoot(), ANQSTGEN_ACTIVE_STAMP_FILE);
+    if (!node_fs_1.default.existsSync(activePath)) {
+        return "unknown_build_0";
+    }
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(activePath, "utf8"));
+        if (typeof parsed.active === "string" && parsed.active.trim().length > 0) {
+            return parsed.active.trim();
+        }
+    }
+    catch {
+        // Fallback to deterministic unknown stamp.
+    }
+    return "unknown_build_0";
 }
 function runDesignerPluginBuild(cwd, widgetName) {
     const layout = (0, layout_1.resolveGeneratedLayoutPaths)(cwd, widgetName);
@@ -176,94 +195,100 @@ function runDesignerPluginBuild(cwd, widgetName) {
 }
 function runBuild(cwd, designerPlugin = false) {
     const buildVersion = readActiveBuildStamp();
-    const specPath = (0, project_1.resolveAnQstSpecPath)(cwd);
-    const configuredWidgetName = (0, project_1.resolveAnQstWidgetName)(cwd);
-    const generationTargets = resolveGenerationTargetsFromCwd(cwd, true);
-    const parsed = (0, parser_1.parseSpecFile)(specPath);
-    (0, verify_1.verifySpec)(parsed);
-    if (parsed.widgetName !== configuredWidgetName) {
-        throw new errors_1.VerifyError(`Settings widgetName '${configuredWidgetName}' does not match spec namespace '${parsed.widgetName}'.`);
-    }
-    resetGeneratedTargets(cwd, parsed.widgetName, generationTargets);
-    const outputs = (0, emit_1.generateOutputs)(parsed, generationTargets);
-    (0, emit_1.writeGeneratedOutputs)(cwd, outputs);
-    if (generationTargets.emitQWidget) {
-        (0, emit_1.installQtIntegrationCMake)(cwd, parsed.widgetName);
-    }
-    const hasAngularProject = generationTargets.emitQWidget && node_fs_1.default.existsSync(node_path_1.default.join(cwd, "angular.json"));
-    if (hasAngularProject) {
-        const angularBuild = (0, node_child_process_1.spawnSync)("npx", ["ng", "build", "--configuration", "production"], {
-            cwd,
-            stdio: "inherit",
-            shell: process.platform === "win32"
-        });
-        if (angularBuild.status !== 0) {
-            throw new errors_1.VerifyError("Angular build failed while preparing embedded widget assets.");
+    process.env.ANQST_BUILD_STAMP = buildVersion;
+    try {
+        const specPath = (0, project_1.resolveAnQstSpecPath)(cwd);
+        const configuredWidgetName = (0, project_1.resolveAnQstWidgetName)(cwd);
+        const generationTargets = resolveGenerationTargetsFromCwd(cwd, true);
+        const parsed = (0, parser_1.parseSpecFile)(specPath);
+        (0, verify_1.verifySpec)(parsed);
+        if (parsed.widgetName !== configuredWidgetName) {
+            throw new errors_1.VerifyError(`Settings widgetName '${configuredWidgetName}' does not match spec namespace '${parsed.widgetName}'.`);
         }
-    }
-    if (generationTargets.emitQWidget) {
-        const embedded = (0, emit_1.installEmbeddedWebBundle)(cwd, parsed.widgetName);
-        if (hasAngularProject && !embedded) {
-            throw new errors_1.VerifyError("Unable to embed Angular output. Ensure ng build produced a dist bundle with index.html.");
+        resetGeneratedTargets(cwd, parsed.widgetName, generationTargets);
+        const outputs = (0, emit_1.generateOutputs)(parsed, generationTargets);
+        (0, emit_1.writeGeneratedOutputs)(cwd, outputs);
+        if (generationTargets.emitQWidget) {
+            (0, emit_1.installQtIntegrationCMake)(cwd, parsed.widgetName);
         }
-    }
-    let designerPluginBuilt = false;
-    if (designerPlugin) {
-        if (!generationTargets.emitQWidget) {
-            console.warn("[AnQst] --designerplugin requested but QWidget target is not enabled. Skipping designer plugin build.");
+        const hasAngularProject = generationTargets.emitQWidget && node_fs_1.default.existsSync(node_path_1.default.join(cwd, "angular.json"));
+        if (hasAngularProject) {
+            const angularBuild = (0, node_child_process_1.spawnSync)("npx", ["ng", "build", "--configuration", "production"], {
+                cwd,
+                stdio: "inherit",
+                shell: process.platform === "win32"
+            });
+            if (angularBuild.status !== 0) {
+                throw new errors_1.VerifyError("Angular build failed while preparing embedded widget assets.");
+            }
         }
-        else {
-            const widgetCategory = (0, project_1.resolveAnQstWidgetCategory)(cwd);
-            (0, emit_1.installQtDesignerPluginCMake)(cwd, parsed.widgetName, { widgetCategory });
-            runDesignerPluginBuild(cwd, parsed.widgetName);
-            designerPluginBuilt = true;
+        if (generationTargets.emitQWidget) {
+            const embedded = (0, emit_1.installEmbeddedWebBundle)(cwd, parsed.widgetName);
+            if (hasAngularProject && !embedded) {
+                throw new errors_1.VerifyError("Unable to embed Angular output. Ensure ng build produced a dist bundle with index.html.");
+            }
+        }
+        let designerPluginBuilt = false;
+        if (designerPlugin) {
+            if (!generationTargets.emitQWidget) {
+                console.warn("[AnQst] --designerplugin requested but QWidget target is not enabled. Skipping designer plugin build.");
+            }
+            else {
+                const widgetCategory = (0, project_1.resolveAnQstWidgetCategory)(cwd);
+                (0, emit_1.installQtDesignerPluginCMake)(cwd, parsed.widgetName, { widgetCategory });
+                runDesignerPluginBuild(cwd, parsed.widgetName);
+                designerPluginBuilt = true;
+            }
+        }
+        if (!generationTargets.emitAngularService && !generationTargets.emitQWidget && !generationTargets.emitNodeExpressWs) {
+            return {
+                success: true,
+                message: [
+                    "Build completed.",
+                    `    anqst version ${buildVersion}`,
+                    "    No outputs selected by AnQst.generate."
+                ].join("\n")
+            };
+        }
+        const layout = (0, layout_1.resolveGeneratedLayoutPaths)(cwd, parsed.widgetName);
+        const detailLines = [];
+        if (generationTargets.emitAngularService) {
+            detailLines.push("    Target AngularService:");
+            detailLines.push(`      - Services output: ${(0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.frontendRoot, "services"))}`);
+            detailLines.push(`      - Types output: ${(0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.frontendRoot, "types"))}`);
+        }
+        if (generationTargets.emitQWidget) {
+            detailLines.push("    Target QWidget:");
+            detailLines.push(`      - Qt integration CMake: ${(0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.cppCmakeRoot, "CMakeLists.txt"))}`);
+            detailLines.push(`      - Widget output root: ${(0, layout_1.toProjectRelative)(cwd, layout.cppQtWidgetRoot)}`);
+            detailLines.push("      - Embedded web assets refreshed from Angular build");
+        }
+        if (generationTargets.emitNodeExpressWs) {
+            detailLines.push("    Target node_express_ws:");
+            detailLines.push(`      - Module output root: ${(0, layout_1.toProjectRelative)(cwd, layout.nodeExpressRoot)}`);
+        }
+        if (designerPluginBuilt) {
+            const pluginBinaryPath = (0, layout_1.normalizeSlashes)(node_path_1.default.join((0, layout_1.toProjectRelative)(cwd, layout.designerPluginBuildRoot), designerPluginBinaryName(parsed.widgetName)));
+            detailLines.push("    Target QtDesignerPlugin:");
+            detailLines.push(`      - Build output: ${(0, layout_1.toProjectRelative)(cwd, layout.designerPluginBuildRoot)}`);
+            detailLines.push(`      - Plugin binary: ${pluginBinaryPath}`);
+            detailLines.push("      - Install target dir: <QT_INSTALL_PLUGINS>/designer");
+            detailLines.push("      - Discover QT_INSTALL_PLUGINS: qmake -query QT_INSTALL_PLUGINS");
+            detailLines.push(`      - Example install: cp ${pluginBinaryPath} \"$(qmake -query QT_INSTALL_PLUGINS)/designer/\"`);
+            detailLines.push(`      - User-local install: mkdir -p \"$HOME/.local/lib/qt5/plugins/designer\" && cp ${pluginBinaryPath} \"$HOME/.local/lib/qt5/plugins/designer/\"`);
         }
-    }
-    if (!generationTargets.emitAngularService && !generationTargets.emitQWidget && !generationTargets.emitNodeExpressWs) {
         return {
             success: true,
             message: [
                 "Build completed.",
                 `    anqst version ${buildVersion}`,
-                "    No outputs selected by AnQst.generate."
+                ...detailLines
             ].join("\n")
         };
     }
-    const layout = (0, layout_1.resolveGeneratedLayoutPaths)(cwd, parsed.widgetName);
-    const detailLines = [];
-    if (generationTargets.emitAngularService) {
-        detailLines.push("    Target AngularService:");
-        detailLines.push(`      - Services output: ${(0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.frontendRoot, "services"))}`);
-        detailLines.push(`      - Types output: ${(0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.frontendRoot, "types"))}`);
-    }
-    if (generationTargets.emitQWidget) {
-        detailLines.push("    Target QWidget:");
-        detailLines.push(`      - Qt integration CMake: ${(0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.cppCmakeRoot, "CMakeLists.txt"))}`);
-        detailLines.push(`      - Widget output root: ${(0, layout_1.toProjectRelative)(cwd, layout.cppQtWidgetRoot)}`);
-        detailLines.push("      - Embedded web assets refreshed from Angular build");
-    }
-    if (generationTargets.emitNodeExpressWs) {
-        detailLines.push("    Target node_express_ws:");
-        detailLines.push(`      - Module output root: ${(0, layout_1.toProjectRelative)(cwd, layout.nodeExpressRoot)}`);
-    }
-    if (designerPluginBuilt) {
-        const pluginBinaryPath = (0, layout_1.normalizeSlashes)(node_path_1.default.join((0, layout_1.toProjectRelative)(cwd, layout.designerPluginBuildRoot), designerPluginBinaryName(parsed.widgetName)));
-        detailLines.push("    Target QtDesignerPlugin:");
-        detailLines.push(`      - Build output: ${(0, layout_1.toProjectRelative)(cwd, layout.designerPluginBuildRoot)}`);
-        detailLines.push(`      - Plugin binary: ${pluginBinaryPath}`);
-        detailLines.push("      - Install target dir: <QT_INSTALL_PLUGINS>/designer");
-        detailLines.push("      - Discover QT_INSTALL_PLUGINS: qmake -query QT_INSTALL_PLUGINS");
-        detailLines.push(`      - Example install: cp ${pluginBinaryPath} \"$(qmake -query QT_INSTALL_PLUGINS)/designer/\"`);
-        detailLines.push(`      - User-local install: mkdir -p \"$HOME/.local/lib/qt5/plugins/designer\" && cp ${pluginBinaryPath} \"$HOME/.local/lib/qt5/plugins/designer/\"`);
+    finally {
+        delete process.env.ANQST_BUILD_STAMP;
     }
-    return {
-        success: true,
-        message: [
-            "Build completed.",
-            `    anqst version ${buildVersion}`,
-            ...detailLines
-        ].join("\n")
-    };
 }
 function parseSpecCommandArg(commandName, specArg, extraArgs) {
     const allArgs = [specArg, ...extraArgs].filter((arg) => typeof arg === "string" && arg.length > 0);

package/dist/src/build-stamp.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ANQST_BUILD_STAMP = void 0;
 // Generated by scripts/build-with-stamp.js. Do not edit by hand.
-exports.ANQST_BUILD_STAMP = "0.1.3/da5d2ee_clean_build_1/2026-03-11";
+exports.ANQST_BUILD_STAMP = "unknown/unknown_build_0/1970-01-01";

package/dist/src/emit.js

@@ -12,7 +12,6 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const typescript_1 = __importDefault(require("typescript"));
 const pngjs_1 = require("pngjs");
-const build_stamp_1 = require("./build-stamp");
 const layout_1 = require("./layout");
 function stripAnQstType(typeText) {
     return typeText
@@ -627,6 +626,27 @@ function buildCppTypeContext(spec) {
     }
     return normalizer.buildContext();
 }
+function collectDragDropMimeConstants(spec) {
+    const seen = new Set();
+    const constants = [];
+    for (const service of spec.services) {
+        for (const member of service.members) {
+            if ((member.kind === "DropTarget" || member.kind === "HoverTarget") && member.payloadTypeText) {
+                const typeName = member.payloadTypeText.replace(/\s/g, "");
+                const key = `${service.name}-${typeName}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                constants.push({
+                    typeName,
+                    serviceName: service.name,
+                    mimeType: `application/anqst-dragdropevent_${service.name}-${typeName}`
+                });
+            }
+        }
+    }
+    return constants;
+}
 function renderTypesHeader(spec, cppTypes) {
     const decls = cppTypes.orderedDecls.map(renderCppDecl).join("\n\n");
     const metatypes = cppTypes.structNames
@@ -635,6 +655,11 @@ function renderTypesHeader(spec, cppTypes) {
         `Q_DECLARE_METATYPE(QList<${spec.widgetName}::${name}>)`
     ])
         .join("\n");
+    const mimeConstants = collectDragDropMimeConstants(spec);
+    const mimeConstantLines = mimeConstants
+        .map((c) => `static constexpr const char* kDragDropMime_${c.typeName} = "${c.mimeType}";`)
+        .join("\n");
+    const mimeBlock = mimeConstantLines.length > 0 ? `\n${mimeConstantLines}\n` : "";
     return `#pragma once
 #include <QString>
 #include <QStringList>
@@ -647,7 +672,7 @@ function renderTypesHeader(spec, cppTypes) {
 namespace ${spec.widgetName} {
 
 ${decls}
-
+${mimeBlock}
 } // namespace ${spec.widgetName}
 
 ${metatypes}
@@ -710,6 +735,15 @@ function renderWidgetHeader(spec, cppTypes) {
                     publicSlots.push(`void ${member.name}Slot(const ${cppType}& value);`);
                 }
             }
+            else if (member.kind === "DropTarget" && member.payloadTypeText) {
+                const cppType = cppTypes.mapTypeText(member.payloadTypeText, [service.name, member.name, "Payload"]);
+                signals.push(`void ${member.name}(const ${cppType}& payload, double x, double y);`);
+            }
+            else if (member.kind === "HoverTarget" && member.payloadTypeText) {
+                const cppType = cppTypes.mapTypeText(member.payloadTypeText, [service.name, member.name, "Payload"]);
+                signals.push(`void ${member.name}(const ${cppType}& payload, double x, double y);`);
+                signals.push(`void ${member.name}Left();`);
+            }
         }
     }
     return `#pragma once
@@ -860,6 +894,45 @@ function renderCppStub(spec, cppTypes) {
     lines.push(`    Q_UNUSED(kResourcesInitialized);`);
     lines.push(`    registerGeneratedMetaTypes();`);
     lines.push(`    installBridgeBindings();`);
+    for (const service of spec.services) {
+        for (const member of service.members) {
+            if (member.kind === "DropTarget" && member.payloadTypeText) {
+                const typeName = member.payloadTypeText.replace(/\s/g, "");
+                const mimeConst = `${spec.widgetName}::kDragDropMime_${typeName}`;
+                lines.push(`    registerDropTarget(QStringLiteral("${service.name}"), QStringLiteral("${member.name}"), QString::fromUtf8(${mimeConst}));`);
+            }
+            else if (member.kind === "HoverTarget" && member.payloadTypeText) {
+                const typeName = member.payloadTypeText.replace(/\s/g, "");
+                const mimeConst = `${spec.widgetName}::kDragDropMime_${typeName}`;
+                lines.push(`    registerHoverTarget(QStringLiteral("${service.name}"), QStringLiteral("${member.name}"), QString::fromUtf8(${mimeConst}), ${member.hoverThrottleMs});`);
+            }
+        }
+    }
+    for (const service of spec.services) {
+        for (const member of service.members) {
+            if (member.kind === "DropTarget" && member.payloadTypeText) {
+                const cppType = cppTypes.mapTypeText(member.payloadTypeText, [service.name, member.name, "Payload"]);
+                lines.push(`    QObject::connect(this, &AnQstWebHostBase::anQstBridge_dropReceived, this, [this](const QString& service, const QString& member, const QVariant& payload, double x, double y) {`);
+                lines.push(`        if (service == QStringLiteral("${service.name}") && member == QStringLiteral("${member.name}")) {`);
+                lines.push(`            emit ${member.name}(payload.value<${cppType}>(), x, y);`);
+                lines.push(`        }`);
+                lines.push(`    });`);
+            }
+            else if (member.kind === "HoverTarget" && member.payloadTypeText) {
+                const cppType = cppTypes.mapTypeText(member.payloadTypeText, [service.name, member.name, "Payload"]);
+                lines.push(`    QObject::connect(this, &AnQstWebHostBase::anQstBridge_hoverUpdated, this, [this](const QString& service, const QString& member, const QVariant& payload, double x, double y) {`);
+                lines.push(`        if (service == QStringLiteral("${service.name}") && member == QStringLiteral("${member.name}")) {`);
+                lines.push(`            emit ${member.name}(payload.value<${cppType}>(), x, y);`);
+                lines.push(`        }`);
+                lines.push(`    });`);
+                lines.push(`    QObject::connect(this, &AnQstWebHostBase::anQstBridge_hoverLeft, this, [this](const QString& service, const QString& member) {`);
+                lines.push(`        if (service == QStringLiteral("${service.name}") && member == QStringLiteral("${member.name}")) {`);
+                lines.push(`            emit ${member.name}Left();`);
+                lines.push(`        }`);
+                lines.push(`    });`);
+            }
+        }
+    }
     lines.push(`    QObject::connect(this, &AnQstWebHostBase::onHostError, this, &${widgetClassName}::diagnosticsForwarded);`);
     lines.push(`    const bool rootOk = setContentRoot(QString::fromUtf8(kBootstrapContentRoot));`);
     lines.push(`    const bool bridgeOk = setBridgeObject(this, QString::fromUtf8(kBootstrapBridgeObject));`);
@@ -1172,7 +1245,24 @@ function normalizeSlashes(value) {
     return value.split(node_path_1.default.sep).join("/");
 }
 function resolveActiveBuildStamp() {
-    return build_stamp_1.ANQST_BUILD_STAMP.trim();
+    const fromEnv = process.env.ANQST_BUILD_STAMP?.trim();
+    if (fromEnv && fromEnv.length > 0) {
+        return fromEnv;
+    }
+    const activePath = node_path_1.default.resolve(__dirname, "..", "..", ".anqstgen-version-active.json");
+    if (!node_fs_1.default.existsSync(activePath)) {
+        return "";
+    }
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(activePath, "utf8"));
+        if (typeof parsed.active === "string" && parsed.active.trim().length > 0) {
+            return parsed.active.trim();
+        }
+    }
+    catch {
+        return "";
+    }
+    return "";
 }
 function withBuildStamp(relativePath, content) {
     const stamp = resolveActiveBuildStamp();
@@ -1315,6 +1405,19 @@ function renderTsService(spec, serviceName) {
                 constructorBodyLines.push(`    this._bridge.onOutput("${serviceName}", "${m.name}", (value) => this._${m.name}.set(value as ${tsType}));`);
             }
         }
+        if (m.kind === "DropTarget" && m.payloadTypeText) {
+            const tsType = mapTypeTextToTs(m.payloadTypeText);
+            fieldLines.push(`  private readonly _${m.name} = signal<{ payload: ${tsType}; x: number; y: number } | null>(null);`);
+            methodLines.push(`  ${m.name}(): { payload: ${tsType}; x: number; y: number } | null { return this._${m.name}(); }`);
+            constructorBodyLines.push(`    this._bridge.onDrop("${serviceName}", "${m.name}", (payload, x, y) => this._${m.name}.set({ payload: payload as ${tsType}, x, y }));`);
+        }
+        if (m.kind === "HoverTarget" && m.payloadTypeText) {
+            const tsType = mapTypeTextToTs(m.payloadTypeText);
+            fieldLines.push(`  private readonly _${m.name} = signal<{ payload: ${tsType}; x: number; y: number } | null>(null);`);
+            methodLines.push(`  ${m.name}(): { payload: ${tsType}; x: number; y: number } | null { return this._${m.name}(); }`);
+            constructorBodyLines.push(`    this._bridge.onHover("${serviceName}", "${m.name}", (payload, x, y) => this._${m.name}.set({ payload: payload as ${tsType}, x, y }));`);
+            constructorBodyLines.push(`    this._bridge.onHoverLeft("${serviceName}", "${m.name}", () => this._${m.name}.set(null));`);
+        }
     }
     const constructorLines = [
         "  constructor() {",
@@ -1366,6 +1469,14 @@ function renderTsServiceDts(spec, serviceName) {
                 setMembers.push(`  ${m.name}(value: ${tsType}): void;`);
             }
         }
+        if (m.kind === "DropTarget" && m.payloadTypeText) {
+            const tsType = mapTypeTextToTs(m.payloadTypeText);
+            classMembers.push(`  ${m.name}(): { payload: ${tsType}; x: number; y: number } | null;`);
+        }
+        if (m.kind === "HoverTarget" && m.payloadTypeText) {
+            const tsType = mapTypeTextToTs(m.payloadTypeText);
+            classMembers.push(`  ${m.name}(): { payload: ${tsType}; x: number; y: number } | null;`);
+        }
     }
     const setInterfaceDecl = setMembers.length > 0
         ? `export interface ${setInterfaceName} {\n${setMembers.join("\n")}\n}`
@@ -1396,6 +1507,9 @@ type SlotHandler = (...args: unknown[]) => unknown;
 type OutputHandler = (value: unknown) => void;
 type SlotInvocationListener = (requestId: string, service: string, member: string, args: unknown[]) => void;
 type OutputListener = (service: string, member: string, value: unknown) => void;
+type DropListener = (service: string, member: string, payload: unknown, x: number, y: number) => void;
+type HoverListener = (service: string, member: string, payload: unknown, x: number, y: number) => void;
+type HoverLeftListener = (service: string, member: string) => void;
 
 interface HostBridgeApi {
   anQstBridge_call(service: string, member: string, args: unknown[], callback: (result: unknown) => void): void;
@@ -1407,6 +1521,9 @@ interface HostBridgeApi {
   anQstBridge_slotInvocationRequested: {
     connect: (cb: (requestId: string, service: string, member: string, args: unknown[]) => void) => void;
   };
+  anQstBridge_dropReceived: { connect: (cb: (service: string, member: string, payload: unknown, x: number, y: number) => void) => void };
+  anQstBridge_hoverUpdated: { connect: (cb: (service: string, member: string, payload: unknown, x: number, y: number) => void) => void };
+  anQstBridge_hoverLeft: { connect: (cb: (service: string, member: string) => void) => void };
 }
 
 interface QWebChannelCtor {
@@ -1424,6 +1541,9 @@ interface BridgeAdapter {
   resolveSlot(requestId: string, ok: boolean, payload: unknown, error: string): void;
   onOutput(handler: OutputListener): void;
   onSlotInvocation(handler: SlotInvocationListener): void;
+  onDrop(handler: DropListener): void;
+  onHover(handler: HoverListener): void;
+  onHoverLeft(handler: HoverLeftListener): void;
 }
 
 function isBridgeCallError(value: unknown): value is {
@@ -1511,6 +1631,18 @@ class QtWebChannelAdapter implements BridgeAdapter {
   onSlotInvocation(handler: SlotInvocationListener): void {
     this.host.anQstBridge_slotInvocationRequested.connect(handler);
   }
+
+  onDrop(handler: DropListener): void {
+    this.host.anQstBridge_dropReceived.connect(handler);
+  }
+
+  onHover(handler: HoverListener): void {
+    this.host.anQstBridge_hoverUpdated.connect(handler);
+  }
+
+  onHoverLeft(handler: HoverLeftListener): void {
+    this.host.anQstBridge_hoverLeft.connect(handler);
+  }
 }
 
 class WebSocketBridgeAdapter implements BridgeAdapter {
@@ -1523,6 +1655,9 @@ class WebSocketBridgeAdapter implements BridgeAdapter {
   }>();
   private readonly outputListeners: OutputListener[] = [];
   private readonly slotListeners: SlotInvocationListener[] = [];
+  private readonly dropListeners: DropListener[] = [];
+  private readonly hoverListeners: HoverListener[] = [];
+  private readonly hoverLeftListeners: HoverLeftListener[] = [];
   private requestCounter = 0;
 
   private constructor(private readonly socket: WebSocket) {
@@ -1562,6 +1697,34 @@ class WebSocketBridgeAdapter implements BridgeAdapter {
         }
         return;
       }
+      if (type === "dropReceived") {
+        const service = String(message["service"] ?? "");
+        const member = String(message["member"] ?? "");
+        const x = Number(message["x"] ?? 0);
+        const y = Number(message["y"] ?? 0);
+        for (const listener of this.dropListeners) {
+          listener(service, member, message["payload"], x, y);
+        }
+        return;
+      }
+      if (type === "hoverUpdated") {
+        const service = String(message["service"] ?? "");
+        const member = String(message["member"] ?? "");
+        const x = Number(message["x"] ?? 0);
+        const y = Number(message["y"] ?? 0);
+        for (const listener of this.hoverListeners) {
+          listener(service, member, message["payload"], x, y);
+        }
+        return;
+      }
+      if (type === "hoverLeft") {
+        const service = String(message["service"] ?? "");
+        const member = String(message["member"] ?? "");
+        for (const listener of this.hoverLeftListeners) {
+          listener(service, member);
+        }
+        return;
+      }
       if (type === "hostError") {
         console.error("AnQst host error:", message["payload"]);
         return;
@@ -1649,6 +1812,18 @@ class WebSocketBridgeAdapter implements BridgeAdapter {
   onSlotInvocation(handler: SlotInvocationListener): void {
     this.slotListeners.push(handler);
   }
+
+  onDrop(handler: DropListener): void {
+    this.dropListeners.push(handler);
+  }
+
+  onHover(handler: HoverListener): void {
+    this.hoverListeners.push(handler);
+  }
+
+  onHoverLeft(handler: HoverLeftListener): void {
+    this.hoverLeftListeners.push(handler);
+  }
 }
 
 @Injectable({ providedIn: "root" })
@@ -1656,6 +1831,9 @@ class AnQstBridgeRuntime {
   private adapter: BridgeAdapter | null = null;
   private readonly slotHandlers = new Map<string, SlotHandler>();
   private readonly outputHandlers = new Map<string, OutputHandler[]>();
+  private readonly dropHandlers = new Map<string, ((payload: unknown, x: number, y: number) => void)[]>();
+  private readonly hoverHandlers = new Map<string, ((payload: unknown, x: number, y: number) => void)[]>();
+  private readonly hoverLeftHandlers = new Map<string, (() => void)[]>();
   private readonly startup = this.init();
 
   async ready(): Promise<void> {
@@ -1706,6 +1884,27 @@ class AnQstBridgeRuntime {
     this.outputHandlers.set(key, existing);
   }
 
+  onDrop(service: string, member: string, handler: (payload: unknown, x: number, y: number) => void): void {
+    const key = this.key(service, member);
+    const existing = this.dropHandlers.get(key) ?? [];
+    existing.push(handler);
+    this.dropHandlers.set(key, existing);
+  }
+
+  onHover(service: string, member: string, handler: (payload: unknown, x: number, y: number) => void): void {
+    const key = this.key(service, member);
+    const existing = this.hoverHandlers.get(key) ?? [];
+    existing.push(handler);
+    this.hoverHandlers.set(key, existing);
+  }
+
+  onHoverLeft(service: string, member: string, handler: () => void): void {
+    const key = this.key(service, member);
+    const existing = this.hoverLeftHandlers.get(key) ?? [];
+    existing.push(handler);
+    this.hoverLeftHandlers.set(key, existing);
+  }
+
   private requireAdapterSync(): BridgeAdapter {
     if (this.adapter === null) {
       throw new Error("AnQst bridge is not ready.");
@@ -1751,6 +1950,24 @@ class AnQstBridgeRuntime {
         this.adapter!.resolveSlot(requestId, false, undefined, message);
       }
     });
+    this.adapter.onDrop((service, member, payload, x, y) => {
+      const key = this.key(service, member);
+      for (const handler of this.dropHandlers.get(key) ?? []) {
+        handler(payload, x, y);
+      }
+    });
+    this.adapter.onHover((service, member, payload, x, y) => {
+      const key = this.key(service, member);
+      for (const handler of this.hoverHandlers.get(key) ?? []) {
+        handler(payload, x, y);
+      }
+    });
+    this.adapter.onHoverLeft((service, member) => {
+      const key = this.key(service, member);
+      for (const handler of this.hoverLeftHandlers.get(key) ?? []) {
+        handler();
+      }
+    });
     for (const key of this.slotHandlers.keys()) {
       const parts = key.split("::");
       if (parts.length === 2) {
@@ -2790,6 +3007,7 @@ set(CMAKE_AUTOUIC ON)
 set(CMAKE_AUTORCC ON)
 
 find_program(ANQST_NPM_EXECUTABLE npm REQUIRED)
+find_program(ANQST_NPX_EXECUTABLE npx REQUIRED)
 
 add_custom_command(
     OUTPUT
@@ -2801,7 +3019,7 @@ add_custom_command(
         "\${${generatedIncludeVar}}/${widgetName}Types.h"
         "\${${generatedRootVar}}/webapp/index.html"
     COMMAND "\${ANQST_NPM_EXECUTABLE}" install
-    COMMAND "\${ANQST_NPM_EXECUTABLE}" run anqst:build
+    COMMAND "\${ANQST_NPX_EXECUTABLE}" anqst build
     WORKING_DIRECTORY "\${${projectRootVar}}"
     COMMENT "Generating AnQst widget library (${widgetTarget}) from Angular project"
     VERBATIM
@@ -3029,7 +3247,7 @@ function renderQtDesignerPluginCpp(widgetName, widgetCategory, hasIcon) {
 #include <QObject>
 #include <QString>
 #include <QWidget>
-#include "include/${widgetName}.h"
+#include "${widgetName}.h"
 
 class ${pluginClass} final : public QObject, public QDesignerCustomWidgetInterface {
     Q_OBJECT
@@ -3045,9 +3263,10 @@ public:
     QString toolTip() const override { return QStringLiteral("${widgetName} generated by AnQst."); }
     QString whatsThis() const override { return QStringLiteral("${widgetName} generated by AnQst."); }
     bool isContainer() const override { return false; }
-    QString includeFile() const override { return QStringLiteral("include/${widgetName}.h"); }
+    QString includeFile() const override { return QStringLiteral("${widgetName}.h"); }
     QWidget* createWidget(QWidget* parent) override {
         auto* widget = new ${widgetClass}(parent);
+        widget->setMinimumHeight(128);
         widget->setProperty("anqstDesignerContext", true);
         return widget;
     }
@@ -3058,6 +3277,12 @@ public:
         return QStringLiteral(
             "<ui language=\\"c++\\">\\n"
             "  <widget class=\\"${widgetClass}\\" name=\\"${widgetName.toLowerCase()}\\">\\n"
+            "    <property name=\\"minimumSize\\">\\n"
+            "      <size>\\n"
+            "        <width>0</width>\\n"
+            "        <height>128</height>\\n"
+            "      </size>\\n"
+            "    </property>\\n"
             "  </widget>\\n"
             "</ui>\\n");
     }