@dusted/anqst 0.1.0 → 0.1.2

package/dist/src/app.js

@@ -12,11 +12,14 @@ exports.runCommand = runCommand;
 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 parser_1 = require("./parser");
-const verify_1 = require("./verify");
 const errors_1 = require("./errors");
+const debug_dump_1 = require("./debug-dump");
 const emit_1 = require("./emit");
 const project_1 = require("./project");
+const layout_1 = require("./layout");
+const parser_1 = require("./parser");
+const verify_1 = require("./verify");
+const ANQSTGEN_ACTIVE_STAMP_FILE = ".anqstgen-version-active.json";
 function renderHelp() {
     return [
         "Usage:",
@@ -24,19 +27,22 @@ function renderHelp() {
         "",
         "Commands:",
         "  instill <WidgetName>       Initialize AnQst in current npm project",
-        "  test                        Verify package.json AnQst spec",
-        "  build                       Generate artifacts from package.json AnQst spec",
+        "  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:",
+        "  --designerplugin            Build Qt Designer plugin (build command only, QWidget target required)",
         "  -h, --help                  Show this help output"
     ].join("\n");
 }
 function usageFor(command) {
     if (command === "instill")
         return "Usage: anqst instill <WidgetName>";
+    if (command === "build")
+        return "Usage: anqst build [--designerplugin[=true|false]]";
     if (command === "verify")
         return "Usage: anqst verify <specFile>";
     if (command === "generate")
@@ -45,6 +51,50 @@ function usageFor(command) {
         return "Usage: anqst clean <path> [-f|--force]";
     return renderHelp();
 }
+function resetGeneratedTargets(cwd, widgetName, targets) {
+    const layout = (0, layout_1.resolveGeneratedLayoutPaths)(cwd, widgetName);
+    const roots = new Set();
+    if (targets.emitAngularService) {
+        roots.add(layout.frontendRoot);
+    }
+    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 });
+    }
+}
+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 are available from ${servicePath}.`);
+        messageLines.push(`    Generated types are available from ${typePath}.`);
+    }
+    if (generationTargets.emitQWidget) {
+        messageLines.push(`    Widget library available in ${widgetRootPath}.`);
+    }
+    if (generationTargets.emitNodeExpressWs) {
+        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);
@@ -60,38 +110,16 @@ function runGenerate(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.emitAngularService) {
-        (0, emit_1.installTypeScriptOutputs)(cwd);
-    }
     if (generationTargets.emitQWidget) {
         (0, emit_1.installQtIntegrationCMake)(cwd, parsed.widgetName);
     }
-    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(", ");
-    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.`);
-    }
-    if (generationTargets.emitQWidget) {
-        messageLines.push(`    Widget library available in ${relativeCppLibraryPath}.`);
-    }
-    if (generationTargets.emitNodeExpressWs) {
-        messageLines.push(`    Node Express WS module available in ${relativeNodeModulePath}.`);
-    }
-    if (!generationTargets.emitAngularService && !generationTargets.emitQWidget && !generationTargets.emitNodeExpressWs) {
-        messageLines.push("    No outputs selected by AnQst.generate.");
-    }
     return {
         success: true,
         verificationMessage: verification.message,
-        message: `\n${messageLines.join("\n")}\n`
+        message: buildGenerateSummary(cwd, specPath, parsed.widgetName, generationTargets)
     };
 }
 function runTest(cwd) {
@@ -103,57 +131,206 @@ function runTest(cwd) {
         message: verification.message
     };
 }
-function runBuild(cwd) {
-    const specPath = (0, project_1.resolveAnQstSpecPath)(cwd);
-    const generationTargets = resolveGenerationTargetsFromCwd(cwd, true);
-    const parsed = (0, parser_1.parseSpecFile)(specPath);
-    (0, verify_1.verifySpec)(parsed);
-    const outputs = (0, emit_1.generateOutputs)(parsed, generationTargets);
-    (0, emit_1.writeGeneratedOutputs)(cwd, outputs);
-    if (generationTargets.emitAngularService) {
-        (0, emit_1.installTypeScriptOutputs)(cwd);
+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();
     }
-    if (generationTargets.emitQWidget) {
-        (0, emit_1.installQtIntegrationCMake)(cwd, parsed.widgetName);
+    const activePath = node_path_1.default.join(resolveAnQstGenRoot(), ANQSTGEN_ACTIVE_STAMP_FILE);
+    if (!node_fs_1.default.existsSync(activePath)) {
+        return "unknown_build_0";
     }
-    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.");
+    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();
         }
     }
-    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.");
-        }
+    catch {
+        // Fallback to deterministic unknown stamp.
     }
-    if (!generationTargets.emitAngularService && !generationTargets.emitQWidget && !generationTargets.emitNodeExpressWs) {
+    return "unknown_build_0";
+}
+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.");
+    }
+    const configureArgs = [
+        "-S",
+        pluginSourceDir,
+        "-B",
+        pluginBuildDir,
+        "-DCMAKE_BUILD_TYPE=Release",
+        `-DANQST_WEBBASE_DIR=${webBaseDir}`
+    ];
+    const configure = (0, node_child_process_1.spawnSync)("cmake", configureArgs, {
+        cwd,
+        stdio: "inherit",
+        shell: process.platform === "win32"
+    });
+    if (configure.status !== 0) {
+        throw new errors_1.VerifyError([
+            "CMake configure failed while building Qt Designer plugin.",
+            "If CMake reports missing Qt5UiPlugin, install qttools5-dev (Ubuntu/Debian) and re-run install_dependencies.sh."
+        ].join(" "));
+    }
+    const build = (0, node_child_process_1.spawnSync)("cmake", ["--build", pluginBuildDir, "--config", "Release"], {
+        cwd,
+        stdio: "inherit",
+        shell: process.platform === "win32"
+    });
+    if (build.status !== 0) {
+        throw new errors_1.VerifyError("CMake build failed while compiling Qt Designer plugin.");
+    }
+}
+function runBuild(cwd, designerPlugin = false) {
+    const buildVersion = readActiveBuildStamp();
+    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}'.`);
+        }
+        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) {
+            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/\"`);
+        }
         return {
             success: true,
-            message: "Build completed: no outputs selected by AnQst.generate"
+            message: [
+                "Build completed.",
+                `    anqst version ${buildVersion}`,
+                ...detailLines
+            ].join("\n")
         };
     }
-    const parts = [];
-    if (generationTargets.emitAngularService) {
-        parts.push("TypeScript installed to src/anqst-generated");
+    finally {
+        delete process.env.ANQST_BUILD_STAMP;
     }
-    if (generationTargets.emitQWidget) {
-        parts.push("Qt integration CMake emitted to anqst-cmake/");
-        parts.push("C++ widget library refreshed with embedded web assets");
+}
+function parseSpecCommandArg(commandName, specArg, extraArgs) {
+    const allArgs = [specArg, ...extraArgs].filter((arg) => typeof arg === "string" && arg.length > 0);
+    const positional = [];
+    for (const arg of allArgs) {
+        if (arg.startsWith("-")) {
+            throw new Error(`Unknown ${commandName} flag '${arg}'. ${usageFor(commandName)}`);
+        }
+        positional.push(arg);
     }
-    if (generationTargets.emitNodeExpressWs) {
-        parts.push(`Node Express WS module emitted to generated_output/${parsed.widgetName}_node_express_ws`);
+    if (positional.length !== 1) {
+        throw new Error(usageFor(commandName));
     }
-    return {
-        success: true,
-        message: `Build completed: ${parts.join(", ")}`
-    };
+    return positional[0];
+}
+function parseBuildCommandArgs(specArg, extraArgs) {
+    const allArgs = [specArg, ...extraArgs].filter((arg) => typeof arg === "string" && arg.length > 0);
+    let designerPlugin = false;
+    const positional = [];
+    for (let i = 0; i < allArgs.length; i += 1) {
+        const arg = allArgs[i];
+        if (arg === "--designerplugin") {
+            const value = allArgs[i + 1];
+            if (value && !value.startsWith("-")) {
+                designerPlugin = value.toLowerCase() === "true";
+                i += 1;
+            }
+            else {
+                designerPlugin = true;
+            }
+            continue;
+        }
+        if (arg.startsWith("--designerplugin=")) {
+            const value = arg.slice("--designerplugin=".length);
+            designerPlugin = value.toLowerCase() === "true";
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            throw new Error(`Unknown build flag '${arg}'. ${usageFor("build")}`);
+        }
+        positional.push(arg);
+    }
+    if (positional.length > 0) {
+        throw new Error(`Unexpected extra argument '${positional[0]}'. ${usageFor("build")}`);
+    }
+    return { designerPlugin };
 }
 function parseCleanCommandArgs(specArg, extraArgs) {
     const allArgs = [specArg, ...extraArgs].filter((arg) => typeof arg === "string" && arg.length > 0);
@@ -209,7 +386,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)
@@ -231,14 +408,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]);
     }
@@ -251,40 +428,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, parser_1.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 {
@@ -293,8 +454,22 @@ 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") {
+        return `${targetName}.dll`;
+    }
+    if (process.platform === "darwin") {
+        return `${targetName}.dylib`;
+    }
+    return `${targetName}.so`;
+}
+function renderInstallAliasMessage() {
+    const useColor = process.stdout.isTTY;
+    const text = "[AnQst] 'install' spotted. Muscle memory is undefeated - running 'instill' for you.";
+    if (!useColor)
+        return text;
+    return `\x1b[38;5;214m${text}\x1b[0m`;
 }
 function runCommand(command, specArg, extraArgs = []) {
     try {
@@ -306,7 +481,11 @@ function runCommand(command, specArg, extraArgs = []) {
             console.log(renderHelp());
             return 0;
         }
-        if (command === "instill") {
+        const normalizedCommand = command === "install" ? "instill" : command;
+        if (command === "install") {
+            console.log(renderInstallAliasMessage());
+        }
+        if (normalizedCommand === "instill") {
             if (!specArg) {
                 console.error(usageFor("instill"));
                 return 1;
@@ -315,38 +494,33 @@ function runCommand(command, specArg, extraArgs = []) {
             console.log(msg);
             return 0;
         }
-        if (command === "test") {
+        if (normalizedCommand === "test") {
             const res = runTest(process.cwd());
             console.log(res.message);
             return 0;
         }
-        if (command === "build") {
-            const res = runBuild(process.cwd());
+        if (normalizedCommand === "build") {
+            const parsedArgs = parseBuildCommandArgs(specArg, extraArgs);
+            const res = runBuild(process.cwd(), parsedArgs.designerPlugin);
             console.log(res.message);
             return 0;
         }
-        if (command === "verify") {
-            if (!specArg) {
-                console.error(usageFor("verify"));
-                return 1;
-            }
-            const res = runVerify(specArg);
+        if (normalizedCommand === "verify") {
+            const specArgParsed = parseSpecCommandArg("verify", specArg, extraArgs);
+            const res = runVerify(specArgParsed);
             console.log(res.message);
             return 0;
         }
-        if (command === "generate") {
-            if (!specArg) {
-                console.error(usageFor("generate"));
-                return 1;
-            }
-            const res = runGenerate(specArg);
+        if (normalizedCommand === "generate") {
+            const specArgParsed = parseSpecCommandArg("generate", specArg, extraArgs);
+            const res = runGenerate(specArgParsed);
             if (res.verificationMessage) {
                 console.log(res.verificationMessage);
             }
             console.log(res.message);
             return 0;
         }
-        if (command === "clean") {
+        if (normalizedCommand === "clean") {
             const parsed = parseCleanCommandArgs(specArg, extraArgs);
             const res = runClean(parsed.targetPathArg, parsed.force);
             console.log(res.message);

package/dist/src/debug-dump.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDebugEnabled = isDebugEnabled;
+exports.writeDebugFile = writeDebugFile;
+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 (0, layout_1.anqstDebugIntermediateRootDir)(cwd);
+}
+function writeDebugFile(cwd, relativePath, content) {
+    if (!isDebugEnabled())
+        return;
+    try {
+        const targetPath = node_path_1.default.join(baseIntermediateDir(cwd), relativePath);
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(targetPath), { recursive: true });
+        node_fs_1.default.writeFileSync(targetPath, content, "utf8");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[AnQst][debug] Failed writing ${relativePath}: ${message}`);
+    }
+}
+function inspectText(value) {
+    return node_util_1.default.inspect(value, {
+        depth: null,
+        maxArrayLength: null,
+        maxStringLength: null,
+        breakLength: 120,
+        compact: false
+    });
+}