@dusted/anqst 0.1.1 → 0.1.3

package/dist/src/app.js

@@ -13,148 +13,135 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_child_process_1 = require("node:child_process");
 const errors_1 = require("./errors");
+const debug_dump_1 = require("./debug-dump");
 const emit_1 = require("./emit");
 const project_1 = require("./project");
-const backend_1 = require("./backend");
-const ANQSTGEN_ACTIVE_STAMP_FILE = ".anqstgen-version-active.json";
-function generationTargetsForBackend(backendId, targets) {
-    if (backendId !== "tsc")
-        return targets;
-    // tsc backend currently supports QWidget and node_express_ws emitters only.
-    return {
-        emitQWidget: targets.emitQWidget,
-        emitAngularService: false,
-        emitNodeExpressWs: targets.emitNodeExpressWs
-    };
-}
+const layout_1 = require("./layout");
+const parser_1 = require("./parser");
+const verify_1 = require("./verify");
+const build_stamp_1 = require("./build-stamp");
 function renderHelp() {
+    const version = readActiveBuildStamp();
     return [
+        `anqst version ${version}`,
+        "",
         "Usage:",
         "  anqst <command> [arguments] [options]",
         "",
         "Commands:",
         "  instill <WidgetName>       Initialize AnQst in current npm project",
-        "  test                        Verify package.json AnQst spec",
-        "  build [--backend <id>] [--designerplugin[=true|false]]      Generate artifacts from package.json AnQst spec",
-        "  generate <specFile> [--backend <id>]  Generate artifacts from explicit spec file",
-        "  verify <specFile> [--backend <id>]    Verify explicit spec file only",
+        "  test                        Verify AnQst spec from package settings",
+        "  build [--designerplugin[=true|false]]   Generate artifacts from package settings",
+        "  generate <specFile>         Generate artifacts from explicit spec file",
+        "  verify <specFile>           Verify explicit spec file only",
         "  clean <path> [-f|--force]   Remove generated artifacts under path",
         "",
         "Options:",
-        "  --backend <id>              Backend for build/generate/verify: ast|tsc",
-        "  --designerplugin            Build Qt Designer plugin (build command only, tsc + QWidget)",
-        "  -h, --help                  Show this help output"
+        "  --designerplugin            Build Qt Designer plugin (build command only, QWidget target required)",
+        "  -h, --help                  Show this help output",
+        "  -v, --version               Print CLI version"
     ].join("\n");
 }
 function usageFor(command) {
     if (command === "instill")
         return "Usage: anqst instill <WidgetName>";
     if (command === "build")
-        return "Usage: anqst build [--backend <id>] [--designerplugin[=true|false]]";
+        return "Usage: anqst build [--designerplugin[=true|false]]";
     if (command === "verify")
-        return "Usage: anqst verify <specFile> [--backend <id>]";
+        return "Usage: anqst verify <specFile>";
     if (command === "generate")
-        return "Usage: anqst generate <specFile> [--backend <id>]";
+        return "Usage: anqst generate <specFile>";
     if (command === "clean")
         return "Usage: anqst clean <path> [-f|--force]";
     return renderHelp();
 }
-function runVerify(specArg, backendId = "ast") {
-    const specPath = node_path_1.default.resolve(process.cwd(), specArg);
-    const backend = (0, backend_1.resolveBackend)(backendId);
-    const parsed = backend.parseSpecFile(specPath);
-    const verification = backend.verifySpec(parsed);
-    return {
-        success: true,
-        message: verification.message
-    };
-}
-function runGenerate(specArg, backendId = "ast") {
-    const cwd = process.cwd();
-    const specPath = node_path_1.default.resolve(cwd, specArg);
-    const backend = (0, backend_1.resolveBackend)(backendId);
-    const parsed = backend.parseSpecFile(specPath);
-    const verification = backend.verifySpec(parsed);
-    const generationTargets = generationTargetsForBackend(backend.id, resolveGenerationTargetsFromCwd(cwd));
-    const outputs = backend.generateOutputs(parsed, generationTargets);
-    if (backend.emitsArtifacts) {
-        (0, emit_1.writeGeneratedOutputs)(cwd, outputs);
-        if (generationTargets.emitAngularService) {
-            (0, emit_1.installTypeScriptOutputs)(cwd);
-        }
-        if (generationTargets.emitQWidget) {
-            (0, emit_1.installQtIntegrationCMake)(cwd, parsed.widgetName);
-        }
+function resetGeneratedTargets(cwd, widgetName, targets) {
+    const layout = (0, layout_1.resolveGeneratedLayoutPaths)(cwd, widgetName);
+    const roots = new Set();
+    if (targets.emitAngularService) {
+        roots.add(layout.frontendRoot);
     }
-    else {
-        const relativeSpecFile = normalizeSlashes(node_path_1.default.relative(cwd, specPath));
-        return {
-            success: true,
-            verificationMessage: verification.message,
-            message: `\nAnQst spec ${relativeSpecFile} built.\n    Backend '${backend.id}' is a non-emitting skeleton. No artifacts were generated.\n`
-        };
+    if (targets.emitNodeExpressWs) {
+        roots.add(layout.nodeExpressRoot);
+    }
+    if (targets.emitQWidget) {
+        roots.add(layout.cppQtWidgetRoot);
+        roots.add(layout.cppCmakeRoot);
+    }
+    if ((0, debug_dump_1.isDebugEnabled)()) {
+        roots.add(layout.debugIntermediateRoot);
+    }
+    for (const root of roots) {
+        node_fs_1.default.rmSync(root, { recursive: true, force: true });
     }
-    const relativeSpecFile = normalizeSlashes(node_path_1.default.relative(cwd, specPath));
-    const relativeTypeScriptInstallPath = normalizeSlashes(node_path_1.default.relative(cwd, node_path_1.default.join(cwd, "src", "anqst-generated")));
-    const relativeCppLibraryPath = normalizeSlashes(node_path_1.default.relative(cwd, node_path_1.default.join(cwd, "generated_output", `${parsed.widgetName}_QtWidget`)));
-    const relativeNodeModulePath = normalizeSlashes(node_path_1.default.relative(cwd, node_path_1.default.join(cwd, "generated_output", `${parsed.widgetName}_node_express_ws`)));
-    const serviceList = parsed.services.map((s) => s.name).join(", ");
+}
+function buildGenerateSummary(cwd, specPath, widgetName, generationTargets) {
+    const layout = (0, layout_1.resolveGeneratedLayoutPaths)(cwd, widgetName);
+    const relativeSpecFile = (0, layout_1.normalizeSlashes)(node_path_1.default.relative(cwd, specPath));
+    const servicePath = (0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.frontendRoot, "services"));
+    const typePath = (0, layout_1.toProjectRelative)(cwd, node_path_1.default.join(layout.frontendRoot, "types"));
+    const widgetRootPath = (0, layout_1.toProjectRelative)(cwd, layout.cppQtWidgetRoot);
+    const nodePath = (0, layout_1.toProjectRelative)(cwd, layout.nodeExpressRoot);
     const messageLines = [];
     messageLines.push(`AnQst spec ${relativeSpecFile} built.`);
     if (generationTargets.emitAngularService) {
-        messageLines.push(`    Services ${serviceList} are available from ${relativeTypeScriptInstallPath}/services.`);
-        messageLines.push(`    Generated types are available from ${relativeTypeScriptInstallPath}/types.`);
+        messageLines.push(`    Services are available from ${servicePath}.`);
+        messageLines.push(`    Generated types are available from ${typePath}.`);
     }
     if (generationTargets.emitQWidget) {
-        messageLines.push(`    Widget library available in ${relativeCppLibraryPath}.`);
+        messageLines.push(`    Widget library available in ${widgetRootPath}.`);
     }
     if (generationTargets.emitNodeExpressWs) {
-        messageLines.push(`    Node Express WS module available in ${relativeNodeModulePath}.`);
+        messageLines.push(`    Node Express WS module available in ${nodePath}.`);
     }
     if (!generationTargets.emitAngularService && !generationTargets.emitQWidget && !generationTargets.emitNodeExpressWs) {
         messageLines.push("    No outputs selected by AnQst.generate.");
     }
+    return `\n${messageLines.join("\n")}\n`;
+}
+function runVerify(specArg) {
+    const specPath = node_path_1.default.resolve(process.cwd(), specArg);
+    const parsed = (0, parser_1.parseSpecFile)(specPath);
+    const verification = (0, verify_1.verifySpec)(parsed);
+    return {
+        success: true,
+        message: verification.message
+    };
+}
+function runGenerate(specArg) {
+    const cwd = process.cwd();
+    const specPath = node_path_1.default.resolve(cwd, specArg);
+    const parsed = (0, parser_1.parseSpecFile)(specPath);
+    const verification = (0, verify_1.verifySpec)(parsed);
+    const generationTargets = resolveGenerationTargetsFromCwd(cwd);
+    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);
+    }
     return {
         success: true,
         verificationMessage: verification.message,
-        message: `\n${messageLines.join("\n")}\n`
+        message: buildGenerateSummary(cwd, specPath, parsed.widgetName, generationTargets)
     };
 }
 function runTest(cwd) {
     const specPath = (0, project_1.resolveAnQstSpecPath)(cwd);
-    const backend = (0, backend_1.resolveBackend)("ast");
-    const parsed = backend.parseSpecFile(specPath);
-    const verification = backend.verifySpec(parsed);
+    const parsed = (0, parser_1.parseSpecFile)(specPath);
+    const verification = (0, verify_1.verifySpec)(parsed);
     return {
         success: true,
         message: verification.message
     };
 }
-function resolveAnQstGenRoot() {
-    return node_path_1.default.resolve(__dirname, "..", "..");
-}
 function readActiveBuildStamp() {
-    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";
+    return build_stamp_1.ANQST_BUILD_STAMP;
 }
-function runDesignerPluginBuild(cwd) {
-    const pluginSourceDir = node_path_1.default.join(cwd, "anqst-cmake", "designerplugin");
-    const pluginBuildDir = node_path_1.default.join(cwd, "anqst-cmake", "build-designerplugin");
+function runDesignerPluginBuild(cwd, widgetName) {
+    const layout = (0, layout_1.resolveGeneratedLayoutPaths)(cwd, widgetName);
+    const pluginSourceDir = layout.designerPluginRoot;
+    const pluginBuildDir = layout.designerPluginBuildRoot;
     const webBaseDir = process.env.ANQST_WEBBASE_DIR?.trim();
     if (!webBaseDir) {
         throw new errors_1.VerifyError("Missing ANQST_WEBBASE_DIR environment variable for --designerplugin build.");
@@ -187,181 +174,117 @@ function runDesignerPluginBuild(cwd) {
         throw new errors_1.VerifyError("CMake build failed while compiling Qt Designer plugin.");
     }
 }
-function runBuild(cwd, backendId = "ast", designerPlugin = false) {
+function runBuild(cwd, designerPlugin = false) {
     const buildVersion = readActiveBuildStamp();
-    process.env.ANQST_BUILD_STAMP = buildVersion;
-    try {
-        const backend = (0, backend_1.resolveBackend)(backendId);
-        const specPath = (0, project_1.resolveAnQstSpecPath)(cwd);
-        const generationTargets = generationTargetsForBackend(backend.id, resolveGenerationTargetsFromCwd(cwd, true));
-        const parsed = backend.parseSpecFile(specPath);
-        backend.verifySpec(parsed);
-        const outputs = backend.generateOutputs(parsed, generationTargets);
-        if (backend.emitsArtifacts) {
-            (0, emit_1.writeGeneratedOutputs)(cwd, outputs);
-            if (generationTargets.emitAngularService) {
-                (0, emit_1.installTypeScriptOutputs)(cwd);
-            }
-            if (generationTargets.emitQWidget) {
-                (0, emit_1.installQtIntegrationCMake)(cwd, parsed.widgetName);
-            }
-        }
-        else {
-            return {
-                success: true,
-                message: `Build completed: backend '${backend.id}' is a non-emitting skeleton; no artifacts were generated`
-            };
-        }
-        const hasAngularProject = generationTargets.emitQWidget && node_fs_1.default.existsSync(node_path_1.default.join(cwd, "angular.json"));
-        if (hasAngularProject && generationTargets.emitQWidget) {
-            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.");
-            }
-        }
-        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 (backend.id !== "tsc") {
-                console.warn("[AnQst] --designerplugin is only supported with --backend tsc. Skipping designer plugin build.");
-            }
-            else 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);
-                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 detailLines = [];
-        if (generationTargets.emitAngularService) {
-            detailLines.push("    Target AngularService:");
-            detailLines.push("      - Services output: src/anqst-generated/services");
-            detailLines.push("      - Types output: src/anqst-generated/types");
+    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.");
         }
-        if (generationTargets.emitQWidget) {
-            detailLines.push("    Target QWidget:");
-            detailLines.push("      - Qt integration CMake: anqst-cmake/CMakeLists.txt");
-            detailLines.push(`      - Widget output root: generated_output/${parsed.widgetName}_QtWidget`);
-            detailLines.push("      - Embedded web assets refreshed from Angular build");
+    }
+    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.");
         }
-        if (generationTargets.emitNodeExpressWs) {
-            detailLines.push("    Target node_express_ws:");
-            detailLines.push(`      - Module output root: generated_output/${parsed.widgetName}_node_express_ws`);
+    }
+    let designerPluginBuilt = false;
+    if (designerPlugin) {
+        if (!generationTargets.emitQWidget) {
+            console.warn("[AnQst] --designerplugin requested but QWidget target is not enabled. Skipping designer plugin build.");
         }
-        if (designerPluginBuilt) {
-            const pluginBinaryPath = normalizeSlashes(node_path_1.default.join("anqst-cmake", "build-designerplugin", designerPluginBinaryName(parsed.widgetName)));
-            detailLines.push("    Target QtDesignerPlugin:");
-            detailLines.push("      - Build output: anqst-cmake/build-designerplugin");
-            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/"`);
+        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}`,
-                ...detailLines
+                "    No outputs selected by AnQst.generate."
             ].join("\n")
         };
     }
-    finally {
-        delete process.env.ANQST_BUILD_STAMP;
+    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/\"`);
     }
+    return {
+        success: true,
+        message: [
+            "Build completed.",
+            `    anqst version ${buildVersion}`,
+            ...detailLines
+        ].join("\n")
+    };
 }
-function parseBackendCommandArgs(commandName, specArg, extraArgs, requireSpec) {
+function parseSpecCommandArg(commandName, specArg, extraArgs) {
     const allArgs = [specArg, ...extraArgs].filter((arg) => typeof arg === "string" && arg.length > 0);
-    let backendId = "ast";
     const positional = [];
-    for (let i = 0; i < allArgs.length; i += 1) {
-        const arg = allArgs[i];
-        if (arg === "--backend") {
-            const value = allArgs[i + 1];
-            if (!value || value.startsWith("-")) {
-                throw new Error(`Missing value for --backend. ${usageFor(commandName)}`);
-            }
-            if (!(0, backend_1.isBackendId)(value)) {
-                throw new Error(`Unknown backend '${value}'. Allowed backends: ast, tsc.`);
-            }
-            backendId = value;
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith("--backend=")) {
-            const value = arg.slice("--backend=".length);
-            if (!(0, backend_1.isBackendId)(value)) {
-                throw new Error(`Unknown backend '${value}'. Allowed backends: ast, tsc.`);
-            }
-            backendId = value;
-            continue;
-        }
+    for (const arg of allArgs) {
         if (arg.startsWith("-")) {
             throw new Error(`Unknown ${commandName} flag '${arg}'. ${usageFor(commandName)}`);
         }
         positional.push(arg);
     }
-    if (requireSpec) {
-        if (positional.length !== 1) {
-            throw new Error(usageFor(commandName));
-        }
-        return { backendId, specArg: positional[0] };
+    if (positional.length !== 1) {
+        throw new Error(usageFor(commandName));
     }
-    if (positional.length > 0) {
-        throw new Error(`Unexpected extra argument '${positional[0]}'. ${usageFor(commandName)}`);
-    }
-    return { backendId };
+    return positional[0];
 }
 function parseBuildCommandArgs(specArg, extraArgs) {
     const allArgs = [specArg, ...extraArgs].filter((arg) => typeof arg === "string" && arg.length > 0);
-    let backendId = "ast";
     let designerPlugin = false;
     const positional = [];
     for (let i = 0; i < allArgs.length; i += 1) {
         const arg = allArgs[i];
-        if (arg === "--backend") {
-            const value = allArgs[i + 1];
-            if (!value || value.startsWith("-")) {
-                throw new Error(`Missing value for --backend. ${usageFor("build")}`);
-            }
-            if (!(0, backend_1.isBackendId)(value)) {
-                throw new Error(`Unknown backend '${value}'. Allowed backends: ast, tsc.`);
-            }
-            backendId = value;
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith("--backend=")) {
-            const value = arg.slice("--backend=".length);
-            if (!(0, backend_1.isBackendId)(value)) {
-                throw new Error(`Unknown backend '${value}'. Allowed backends: ast, tsc.`);
-            }
-            backendId = value;
-            continue;
-        }
         if (arg === "--designerplugin") {
             const value = allArgs[i + 1];
             if (value && !value.startsWith("-")) {
@@ -386,7 +309,7 @@ function parseBuildCommandArgs(specArg, extraArgs) {
     if (positional.length > 0) {
         throw new Error(`Unexpected extra argument '${positional[0]}'. ${usageFor("build")}`);
     }
-    return { backendId, designerPlugin };
+    return { designerPlugin };
 }
 function parseCleanCommandArgs(specArg, extraArgs) {
     const allArgs = [specArg, ...extraArgs].filter((arg) => typeof arg === "string" && arg.length > 0);
@@ -442,7 +365,7 @@ function formatCleanResult(targetRoot, rows) {
     const notFound = rows.filter((row) => row.status === "not_found");
     const failed = rows.filter((row) => row.status === "failed");
     const lines = [];
-    lines.push(`[AnQst] Clean summary for ${normalizeSlashes(targetRoot)}`);
+    lines.push(`[AnQst] Clean summary for ${(0, layout_1.normalizeSlashes)(targetRoot)}`);
     if (deleted.length > 0) {
         lines.push(`  Deleted (${deleted.length})`);
         for (const row of deleted)
@@ -464,14 +387,14 @@ function resolveGenerationTargetsFromCwd(cwd, requirePackageAnQst = false) {
     const packagePath = node_path_1.default.join(cwd, "package.json");
     if (!node_fs_1.default.existsSync(packagePath)) {
         if (requirePackageAnQst) {
-            throw new errors_1.VerifyError("No package.json: Can only build AnQst inside an npm project.");
+            throw new errors_1.VerifyError("No package.json: AnQst commands must run inside an npm project.");
         }
         return toGenerationTargets([...project_1.DEFAULT_ANQST_GENERATE_TARGETS]);
     }
     const packageJson = JSON.parse(node_fs_1.default.readFileSync(packagePath, "utf8"));
     if (packageJson.AnQst === undefined) {
         if (requirePackageAnQst) {
-            throw new errors_1.VerifyError("Missing package.json key 'AnQst.spec'. Run 'anqst instill <WidgetName>' first.");
+            throw new errors_1.VerifyError("Missing package.json key 'AnQst'. Run 'anqst instill <WidgetName>' first.");
         }
         return toGenerationTargets([...project_1.DEFAULT_ANQST_GENERATE_TARGETS]);
     }
@@ -484,40 +407,24 @@ function toGenerationTargets(targets) {
         emitNodeExpressWs: targets.includes("node_express_ws")
     };
 }
-function resolveAnQstSpecFromPackage(targetRoot) {
-    const packagePath = node_path_1.default.join(targetRoot, "package.json");
-    if (!node_fs_1.default.existsSync(packagePath)) {
-        throw new Error(`No package.json with an AnQst key found at '${normalizeSlashes(targetRoot)}'. Use 'anqst clean ${normalizeSlashes(targetRoot)} --force' to clean anyway.`);
-    }
-    const packageJson = JSON.parse(node_fs_1.default.readFileSync(packagePath, "utf8"));
-    const spec = packageJson.AnQst?.spec;
-    if (!spec || spec.trim().length === 0) {
-        throw new Error(`No package.json with an AnQst key found at '${normalizeSlashes(targetRoot)}'. Use 'anqst clean ${normalizeSlashes(targetRoot)} --force' to clean anyway.`);
-    }
-    return node_path_1.default.resolve(targetRoot, spec);
-}
 function runClean(pathArg, force) {
     const targetRoot = node_path_1.default.resolve(process.cwd(), pathArg);
-    const broadDirs = [
-        "generated_output",
-        node_path_1.default.join("src", "anqst-generated"),
-        "anqst-cmake"
-    ];
     if (force) {
-        const rows = runCleanup(targetRoot, broadDirs);
+        const rows = runCleanup(targetRoot, [(0, layout_1.normalizeSlashes)(node_path_1.default.join("AnQst", "generated"))]);
         return {
             success: true,
             message: formatCleanResult(targetRoot, rows),
             hadFailures: rows.some((row) => row.status === "failed")
         };
     }
-    const specPath = resolveAnQstSpecFromPackage(targetRoot);
-    const parsed = (0, backend_1.resolveBackend)("ast").parseSpecFile(specPath);
+    const context = (0, project_1.resolveAnQstSettings)(targetRoot);
+    const layout = (0, layout_1.resolveGeneratedLayoutPaths)(targetRoot, context.settings.widgetName);
     const widgetDirs = [
-        node_path_1.default.join("generated_output", `${parsed.widgetName}_QtWidget`),
-        node_path_1.default.join("generated_output", `${parsed.widgetName}_node_express_ws`),
-        node_path_1.default.join("src", "anqst-generated"),
-        "anqst-cmake"
+        (0, layout_1.normalizeSlashes)(node_path_1.default.relative(targetRoot, layout.frontendRoot)),
+        (0, layout_1.normalizeSlashes)(node_path_1.default.relative(targetRoot, layout.nodeExpressRoot)),
+        (0, layout_1.normalizeSlashes)(node_path_1.default.relative(targetRoot, layout.cppQtWidgetRoot)),
+        (0, layout_1.normalizeSlashes)(node_path_1.default.relative(targetRoot, layout.cppCmakeRoot)),
+        (0, layout_1.normalizeSlashes)(node_path_1.default.relative(targetRoot, layout.debugIntermediateRoot))
     ];
     const rows = runCleanup(targetRoot, widgetDirs);
     return {
@@ -526,9 +433,6 @@ function runClean(pathArg, force) {
         hadFailures: rows.some((row) => row.status === "failed")
     };
 }
-function normalizeSlashes(inputPath) {
-    return inputPath.split(node_path_1.default.sep).join("/");
-}
 function designerPluginBinaryName(widgetName) {
     const targetName = `${widgetName}DesignerPlugin`;
     if (process.platform === "win32") {
@@ -556,6 +460,10 @@ function runCommand(command, specArg, extraArgs = []) {
             console.log(renderHelp());
             return 0;
         }
+        if (command === "-v" || command === "--version" || command === "version") {
+            console.log(`anqst version ${readActiveBuildStamp()}`);
+            return 0;
+        }
         const normalizedCommand = command === "install" ? "instill" : command;
         if (command === "install") {
             console.log(renderInstallAliasMessage());
@@ -576,19 +484,19 @@ function runCommand(command, specArg, extraArgs = []) {
         }
         if (normalizedCommand === "build") {
             const parsedArgs = parseBuildCommandArgs(specArg, extraArgs);
-            const res = runBuild(process.cwd(), parsedArgs.backendId, parsedArgs.designerPlugin);
+            const res = runBuild(process.cwd(), parsedArgs.designerPlugin);
             console.log(res.message);
             return 0;
         }
         if (normalizedCommand === "verify") {
-            const parsedArgs = parseBackendCommandArgs("verify", specArg, extraArgs, true);
-            const res = runVerify(parsedArgs.specArg, parsedArgs.backendId);
+            const specArgParsed = parseSpecCommandArg("verify", specArg, extraArgs);
+            const res = runVerify(specArgParsed);
             console.log(res.message);
             return 0;
         }
         if (normalizedCommand === "generate") {
-            const parsedArgs = parseBackendCommandArgs("generate", specArg, extraArgs, true);
-            const res = runGenerate(parsedArgs.specArg, parsedArgs.backendId);
+            const specArgParsed = parseSpecCommandArg("generate", specArg, extraArgs);
+            const res = runGenerate(specArgParsed);
             if (res.verificationMessage) {
                 console.log(res.verificationMessage);
             }

package/dist/src/build-stamp.js

@@ -0,0 +1,5 @@
+"use strict";
+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";

package/dist/src/{backend/tsc/debug-dump.js → debug-dump.js}

@@ -9,11 +9,12 @@ exports.inspectText = inspectText;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_util_1 = __importDefault(require("node:util"));
+const layout_1 = require("./layout");
 function isDebugEnabled() {
     return process.env.ANQST_DEBUG === "true";
 }
 function baseIntermediateDir(cwd) {
-    return node_path_1.default.join(cwd, "generated_output", "intermediate");
+    return (0, layout_1.anqstDebugIntermediateRootDir)(cwd);
 }
 function writeDebugFile(cwd, relativePath, content) {
     if (!isDebugEnabled())