quick-host-compiler

packages/quick-host-compiler is currently packaged as a Node library. The public package surface exports runCompileCommand together with the related option and report types.

Example:

import { runCompileCommand } from "@stechquick/quick-host-compiler";

const report = JSON.parse(await runCompileCommand("sampleQjsons/a.qjson", {
	emit: true,
	destination: "./compiledFiles",
	verbose: true,
}));

Behavior:

• runCompileCommand(source, options) accepts either a .qjson file path or a folder path.
• Folder compilation walks subfolders recursively and compiles every .qjson file it finds.
• emit writes compiled output files.
• destination chooses the output folder and is valid only together with emit.
• If emit is enabled without destination, output is written under compiledFiles in the current working directory.
• stacktrace includes stack traces in reported runtime and compile errors when available.
• verbose prints resolved arguments/options, folder inspection progress, discovered qjson files, and per-file compilation activity.
• The command runner returns the final report as a serialized JSON string.

Build:

• npm run check:build -w packages/quick-host-compiler runs the typecheck-oriented build validation.
• npm run build -w packages/quick-host-compiler produces runtime JavaScript plus declaration files.
• npm pack -w packages/quick-host-compiler packages the built output from dist/ for distribution.

TypeScript flows:

• tsconfig.runtime.json emits the runtime Node output under dist/ and explicitly includes ../../common/shrimp/omniScriptCompiler/Parser.js so the generated package keeps the required runtime file.
• tsconfig.build.json emits only .d.ts files for consumers.

Package output:

• Runtime entry: dist/packages/quick-host-compiler/src/index.js
• Types entry: dist/packages/quick-host-compiler/src/index.d.ts
• package.json exports only the root module entry.

Standalone test:

• Run npm run build -w packages/quick-host-compiler first so dist/ contains the test entrypoint.
• cd packages/quick-host-compiler && npm run test ./sampleQjsons/a.qjson runs the standalone test script.
• npm run test <path> accepts either a .qjson file path or a folder path. The test script runs the compile command and prints the serialized JSON report.