@machineblocks/cli 0.0.0-stage → 0.1.0

package/blocks/com/machineblocks/bml/cli/Library.bml

@@ -0,0 +1,52 @@
+<!--MachineBlocks CLI Library
+  FQN: com.machineblocks.bml.cli.Library-->
+<mbcli:Library xmlns="http://blockml.org/bml"
+  xmlns:blockml="org.blockml.bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:ucli="org.blockml.bml.cli"
+  xmlns:render="com.machineblocks.bml.target.render"
+  xmlns:mbcli="com.machineblocks.bml.cli">
+
+  <baseType>
+    core:BlockLibrary
+  </baseType>
+  <is>
+    The MachineBlocks host CLI library catalog
+  </is>
+  <version>
+    0.1.0
+  </version>
+  <documentation>
+    Publishable host-CLI library (com.machineblocks.bml.cli.Library).
+    Thin layer over @blockml/cli that registers the MachineBlocks SCAD target
+    and supplies MachineBlocks defaults. Recommended entry for MachineBlocks
+    users who want BML rendered to SCAD.
+
+    Membership is the file tree under this Library.bml.
+  </documentation>
+  <references>
+    <see type="mbcli:README" relation="ReadFirst" />
+  </references>
+  <language>
+    <blockml:language.English />
+  </language>
+  <properties>
+    <description override="true">
+      <value>MachineBlocks host CLI library</value>
+    </description>
+  </properties>
+  <aggregations>
+    <readMe override="true">
+      <composition>
+        <mbcli:README />
+      </composition>
+    </readMe>
+    <dependencies override="true">
+      <composition>
+        <blockml:Library />
+        <ucli:Library />
+        <render:Library />
+      </composition>
+    </dependencies>
+  </aggregations>
+</mbcli:Library>

package/blocks/com/machineblocks/bml/cli/README.bml

@@ -0,0 +1,31 @@
+<!--MachineBlocks CLI — README
+  FQN: com.machineblocks.bml.cli.README-->
+<mbcli:README xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:mbcli="com.machineblocks.bml.cli"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:ReadMe
+  </baseType>
+  <is>
+    Reading entry for the MachineBlocks host CLI library
+  </is>
+  <documentation>
+    @machineblocks/cli is the command MachineBlocks users run. It is not a second
+    compiler. It calls the same @blockml/cli and @blockml/compiler packages, with
+    the SCAD target already registered and with paths that match a MachineBlocks
+    project.
+
+    People who have not used BlockML can render .bml files to .scad without
+    learning toolchain target names, blockdoc, or xsd. People who want the full
+    toolchain still use the blockml command from @blockml/cli.
+
+    Start at com.machineblocks.bml.cli.documentation.Introduction.
+  </documentation>
+  <references>
+    <see type="clidoc:Introduction" relation="ReadFirst" />
+    <see type="clidoc:DualCliModel" relation="SeeAlso" />
+    <see type="clidoc:Commands" relation="SeeAlso" />
+  </references>
+</mbcli:README>

package/blocks/com/machineblocks/bml/cli/documentation/Commands.bml

@@ -0,0 +1,88 @@
+<!--CLI Documentation — Commands
+  FQN: com.machineblocks.bml.cli.documentation.Commands-->
+<clidoc:Commands xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    User-facing commands for rendering BML to SCAD
+  </is>
+  <documentation><![CDATA[
+    The host exposes a short command set. validate matches blockml validate.
+    compile takes a BlockML type selector, not a file path and not --out.
+
+    machineblocks validate [file]
+    - Same project validate as blockml validate.
+    - Exit 0 success, 1 diagnostics, 2 config or usage.
+    - Does not register the SCAD target and does not write SCAD.
+    - A file argument validates that file. --all validates the reachable corpus.
+      file and --all together exit 2.
+
+    machineblocks compile <source-selector>
+    - Compiles with target machineblocks-v3-scad.
+    - The selector is one BlockML type selector: an exact block FQN, a package
+      selector ending in .*, or a recursive selector ending in .**.
+      Resolution is scanTypes from the BlockML framework. This host does not
+      define a second selector language.
+    - --source-package <FQN> is the source package root for an explicit mapping.
+    - --target-package <FQN> is the target package root. It is not a directory
+      and not the FQN of one output file.
+    - --help shows this command.
+    - There is no --out and no --all. The output root is the configured srcDir
+      (default blocks).
+    - A selector only chooses blocks. It does not by itself choose the target
+      package, except that a package selector (a final .* or .** segment)
+      supplies the source root when --target-package is set and
+      --source-package is omitted. An exact block FQN does not supply a source
+      root.
+    - --source-package without --target-package exits 2 with
+      MB_SOURCE_PACKAGE_ALONE.
+    - --target-package without a derivable source root exits 2 with
+      MB_SOURCE_PACKAGE_REQUIRED.
+    - A missing selector, an unknown flag, or a selector scanTypes rejects
+      exits 2.
+    - Types whose baseType chain is neither com.machineblocks.bml.core.Block
+      nor com.machineblocks.bml.core.Set are skipped. If none remain, the host
+      exits 1 with MB_SELECTOR_EMPTY and the selector text.
+    - Mapping failures, collisions, and paths that leave srcDir or would
+      overwrite a .bml file exit 1. No output file is written unless every
+      selected block has a target FQN and a legal path, and every compile
+      succeeded.
+    - Exit 0 writes the SCAD or preset JSON files and a sibling .map when the
+      target attached a source map.
+
+    Host diagnostic codes:
+
+    - MB_SOURCE_PACKAGE_ALONE — --source-package without --target-package.
+    - MB_SOURCE_PACKAGE_REQUIRED — --target-package and the source root is not
+      determined. The message names --source-package.
+    - MB_SELECTOR_EMPTY — the selector matched no Block or Set.
+    - MB_TARGET_COLLISION — two selected blocks share a target FQN or output path.
+    - MB_OUTPUT_ESCAPES_SRC — a resolved path is outside srcDir.
+    - MB_OUTPUT_OVERWRITES_BML — a resolved path is an existing .bml file.
+
+    Mapping codes MB_TARGET_PACKAGE_UNDETERMINED, MB_TARGET_PACKAGE_AMBIGUOUS,
+    and MB_SOURCE_OUTSIDE_ROOT are defined with the manifestation rules.
+
+    machineblocks --help
+    - Lists these commands.
+    - Points advanced users to blockml --help for search, inspect, graph,
+      transform, new, and init.
+
+    Not in this host surface (still available via blockml if that package
+    is installed): watch, search, inspect, graph, transform, scaffolding, xsd
+    toggle, thumbnail generation.
+
+    Per-target matrix entry this host satisfies:
+
+        machineblocks-v3-scad — document target; selected by type selector;
+        written under srcDir; registered by @machineblocks/cli, not by @blockml/cli.
+
+  ]]></documentation>
+  <references>
+    <see type="clidoc:Configuration" relation="ReadNext" />
+  </references>
+</clidoc:Commands>

package/blocks/com/machineblocks/bml/cli/documentation/Configuration.bml

@@ -0,0 +1,54 @@
+<!--CLI Documentation — Configuration
+  FQN: com.machineblocks.bml.cli.documentation.Configuration-->
+<clidoc:Configuration xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    MachineBlocks defaults and blockml.config.json fields this host reads
+  </is>
+  <documentation>
+    The host reads blockml.config.json from the project root, the same file
+    @blockml/cli reads. It understands the universal keys and these MachineBlocks
+    keys. The universal CLI documents the MachineBlocks keys as unread in its V1;
+    this host is the reader.
+
+    Universal keys this host honours:
+
+    - srcDir — default blocks. Project BML sources, and the only compile output
+      root. Target FQNs are resolved to paths inside this directory. Compile
+      does not read outDir and does not accept --out.
+    - libraries — extra Library.bml seeds, appended to package.json blockml.library.
+    - targetOptions — opaque bag. Key machineblocks-v3-scad may carry
+      settingsFormat (pseudo-map or object). V1 emit is pseudo-map; object is
+      rejected with a diagnostic until the SCAD library accepts it.
+    - defaultTarget — this host treats machineblocks-v3-scad as the default even
+      when the key is omitted. If the key is set to another name, the host
+      reports that this command only compiles the SCAD target.
+
+    MachineBlocks keys:
+
+    - mbLibPath — root used to compute relative use/include paths to the SCAD
+      library (lib/block.scad, config/mb_config.scad, service .scad files).
+      Default: the installed @machineblocks/core package root.
+    - openscadPath — OpenSCAD executable for later thumbnail or preview commands.
+      Not required for compile.
+    - thumbsDir — output directory for later thumbnail generation.
+    - activeConfig — named config profile inside the SCAD library. Optional.
+    - bmlExtensions — extra filename suffixes treated as BML. Default .bml.
+
+    targets[] on the universal CLI defaults to ["blockdoc"] and must not be
+    required for this host. The host registers machineblocks-v3-scad itself.
+    Unknown toolchain target names are not an error here; they are ignored
+    because this command does not bootstrap them.
+
+    bom-cli.config.json renaming is not part of this package.
+
+  </documentation>
+  <references>
+    <see type="clidoc:TargetBootstrap" relation="ReadNext" />
+  </references>
+</clidoc:Configuration>

package/blocks/com/machineblocks/bml/cli/documentation/DualCliModel.bml

@@ -0,0 +1,48 @@
+<!--CLI Documentation — DualCliModel
+  FQN: com.machineblocks.bml.cli.documentation.DualCliModel-->
+<clidoc:DualCliModel xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Universal CLI versus the MachineBlocks host
+  </is>
+  <documentation>
+    Two commands, one compiler.
+
+    @blockml/cli (command: blockml), library org.blockml.bml.cli.*:
+    - Universal toolchain: validate, compile blockdoc or xsd or fatblock, search,
+      graph, inspect, transform, new, init.
+    - Domain-agnostic. No MachineBlocks paths, no machineblocks-v3-scad built-in.
+    - Reads blockml.config.json targets[] for toolchain targets.
+    - Scope exclusions in that library list machineblocks-v3-scad registration
+      as out of scope on purpose.
+
+    @machineblocks/cli (this package), library com.machineblocks.bml.cli.*:
+    - Thin host. Recommended entry for MachineBlocks users.
+    - Registers machineblocks-v3-scad by constructing the render target with a
+      BlockRenderEngine.
+    - Same validate and compile facade underneath. Defaults differ.
+    - Does not reimplement parse, validate, or emit.
+
+    Interop: a later plugin load (targetPackages in blockml.config.json mapping
+    machineblocks-v3-scad to @machineblocks/render-target) may let the universal
+    CLI see the target. Product UX stays on this host either way. The universal
+    CLI must keep working for projects that never install MachineBlocks.
+
+    Ownership:
+    - This package owns the host bin, MachineBlocks defaults, and target registration.
+    - @blockml/compiler owns compileToOutput, CompileRequest, and the registry API.
+    - @machineblocks/render-target owns processors and SCAD emit.
+    - @blockml/block-render-engine owns strategy infrastructure.
+    - Thumbnail generation (OpenSCAD plus image tooling) is a host concern when
+      it is built; it is not part of @blockml/cli V1.
+
+  </documentation>
+  <references>
+    <see type="clidoc:Responsibilities" relation="ReadNext" />
+  </references>
+</clidoc:DualCliModel>

package/blocks/com/machineblocks/bml/cli/documentation/Installation.bml

@@ -0,0 +1,44 @@
+<!--CLI Documentation — Installation
+  FQN: com.machineblocks.bml.cli.documentation.Installation-->
+<clidoc:Installation xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    How MachineBlocks users install the host
+  </is>
+  <documentation>
+    Consumer project (the usual path):
+
+        npm install @machineblocks/cli
+        npx machineblocks validate
+        npx machineblocks compile com.example.bml.bricks.MyBrick
+
+    That install brings @machineblocks/render-target, @blockml/block-render-engine,
+    @machineblocks/core, and the BlockML compiler packages. The user does not
+    install @blockml/cli unless they also want the universal command.
+
+    From this monorepo while the bin is not published:
+
+        npm install
+        npx blockml validate
+
+    The second command checks these BML libraries. It is the toolchain CLI used
+    to develop this repo, not the MachineBlocks user command.
+
+    Requires Node.js 20 or newer.
+
+    Domain users should not be sent to npm link of the blockml monorepo. The
+    universal installation note that says "install @machineblocks/cli from the
+    MachineBlocks mono-repo" now means this package (@machineblocks/cli in the
+    machineblocks-renderer repository). @machineblocks/core remains the separate
+    domain library.
+
+  </documentation>
+  <references>
+    <see type="clidoc:Introduction" relation="SeeAlso" />
+  </references>
+</clidoc:Installation>

package/blocks/com/machineblocks/bml/cli/documentation/Introduction.bml

@@ -0,0 +1,39 @@
+<!--CLI Documentation — Introduction
+  FQN: com.machineblocks.bml.cli.documentation.Introduction-->
+<clidoc:Introduction xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Purpose of the MachineBlocks host CLI
+  </is>
+  <documentation>
+    MachineBlocks users want BML turned into OpenSCAD that matches the V3 SCAD
+    library. They should not have to install the BlockML toolchain repository or
+    learn every compiler target.
+
+    This package is that simplified view:
+
+    - It depends on published @blockml/* packages (universal CLI and compiler).
+    - It depends on @machineblocks/render-target and therefore on
+      @blockml/block-render-engine and @machineblocks/core.
+    - It registers registry name machineblocks-v3-scad.
+    - It fills MachineBlocks defaults: where the SCAD library lives, where
+      OpenSCAD is, where .scad files are written.
+
+    The universal command remains blockml from @blockml/cli. That command must
+    not hardcode MachineBlocks. Product UX for this domain is this package.
+
+    Analogy: tsc is the language tool; a product CLI can wrap it. MachineBlocks
+    users install this CLI. They do not clone blockml.
+
+    V1 of this library is the contract. The bin follows these blocks.
+
+  </documentation>
+  <references>
+    <see type="clidoc:DualCliModel" relation="ReadNext" />
+  </references>
+</clidoc:Introduction>

package/blocks/com/machineblocks/bml/cli/documentation/Responsibilities.bml

@@ -0,0 +1,50 @@
+<!--CLI Documentation — Responsibilities
+  FQN: com.machineblocks.bml.cli.documentation.Responsibilities-->
+<clidoc:Responsibilities xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What the host does and what it leaves to other packages
+  </is>
+  <documentation>
+    This host does:
+
+    - Bootstrap a TypeRegistry from @blockml/core (org.blockml.bml.*) plus
+      @machineblocks/core (com.machineblocks.bml.*), using the same project
+      bootstrap the universal CLI uses.
+    - Register the render target before compile. The universal bootstrapTargets
+      path is not used for this name. validate does not need the target registry;
+      compile does.
+    - Pass mbLibPath so generated SCAD can import lib/block.scad and
+      config/mb_config.scad from the installed @machineblocks/core (or an
+      override path).
+    - Default the compile target to machineblocks-v3-scad. The command does not
+      take a target name.
+    - Resolve the type selector with the framework scan, keep blocks whose
+      baseType chain includes Block or Set, and pass the resolved mapping
+      (automatic, or sourcePackage plus targetPackage) on targetOptions.
+    - Compute every target FQN and output path before writing. One failure
+      writes nothing.
+    - Write .scad files, preset JSON, and source maps under the configured
+      srcDir. The published writer does not enforce that root; this host checks
+      the resolved real paths, then calls it with cleaning disabled.
+
+    This host does not:
+
+    - Parse or validate with its own code.
+    - Register blockdoc, xsd, or fatblock. Users who need those run blockml.
+    - Hardcode MBOM property lists. Those stay in NativeBlock.bml.
+    - Ship the SCAD library. That is @machineblocks/core lib/ and blocks/.
+
+    Node.js 20 or newer. The host bin is Node-only. The render target and the
+    engine remain browser-capable; only this package may use Node file APIs.
+
+  </documentation>
+  <references>
+    <see type="clidoc:Commands" relation="ReadNext" />
+  </references>
+</clidoc:Responsibilities>

package/blocks/com/machineblocks/bml/cli/documentation/TargetBootstrap.bml

@@ -0,0 +1,45 @@
+<!--CLI Documentation — TargetBootstrap
+  FQN: com.machineblocks.bml.cli.documentation.TargetBootstrap-->
+<clidoc:TargetBootstrap xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    How the host registers machineblocks-v3-scad
+  </is>
+  <documentation>
+    Before compile, the host performs the equivalent of:
+
+        import { registerTarget } from "@blockml/compiler";
+        import { BlockRenderEngine } from "@blockml/block-render-engine";
+        import { MachineBlocksRenderTarget } from "@machineblocks/render-target";
+
+        registerTarget(new MachineBlocksRenderTarget(new BlockRenderEngine()));
+
+    The target name property is the string machineblocks-v3-scad.
+    Registration is idempotent for the process.
+
+    The universal CLI's bootstrapTargets loads blockdoc, xsd, and fatblock only.
+    It throws on an unknown name in targets[]. This host must not add
+    machineblocks-v3-scad to that built-in list inside @blockml/cli. It calls
+    registerTarget directly (or registerTargetFactory from the host API).
+
+    validate and inspect do not register the target.
+
+    Browser callers and tests that use the render target without this CLI call
+    registerTarget themselves with the same constructor pair.
+
+    CompileOptions passed into the compiler set outputBasePath to the real path
+    of srcDir. targetOptions["machineblocks-v3-scad"] carries mbLibPath,
+    settingsFormat when set, and, for an explicit mapping, sourcePackage and
+    targetPackage. Automatic mapping omits those two keys. activeConfig is
+    unused by compile.
+
+  </documentation>
+  <references>
+    <see type="clidoc:Installation" relation="ReadNext" />
+  </references>
+</clidoc:TargetBootstrap>

package/dist/args.d.ts

@@ -0,0 +1,21 @@
+export interface ValidateArgs {
+    command: "validate";
+    file?: string;
+    all: boolean;
+}
+export interface CompileArgs {
+    command: "compile";
+    selector: string;
+    sourcePackage?: string;
+    targetPackage?: string;
+}
+export type HostCommand = {
+    command: "help";
+} | ValidateArgs | CompileArgs | {
+    command: "usage";
+    message: string;
+};
+export declare function parseArgs(argv: readonly string[]): HostCommand;
+/** A final .* or .** segment denotes a package. An exact type FQN does not. */
+export declare function sourcePackageFromSelector(selector: string): string | undefined;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB,YAAY,GACZ,WAAW,GACX;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAY9D;AAyED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9E"}

package/dist/args.js

@@ -0,0 +1,94 @@
+import { COMPILE_HELP } from "./help.js";
+export function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === "--help" || argv[0] === "help") {
+        return { command: "help" };
+    }
+    const [command, ...rest] = argv;
+    if (command === "validate") {
+        return parseValidate(rest);
+    }
+    if (command === "compile") {
+        return parseCompile(rest);
+    }
+    return { command: "usage", message: `Unknown command: ${command ?? ""}` };
+}
+function parseValidate(args) {
+    let file;
+    let all = false;
+    for (const arg of args) {
+        if (arg === "--help") {
+            return { command: "help" };
+        }
+        if (arg === "--all") {
+            all = true;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            return { command: "usage", message: `Unknown option: ${arg}` };
+        }
+        if (file !== undefined) {
+            return { command: "usage", message: "validate accepts one file." };
+        }
+        file = arg;
+    }
+    if (file !== undefined && all) {
+        return { command: "usage", message: "Specify either <file> or --all, not both." };
+    }
+    return file === undefined ? { command: "validate", all } : { command: "validate", all, file };
+}
+function parseCompile(args) {
+    if (args.includes("--help")) {
+        return { command: "help" };
+    }
+    let selector;
+    let sourcePackage;
+    let targetPackage;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined) {
+            continue;
+        }
+        if (arg === "--source-package" || arg === "--target-package") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { command: "usage", message: `${arg} requires a package FQN.` };
+            }
+            if (arg === "--source-package") {
+                sourcePackage = value;
+            }
+            else {
+                targetPackage = value;
+            }
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            return { command: "usage", message: `Unknown option: ${arg}` };
+        }
+        if (selector !== undefined) {
+            return { command: "usage", message: "compile accepts one source selector." };
+        }
+        selector = arg;
+    }
+    if (selector === undefined) {
+        return { command: "usage", message: `compile requires a source selector.\n\n${COMPILE_HELP}` };
+    }
+    const parsed = { command: "compile", selector };
+    if (sourcePackage !== undefined) {
+        parsed.sourcePackage = sourcePackage;
+    }
+    if (targetPackage !== undefined) {
+        parsed.targetPackage = targetPackage;
+    }
+    return parsed;
+}
+/** A final .* or .** segment denotes a package. An exact type FQN does not. */
+export function sourcePackageFromSelector(selector) {
+    const parts = selector.split(".");
+    const last = parts[parts.length - 1];
+    if ((last !== "*" && last !== "**") || parts.length < 2) {
+        return undefined;
+    }
+    return parts.slice(0, -1).join(".");
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { execute } from "./execute.js";
+const result = execute(process.argv.slice(2), process.cwd());
+const write = result.code === 0 ? console.log : console.error;
+for (const line of result.lines) {
+    write(line);
+}
+process.exit(result.code);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;AAC9D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC"}

package/dist/compile-command.d.ts

@@ -0,0 +1,7 @@
+import { type CompileArgs } from "./args.js";
+export interface HostResult {
+    code: number;
+    lines: string[];
+}
+export declare function runCompile(args: CompileArgs, rootDir: string): HostResult;
+//# sourceMappingURL=compile-command.d.ts.map

package/dist/compile-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-command.d.ts","sourceRoot":"","sources":["../src/compile-command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAKxE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CA8HzE"}

package/dist/compile-command.js

@@ -0,0 +1,213 @@
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { bootstrapProjectTypeRegistry, loadConfig, writeOutputFiles } from "@blockml/cli";
+import { compileToOutput, registerTarget } from "@blockml/compiler";
+import { scanTypes } from "@blockml/framework";
+import { BlockRenderEngine } from "@blockml/block-render-engine";
+import { MachineBlocksRenderTarget, SELECTOR_EMPTY, SOURCE_PACKAGE_ALONE, SOURCE_PACKAGE_REQUIRED, TARGET_COLLISION, artifactExtension, isRenderBlock, mapManifestation, pathForManifestation, } from "@machineblocks/render-target";
+import { sourcePackageFromSelector } from "./args.js";
+import { resolveOutputPath } from "./output-gate.js";
+const TARGET_NAME = "machineblocks-v3-scad";
+export function runCompile(args, rootDir) {
+    const mapping = resolveMapping(args);
+    if (!mapping.ok) {
+        return { code: 2, lines: [`${mapping.code}: ${mapping.message}`] };
+    }
+    let config;
+    try {
+        config = loadConfig(rootDir);
+    }
+    catch (error) {
+        return { code: 2, lines: [error instanceof Error ? error.message : String(error)] };
+    }
+    const srcDirName = config.srcDir ?? "blocks";
+    const srcDir = resolve(rootDir, srcDirName);
+    const libPath = resolveMbLibPath(rootDir, config);
+    if (!libPath) {
+        return { code: 2, lines: ["mbLibPath is not set and @machineblocks/core is not installed."] };
+    }
+    const bootstrap = bootstrapProjectTypeRegistry({ config, rootDir });
+    const bootstrapErrors = bootstrap.diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+    if (bootstrapErrors.length > 0) {
+        return { code: 1, lines: bootstrapErrors.map(formatDiagnostic) };
+    }
+    const scan = scanTypes([args.selector], bootstrap.registry);
+    if (!scan.ok) {
+        return { code: 2, lines: [scan.message] };
+    }
+    const selected = scan.hits.flatMap((fqn) => {
+        const document = bootstrap.registry.get(fqn);
+        if (!document || !isRenderBlock(document.block, bootstrap.registry)) {
+            return [];
+        }
+        return [document];
+    });
+    if (selected.length === 0) {
+        return {
+            code: 1,
+            lines: [`${SELECTOR_EMPTY}: No block matches selector ${args.selector}.`],
+        };
+    }
+    const planned = [];
+    const targetOwners = new Map();
+    const pathOwners = new Map();
+    for (const document of selected) {
+        const manifested = mapManifestation(document.block.type, mapping.mapping, "selected");
+        if (!manifested.ok) {
+            return { code: 1, lines: [`${manifested.code}: ${manifested.message}`] };
+        }
+        const outputPath = pathForManifestation(manifested.fqn, artifactExtension(document.block));
+        const targetClash = targetOwners.get(manifested.fqn);
+        if (targetClash !== undefined) {
+            return { code: 1, lines: [collision(TARGET_COLLISION, manifested.fqn, targetClash, document.block.type)] };
+        }
+        const pathClash = pathOwners.get(outputPath);
+        if (pathClash !== undefined) {
+            return { code: 1, lines: [collision(TARGET_COLLISION, outputPath, pathClash, document.block.type)] };
+        }
+        targetOwners.set(manifested.fqn, document.block.type);
+        pathOwners.set(outputPath, document.block.type);
+        const gated = resolveOutputPath(srcDir, outputPath);
+        if (!gated.ok) {
+            return { code: 1, lines: [`${gated.code}: ${gated.message}`] };
+        }
+        const filePath = document.source.filePath;
+        if (!filePath) {
+            return { code: 1, lines: [`${document.block.type} has no source file.`] };
+        }
+        planned.push({
+            sourceFqn: document.block.type,
+            targetFqn: manifested.fqn,
+            path: outputPath,
+            filePath,
+        });
+    }
+    registerTarget(new MachineBlocksRenderTarget(new BlockRenderEngine()));
+    const targetOptions = buildTargetOptions(config, libPath, mapping.mapping);
+    const emitted = [];
+    for (const item of planned) {
+        const source = readFileSync(item.filePath, "utf8");
+        const result = compileToOutput({
+            scope: { kind: "document", document: { source, filePath: item.filePath } },
+            targetOptions,
+        }, TARGET_NAME, {
+            typeRegistry: bootstrap.registry,
+            rootDir,
+            outputBasePath: srcDir,
+        });
+        const errors = result.diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+        if (!result.success || errors.length > 0 || !result.output || result.output.files.length === 0) {
+            const lines = errors.map(formatDiagnostic);
+            if (lines.length === 0) {
+                lines.push(`${item.sourceFqn} produced no output.`);
+            }
+            return { code: 1, lines };
+        }
+        emitted.push(...result.output.files);
+    }
+    const files = withSourceMaps(emitted);
+    const writtenPaths = new Set();
+    for (const file of files) {
+        if (writtenPaths.has(file.path)) {
+            return {
+                code: 1,
+                lines: [`${TARGET_COLLISION}: ${file.path} is claimed by more than one artifact.`],
+            };
+        }
+        writtenPaths.add(file.path);
+        const gated = resolveOutputPath(srcDir, file.path);
+        if (!gated.ok) {
+            return { code: 1, lines: [`${gated.code}: ${gated.message}`] };
+        }
+    }
+    writeOutputFiles({ files }, srcDir, rootDir, { cleanOutDir: false });
+    return { code: 0, lines: [`Wrote ${files.length} file(s) to ${srcDir}`] };
+}
+function resolveMapping(args) {
+    if (args.sourcePackage !== undefined && args.targetPackage === undefined) {
+        return {
+            ok: false,
+            code: SOURCE_PACKAGE_ALONE,
+            message: "--source-package requires --target-package.",
+        };
+    }
+    if (args.targetPackage !== undefined) {
+        const sourcePackage = args.sourcePackage ?? sourcePackageFromSelector(args.selector);
+        if (sourcePackage === undefined) {
+            return {
+                ok: false,
+                code: SOURCE_PACKAGE_REQUIRED,
+                message: [
+                    "--target-package needs a source package.",
+                    "",
+                    `The selector ${args.selector} is a single block, so the source root is not determined.`,
+                    "",
+                    "Specify --source-package.",
+                ].join("\n"),
+            };
+        }
+        return {
+            ok: true,
+            mapping: { kind: "explicit", sourcePackage, targetPackage: args.targetPackage },
+        };
+    }
+    return { ok: true, mapping: { kind: "automatic" } };
+}
+function buildTargetOptions(config, mbLibPath, mapping) {
+    const configured = config.targetOptions?.[TARGET_NAME];
+    const nested = {};
+    if (configured !== null && typeof configured === "object") {
+        for (const [key, value] of Object.entries(configured)) {
+            if (key !== "sourcePackage" && key !== "targetPackage" && key !== "mbLibPath") {
+                nested[key] = value;
+            }
+        }
+    }
+    nested.mbLibPath = mbLibPath;
+    if (mapping.kind === "explicit") {
+        nested.sourcePackage = mapping.sourcePackage;
+        nested.targetPackage = mapping.targetPackage;
+    }
+    return { [TARGET_NAME]: nested };
+}
+function resolveMbLibPath(rootDir, config) {
+    const configured = config.mbLibPath;
+    if (typeof configured === "string" && configured.length > 0) {
+        return resolve(rootDir, configured);
+    }
+    const nested = config.targetOptions?.[TARGET_NAME];
+    if (nested !== null && typeof nested === "object" && "mbLibPath" in nested) {
+        const fromTarget = nested.mbLibPath;
+        if (typeof fromTarget === "string" && fromTarget.length > 0) {
+            return resolve(rootDir, fromTarget);
+        }
+    }
+    try {
+        const require = createRequire(import.meta.url);
+        return dirname(require.resolve("@machineblocks/core/package.json"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function withSourceMaps(files) {
+    const out = [];
+    for (const file of files) {
+        out.push({ path: file.path, content: file.content });
+        const sourceMap = file.sourceMap;
+        if (typeof sourceMap === "string") {
+            out.push({ path: `${file.path}.map`, content: sourceMap });
+        }
+    }
+    return out;
+}
+function collision(code, target, firstSource, secondSource) {
+    return `${code}: ${target} is the target of both ${firstSource} and ${secondSource}.`;
+}
+function formatDiagnostic(diagnostic) {
+    const source = diagnostic.source;
+    const where = source?.file ? `${source.file}:${source.line}:${source.column} ` : "";
+    return `${where}${diagnostic.code}: ${diagnostic.message}`;
+}
+//# sourceMappingURL=compile-command.js.map

package/dist/compile-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-command.js","sourceRoot":"","sources":["../src/compile-command.ts"],"names":[],"mappings":"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"}

package/dist/execute.d.ts

@@ -0,0 +1,4 @@
+import { type HostResult } from "./compile-command.js";
+export type { HostResult } from "./compile-command.js";
+export declare function execute(argv: readonly string[], rootDir: string): HostResult;
+//# sourceMappingURL=execute.d.ts.map

package/dist/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAInE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAY5E"}

package/dist/execute.js

@@ -0,0 +1,18 @@
+import { parseArgs } from "./args.js";
+import { runCompile } from "./compile-command.js";
+import { HELP } from "./help.js";
+import { runValidate } from "./validate-command.js";
+export function execute(argv, rootDir) {
+    const parsed = parseArgs(argv);
+    if (parsed.command === "help") {
+        return { code: 0, lines: [HELP] };
+    }
+    if (parsed.command === "usage") {
+        return { code: 2, lines: [parsed.message, "", HELP] };
+    }
+    if (parsed.command === "validate") {
+        return runValidate(parsed, rootDir);
+    }
+    return runCompile(parsed, rootDir);
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,OAAe;IAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/help.d.ts

@@ -0,0 +1,3 @@
+export declare const HELP = "Usage: machineblocks validate [file] [--all]\n       machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n       machineblocks --help\n\nvalidate\n  Same project check as blockml validate. Does not write SCAD.\n\ncompile\n  Renders selected Block and Set types to SCAD with machineblocks-v3-scad.\n  The selector is a BlockML type selector: an exact FQN, pkg.*, or pkg.**.\n  Output is written under the configured srcDir (default blocks).\n  --target-package names a package root, not a directory.\n  A package selector supplies the source root when --source-package is omitted.\n  An exact block FQN does not.\n\nExit 0 success, 1 diagnostics, 2 usage or config.\nSearch, inspect, graph, and the other toolchain commands stay on blockml.\n";
+export declare const COMPILE_HELP = "Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n       machineblocks compile --help\n\n<source-selector>  Block FQN, or a package selector ending in .* or .**\n--source-package   Source package root for an explicit mapping\n--target-package   Target package root. Not a directory and not one output file.\n";
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,gxBAiBhB,CAAC;AAEF,eAAO,MAAM,YAAY,yWAMxB,CAAC"}

package/dist/help.js

@@ -0,0 +1,26 @@
+export const HELP = `Usage: machineblocks validate [file] [--all]
+       machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+       machineblocks --help
+
+validate
+  Same project check as blockml validate. Does not write SCAD.
+
+compile
+  Renders selected Block and Set types to SCAD with machineblocks-v3-scad.
+  The selector is a BlockML type selector: an exact FQN, pkg.*, or pkg.**.
+  Output is written under the configured srcDir (default blocks).
+  --target-package names a package root, not a directory.
+  A package selector supplies the source root when --source-package is omitted.
+  An exact block FQN does not.
+
+Exit 0 success, 1 diagnostics, 2 usage or config.
+Search, inspect, graph, and the other toolchain commands stay on blockml.
+`;
+export const COMPILE_HELP = `Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+       machineblocks compile --help
+
+<source-selector>  Block FQN, or a package selector ending in .* or .**
+--source-package   Source package root for an explicit mapping
+--target-package   Target package root. Not a directory and not one output file.
+`;
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;CAiBnB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;CAM3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { execute, type HostResult } from "./execute.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { execute } from "./execute.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAmB,MAAM,cAAc,CAAC"}

package/dist/output-gate.d.ts

@@ -0,0 +1,11 @@
+export interface OutputPath {
+    ok: true;
+    absolutePath: string;
+}
+export interface OutputPathFailure {
+    ok: false;
+    code: string;
+    message: string;
+}
+export declare function resolveOutputPath(srcDir: string, filePath: string): OutputPath | OutputPathFailure;
+//# sourceMappingURL=output-gate.d.ts.map

package/dist/output-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-gate.d.ts","sourceRoot":"","sources":["../src/output-gate.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,IAAI,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,iBAAiB,CAiClG"}

package/dist/output-gate.js

@@ -0,0 +1,76 @@
+import { existsSync, lstatSync, realpathSync } from "node:fs";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { OUTPUT_ESCAPES_SRC, OUTPUT_OVERWRITES_BML } from "@machineblocks/render-target";
+export function resolveOutputPath(srcDir, filePath) {
+    const srcReal = realpathSync(srcDir);
+    const portable = filePath.replaceAll("\\", "/");
+    if (portable.length === 0 || isAbsolute(filePath) || portable.split("/").includes("..")) {
+        return {
+            ok: false,
+            code: OUTPUT_ESCAPES_SRC,
+            message: `${filePath} is outside ${srcReal}.`,
+        };
+    }
+    const absolute = resolve(srcReal, portable);
+    if (!isInside(srcReal, absolute)) {
+        return {
+            ok: false,
+            code: OUTPUT_ESCAPES_SRC,
+            message: `${filePath} is outside ${srcReal}.`,
+        };
+    }
+    if (symlinkEscapes(srcReal, absolute)) {
+        return {
+            ok: false,
+            code: OUTPUT_ESCAPES_SRC,
+            message: `${filePath} resolves outside ${srcReal}.`,
+        };
+    }
+    if (overwritesBml(absolute)) {
+        return {
+            ok: false,
+            code: OUTPUT_OVERWRITES_BML,
+            message: `${filePath} would overwrite a .bml file.`,
+        };
+    }
+    return { ok: true, absolutePath: absolute };
+}
+function symlinkEscapes(srcReal, absolute) {
+    let existing = absolute;
+    while (!existsSync(existing)) {
+        const parent = dirname(existing);
+        if (parent === existing) {
+            return true;
+        }
+        existing = parent;
+    }
+    const realExisting = realpathSync(existing);
+    if (!isInside(srcReal, realExisting)) {
+        return true;
+    }
+    if (existsSync(absolute)) {
+        const stat = lstatSync(absolute);
+        if (stat.isSymbolicLink() && !isInside(srcReal, realpathSync(absolute))) {
+            return true;
+        }
+    }
+    return false;
+}
+function overwritesBml(absolute) {
+    if (!existsSync(absolute)) {
+        return false;
+    }
+    if (absolute.endsWith(".bml")) {
+        return true;
+    }
+    const stat = lstatSync(absolute);
+    if (!stat.isSymbolicLink()) {
+        return false;
+    }
+    return realpathSync(absolute).endsWith(".bml");
+}
+function isInside(root, candidate) {
+    const fromRoot = relative(root, candidate);
+    return fromRoot === "" || (!fromRoot.startsWith("..") && !isAbsolute(fromRoot));
+}
+//# sourceMappingURL=output-gate.js.map

package/dist/output-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-gate.js","sourceRoot":"","sources":["../src/output-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAazF,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB;IAChE,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxF,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,GAAG,QAAQ,eAAe,OAAO,GAAG;SAC9C,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,GAAG,QAAQ,eAAe,OAAO,GAAG;SAC9C,CAAC;IACJ,CAAC;IACD,IAAI,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,GAAG,QAAQ,qBAAqB,OAAO,GAAG;SACpD,CAAC;IACJ,CAAC;IACD,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,GAAG,QAAQ,+BAA+B;SACpD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,QAAgB;IACvD,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IACD,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACxE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAiB;IAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/validate-command.d.ts

@@ -0,0 +1,4 @@
+import type { ValidateArgs } from "./args.js";
+import type { HostResult } from "./compile-command.js";
+export declare function runValidate(args: ValidateArgs, rootDir: string): HostResult;
+//# sourceMappingURL=validate-command.d.ts.map

package/dist/validate-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.d.ts","sourceRoot":"","sources":["../src/validate-command.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CA8B3E"}

package/dist/validate-command.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { loadConfig } from "@blockml/cli";
+import { compileBmlToBom, validateRegistryDocuments } from "@blockml/compiler";
+import { bootstrapFullProjectRegistry, projectSourceRoots, registryFilesUnderRoots, rootFqnByFilePath, } from "@blockml/framework";
+export function runValidate(args, rootDir) {
+    let config;
+    try {
+        config = loadConfig(rootDir);
+    }
+    catch (error) {
+        return { code: 2, lines: [error instanceof Error ? error.message : String(error)] };
+    }
+    const srcDir = config.srcDir ?? "blocks";
+    const bootstrap = bootstrapFullProjectRegistry({
+        rootDir,
+        srcDir,
+        libraries: config.libraries ?? [],
+    });
+    if (args.file !== undefined) {
+        const filePath = resolve(rootDir, args.file);
+        if (!existsSync(filePath)) {
+            return { code: 2, lines: [`File not found: ${args.file}`] };
+        }
+        const parsed = compileBmlToBom({ source: readFileSync(filePath, "utf8"), filePath }, { typeRegistry: bootstrap.registry, rootDir });
+        return outcome([...bootstrap.diagnostics, ...parsed.diagnostics], 1);
+    }
+    const registryFiles = [...rootFqnByFilePath(bootstrap.registry).keys()];
+    const files = args.all
+        ? registryFiles
+        : registryFilesUnderRoots(bootstrap.registry, projectSourceRoots(rootDir, srcDir));
+    const validated = validateRegistryDocuments(bootstrap.registry, files);
+    return outcome([...bootstrap.diagnostics, ...validated.diagnostics], validated.blocksTested);
+}
+function outcome(diagnostics, blocksTested) {
+    const failed = diagnostics.some((diagnostic) => diagnostic.severity === "error");
+    const lines = diagnostics.map((diagnostic) => {
+        const source = diagnostic.source;
+        const where = source?.file ? `${source.file}:${source.line}:${source.column} ` : "";
+        return `${where}${diagnostic.code}: ${diagnostic.message}`;
+    });
+    lines.push(failed
+        ? `Validated ${blocksTested} block(s) with errors.`
+        : `Validated ${blocksTested} block(s).`);
+    return { code: failed ? 1 : 0, lines };
+}
+//# sourceMappingURL=validate-command.js.map

package/dist/validate-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.js","sourceRoot":"","sources":["../src/validate-command.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@machineblocks/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "MachineBlocks host CLI — simplified BlockML entry that renders BML to SCAD",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "machineblocks": "./dist/cli.js"
+  },
+  "sideEffects": false,
+  "blockml": {
+    "library": "./blocks/com/machineblocks/bml/cli/Library.bml"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "blocks"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run --root ../.. packages/machineblocks-cli/test"
+  },
+  "dependencies": {
+    "@blockml/block-render-engine": "^0.1.0",
+    "@blockml/cli": "^0.9.13",
+    "@blockml/compiler": "^0.9.13",
+    "@blockml/core": "^1.4.2",
+    "@blockml/framework": "^0.9.13",
+    "@machineblocks/core": "^3.0.0-A4",
+    "@machineblocks/render-target": "^0.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.