@dusted/anqst 1.0.0 → 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 = "1.0.0/7bd720a_dirty_build_1/2026-03-29";
+exports.ANQST_BUILD_STAMP = "unknown/unknown_build_0/1970-01-01";

package/dist/src/emit.js

@@ -1080,7 +1080,13 @@ function renderCppStub(spec, cppTypes) {
             lines.push(`    }`);
         }
     }
-    lines.push(`    return QVariant();`);
+    lines.push(`    return QVariantMap{`);
+    lines.push(`        {QStringLiteral("code"), QStringLiteral("HandlerNotRegisteredError")},`);
+    lines.push(`        {QStringLiteral("message"), QStringLiteral("No Call mapping found.")},`);
+    lines.push(`        {QStringLiteral("service"), service},`);
+    lines.push(`        {QStringLiteral("member"), member},`);
+    lines.push(`        {QStringLiteral("requestId"), QString()}`);
+    lines.push(`    };`);
     lines.push(`}`);
     lines.push("");
     lines.push(`void ${widgetClassName}::handleGeneratedEmitter(const QString& service, const QString& member, const QVariantList& args) {`);
@@ -3273,7 +3279,7 @@ public:
             "  <widget class=\\"${widgetClass}\\" name=\\"${widgetName.toLowerCase()}\\">\\n"
             "    <property name=\\"minimumSize\\">\\n"
             "      <size>\\n"
-            "        <width>256</width>\\n"
+            "        <width>0</width>\\n"
             "        <height>128</height>\\n"
             "      </size>\\n"
             "    </property>\\n"

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@dusted/anqst",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Opinionated backend generator for webapps.",
   "keywords": [
     "nodejs",
     "qt",
     "angular",
-    "webapp",
-    "apigenerator"
+    "webapp"
   ],
   "homepage": "https://github.com/DusteDdk/AnQst#readme",
   "bugs": {

package/spec/AnQst-Spec-DSL.d.ts

@@ -18,12 +18,12 @@ export namespace AnQst {
 
     /**
      * Declare service `InterfaceName`
-     * 
+     *
      * @remarks
      * Multiple allowed.
      * Affords developers of advanced widgets the ability to create domain-informed categories.
      * - Duplicate method declarations with identical parameter lists are invalid in normative AnQst-Spec input.
-     * 
+     *
      * @example
      * export interface UserService extends Widget.Service { }
      * // Generates UserService.
@@ -83,6 +83,7 @@ export namespace AnQst {
      *      - throw -> failure
      *      - rejected promise -> failure
      *   - Parent: `MethodName` call returns with result.
+     * - Generated C++ Slot methods do not expose `ok/error` out parameters.
      * - Default Slot timeout is 1000ms.
      * Note: One active handler, calling will replace existing and is valid and allowed.
      * @example