@machineblocks/cli 0.0.0-stage → 0.1.1

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.1
+  </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,106 @@
+<!--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 a MachineBlocks project
+  </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 init <package-fqn> [--src dir] [--install]
+    - Scaffolds a BlockML project by calling initProject from @blockml/cli,
+      then records the MachineBlocks profile. It does not spawn blockml init.
+    - --src changes the source directory (default blocks). --install runs
+      npm install after the profile is recorded. Without --install, init
+      does not install.
+    - The profile adds @machineblocks/cli to devDependencies when that package
+      is absent from dependencies and devDependencies. The range is the caret
+      range of this host. An existing dependencies entry stays put.
+    - The project Library.bml gains a dependencies composition child
+      com.machineblocks.bml.Library. An existing child is left in place.
+      Existing files are not replaced.
+    - A package FQN without a bml segment still exits 0 and warns. Compile
+      maps a bml segment to scad.
+    - Exit codes match initProject: 0 success, 1 write or install failure,
+      2 usage or an invalid package FQN.
+    - --help shows this command.
+
+    machineblocks --help
+    - Lists these commands.
+    - Points advanced users to blockml --help for search, inspect, graph,
+      transform, and new.
+
+    Not in this host surface (still available via blockml if that package
+    is installed): watch, search, inspect, graph, transform, new, 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,51 @@
+<!--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.
+    - init calls initProject from @blockml/cli, then adds devDependency
+      @machineblocks/cli and library dependency com.machineblocks.bml.Library.
+      The universal init stays domain-agnostic.
+
+    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,52 @@
+<!--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):
+
+        npx @machineblocks/cli init com.example.bml
+        npx machineblocks validate
+        npx machineblocks compile com.example.bml.bricks.MyBrick
+
+    init calls the universal project scaffold, then records @machineblocks/cli
+    as a devDependency and adds com.machineblocks.bml.Library to the project
+    library. Pass --install to run npm install after that profile is recorded.
+    Otherwise the next step is npm install. On a project that blockml init
+    already created, the same command adds only the missing profile and does
+    not replace existing files.
+
+    That install brings @machineblocks/render-target, @blockml/block-render-engine,
+    @machineblocks/core, and the BlockML compiler packages. init also records
+    @blockml/core and @blockml/cli. A bml segment in the package FQN lets
+    compile map the output package to scad.
+
+    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,28 @@
+export interface ValidateArgs {
+    command: "validate";
+    file?: string;
+    all: boolean;
+}
+export interface CompileArgs {
+    command: "compile";
+    selector: string;
+    sourcePackage?: string;
+    targetPackage?: string;
+}
+export interface InitArgs {
+    command: "init";
+    packageFqn: string;
+    srcDir?: string;
+    install: boolean;
+}
+export type HostCommand = {
+    command: "help";
+    topic?: "init";
+} | ValidateArgs | CompileArgs | InitArgs | {
+    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,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,YAAY,GACZ,WAAW,GACX,QAAQ,GACR;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAe9D;AAoHD,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9E"}

package/dist/args.js

@@ -0,0 +1,139 @@
+import { COMPILE_HELP, INIT_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);
+    }
+    if (command === "init") {
+        return parseInit(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;
+}
+function parseInit(args) {
+    if (args.includes("--help")) {
+        return { command: "help", topic: "init" };
+    }
+    let packageFqn;
+    let srcDir;
+    let install = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined) {
+            continue;
+        }
+        if (arg === "--install") {
+            install = true;
+            continue;
+        }
+        if (arg === "--src") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { command: "usage", message: "--src requires a directory." };
+            }
+            srcDir = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            return { command: "usage", message: `Unknown option: ${arg}` };
+        }
+        if (packageFqn !== undefined) {
+            return { command: "usage", message: "init accepts one package FQN." };
+        }
+        packageFqn = arg;
+    }
+    if (packageFqn === undefined) {
+        return { command: "usage", message: `init requires a package FQN.\n\n${INIT_HELP}` };
+    }
+    const parsed = { command: "init", packageFqn, install };
+    if (srcDir !== undefined) {
+        parsed.srcDir = srcDir;
+    }
+    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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"}