@lite-fsm/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 AlexanderGureev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin/lite-fsm.d.cts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/lite-fsm.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/lite-fsm.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { createProgram } from "../cli/create-program.js";
+import { createNodeFileSystem } from "../cli/node-fs.js";
+const context = {
+  cwd: process.cwd(),
+  stdout: process.stdout,
+  stderr: process.stderr,
+  env: process.env,
+  fs: createNodeFileSystem()
+};
+const result = await createProgram(context).parse(process.argv);
+process.exitCode = result.exitCode;

package/dist/cli/context.d.cts

@@ -0,0 +1,21 @@
+import type { Writable } from "node:stream";
+export type CliFileSystem = {
+    readFile(path: string): string;
+    readFileBuffer?(path: string): Uint8Array;
+    writeFile(path: string, contents: string): void;
+    mkdir(path: string, options: {
+        recursive: true;
+    }): void;
+    rename(from: string, to: string): void;
+    unlink(path: string): void;
+    fileExists(path: string): boolean;
+    directoryExists(path: string): boolean;
+    realpath?(path: string): string;
+};
+export type CliContext = {
+    cwd: string;
+    stdout: Writable;
+    stderr: Writable;
+    env: Readonly<Record<string, string | undefined>>;
+    fs: CliFileSystem;
+};

package/dist/cli/context.d.ts

@@ -0,0 +1,21 @@
+import type { Writable } from "node:stream";
+export type CliFileSystem = {
+    readFile(path: string): string;
+    readFileBuffer?(path: string): Uint8Array;
+    writeFile(path: string, contents: string): void;
+    mkdir(path: string, options: {
+        recursive: true;
+    }): void;
+    rename(from: string, to: string): void;
+    unlink(path: string): void;
+    fileExists(path: string): boolean;
+    directoryExists(path: string): boolean;
+    realpath?(path: string): string;
+};
+export type CliContext = {
+    cwd: string;
+    stdout: Writable;
+    stderr: Writable;
+    env: Readonly<Record<string, string | undefined>>;
+    fs: CliFileSystem;
+};

package/dist/cli/create-program.d.cts

@@ -0,0 +1,6 @@
+import type { CliContext } from "./context.js";
+import type { CommandResult } from "./result.js";
+export type CliProgram = {
+    parse(argv: readonly string[]): Promise<CommandResult>;
+};
+export declare const createProgram: (context: CliContext) => CliProgram;

package/dist/cli/create-program.d.ts

@@ -0,0 +1,6 @@
+import type { CliContext } from "./context.js";
+import type { CommandResult } from "./result.js";
+export type CliProgram = {
+    parse(argv: readonly string[]): Promise<CommandResult>;
+};
+export declare const createProgram: (context: CliContext) => CliProgram;

package/dist/cli/create-program.js

@@ -0,0 +1,48 @@
+import { Command, CommanderError } from "commander";
+import { cliDiagnostic } from "./diagnostics.js";
+import { createCommandResult } from "./result.js";
+import { registerExportGraphCommand } from "../export-graph/command.js";
+import { formatDiagnostics } from "../output/format-diagnostics.js";
+import { registerVisualizeCommand } from "../visualize/command.js";
+const invalidOptionsResult = (context, message) => {
+  const diagnostic = cliDiagnostic("LFC_INVALID_OPTIONS", "error", message);
+  context.stderr.write(formatDiagnostics([diagnostic]));
+  return createCommandResult([diagnostic]);
+};
+const isHelpDisplayed = (error) => {
+  return error instanceof CommanderError && error.code === "commander.helpDisplayed";
+};
+const isCommanderError = (error) => {
+  return error instanceof CommanderError;
+};
+const createProgram = (context) => {
+  let commandResult = { exitCode: 0, diagnostics: [] };
+  const program = new Command();
+  program.name("lite-fsm").description("lite-fsm command line tools").exitOverride().configureOutput({
+    writeOut: (value) => context.stdout.write(value),
+    /* v8 ignore next -- commander calls this only for its own formatted stderr, which CLI suppresses in favor of CliDiagnostic output. */
+    writeErr: () => void 0,
+    outputError: () => void 0
+  });
+  registerExportGraphCommand(program, context, (result) => {
+    commandResult = result;
+  });
+  registerVisualizeCommand(program, context, (result) => {
+    commandResult = result;
+  });
+  return {
+    async parse(argv) {
+      commandResult = { exitCode: 0, diagnostics: [] };
+      try {
+        await program.parseAsync([...argv], { from: "node" });
+      } catch (error) {
+        if (isHelpDisplayed(error)) return { exitCode: 0, diagnostics: [] };
+        return invalidOptionsResult(context, isCommanderError(error) ? error.message : String(error));
+      }
+      return commandResult;
+    }
+  };
+};
+export {
+  createProgram
+};

package/dist/cli/diagnostics.d.cts

@@ -0,0 +1,15 @@
+export type CliDiagnosticSeverity = "info" | "warning" | "error";
+export type CliDiagnosticCode = "LFC_INVALID_OPTIONS" | "LFC_TSCONFIG_NOT_FOUND" | "LFC_TSCONFIG_INVALID" | "LFC_GRAPH_PROJECT_FAILED" | "LFC_NO_MACHINES_EXPORTED" | "LFC_SOURCE_BUNDLE_FILE_UNREADABLE" | "LFC_VISUALIZER_STATIC_MISSING" | "LFC_VISUALIZER_PORT_UNAVAILABLE" | "LFC_VISUALIZER_SERVER_FAILED" | "LFC_VISUALIZER_OPEN_FAILED" | "LFC_WRITE_FAILED";
+export type CliDiagnostic = {
+    code: CliDiagnosticCode;
+    severity: CliDiagnosticSeverity;
+    message: string;
+    file?: string;
+    loc?: {
+        line: number;
+        column: number;
+    };
+    hint?: string;
+};
+export declare const cliDiagnostic: (code: CliDiagnosticCode, severity: CliDiagnosticSeverity, message: string, details?: Omit<CliDiagnostic, "code" | "severity" | "message">) => CliDiagnostic;
+export declare const hasBlockingCliDiagnostics: (diagnostics: readonly CliDiagnostic[]) => boolean;

package/dist/cli/diagnostics.d.ts

@@ -0,0 +1,15 @@
+export type CliDiagnosticSeverity = "info" | "warning" | "error";
+export type CliDiagnosticCode = "LFC_INVALID_OPTIONS" | "LFC_TSCONFIG_NOT_FOUND" | "LFC_TSCONFIG_INVALID" | "LFC_GRAPH_PROJECT_FAILED" | "LFC_NO_MACHINES_EXPORTED" | "LFC_SOURCE_BUNDLE_FILE_UNREADABLE" | "LFC_VISUALIZER_STATIC_MISSING" | "LFC_VISUALIZER_PORT_UNAVAILABLE" | "LFC_VISUALIZER_SERVER_FAILED" | "LFC_VISUALIZER_OPEN_FAILED" | "LFC_WRITE_FAILED";
+export type CliDiagnostic = {
+    code: CliDiagnosticCode;
+    severity: CliDiagnosticSeverity;
+    message: string;
+    file?: string;
+    loc?: {
+        line: number;
+        column: number;
+    };
+    hint?: string;
+};
+export declare const cliDiagnostic: (code: CliDiagnosticCode, severity: CliDiagnosticSeverity, message: string, details?: Omit<CliDiagnostic, "code" | "severity" | "message">) => CliDiagnostic;
+export declare const hasBlockingCliDiagnostics: (diagnostics: readonly CliDiagnostic[]) => boolean;

package/dist/cli/diagnostics.js

@@ -0,0 +1,13 @@
+const cliDiagnostic = (code, severity, message, details = {}) => ({
+  code,
+  severity,
+  message,
+  ...details
+});
+const hasBlockingCliDiagnostics = (diagnostics) => {
+  return diagnostics.some((diagnostic) => diagnostic.severity === "error");
+};
+export {
+  cliDiagnostic,
+  hasBlockingCliDiagnostics
+};

package/dist/cli/node-fs.d.cts

@@ -0,0 +1,2 @@
+import type { CliFileSystem } from "./context.js";
+export declare const createNodeFileSystem: () => CliFileSystem;

package/dist/cli/node-fs.d.ts

@@ -0,0 +1,2 @@
+import type { CliFileSystem } from "./context.js";
+export declare const createNodeFileSystem: () => CliFileSystem;

package/dist/cli/node-fs.js

@@ -0,0 +1,33 @@
+import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+const createNodeFileSystem = () => ({
+  readFile(path) {
+    return readFileSync(path, "utf8");
+  },
+  readFileBuffer(path) {
+    return readFileSync(path);
+  },
+  writeFile(path, contents) {
+    writeFileSync(path, contents, "utf8");
+  },
+  mkdir(path, options) {
+    mkdirSync(path, options);
+  },
+  rename(from, to) {
+    renameSync(from, to);
+  },
+  unlink(path) {
+    unlinkSync(path);
+  },
+  fileExists(path) {
+    return existsSync(path) && statSync(path).isFile();
+  },
+  directoryExists(path) {
+    return existsSync(path) && statSync(path).isDirectory();
+  },
+  realpath(path) {
+    return realpathSync(path);
+  }
+});
+export {
+  createNodeFileSystem
+};

package/dist/cli/result.d.cts

@@ -0,0 +1,6 @@
+import type { CliDiagnostic } from "./diagnostics.js";
+export type CommandResult = {
+    exitCode: 0 | 1;
+    diagnostics: CliDiagnostic[];
+};
+export declare const createCommandResult: (diagnostics: readonly CliDiagnostic[]) => CommandResult;

package/dist/cli/result.d.ts

@@ -0,0 +1,6 @@
+import type { CliDiagnostic } from "./diagnostics.js";
+export type CommandResult = {
+    exitCode: 0 | 1;
+    diagnostics: CliDiagnostic[];
+};
+export declare const createCommandResult: (diagnostics: readonly CliDiagnostic[]) => CommandResult;

package/dist/cli/result.js

@@ -0,0 +1,8 @@
+import { hasBlockingCliDiagnostics } from "./diagnostics.js";
+const createCommandResult = (diagnostics) => ({
+  exitCode: hasBlockingCliDiagnostics(diagnostics) ? 1 : 0,
+  diagnostics: [...diagnostics]
+});
+export {
+  createCommandResult
+};

package/dist/export-graph/command.d.cts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import type { CliContext } from "../cli/context.js";
+import type { CommandResult } from "../cli/result.js";
+import { type RawExportGraphOptions } from "./options.js";
+type SetCommandResult = (result: CommandResult) => void;
+export declare const runExportGraphCommand: (context: CliContext, rawOptions: RawExportGraphOptions) => Promise<CommandResult>;
+export declare const registerExportGraphCommand: (program: Command, context: CliContext, setResult: SetCommandResult) => void;
+export {};

package/dist/export-graph/command.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import type { CliContext } from "../cli/context.js";
+import type { CommandResult } from "../cli/result.js";
+import { type RawExportGraphOptions } from "./options.js";
+type SetCommandResult = (result: CommandResult) => void;
+export declare const runExportGraphCommand: (context: CliContext, rawOptions: RawExportGraphOptions) => Promise<CommandResult>;
+export declare const registerExportGraphCommand: (program: Command, context: CliContext, setResult: SetCommandResult) => void;
+export {};

package/dist/export-graph/command.js

@@ -0,0 +1,30 @@
+import { createCommandResult } from "../cli/result.js";
+import { formatDiagnostics } from "../output/format-diagnostics.js";
+import { normalizeExportGraphOptions } from "./options.js";
+const writeDiagnostics = (context, diagnostics) => {
+  const formatted = formatDiagnostics(diagnostics);
+  if (formatted) context.stderr.write(formatted);
+};
+const runExportGraphCommand = async (context, rawOptions) => {
+  const normalized = normalizeExportGraphOptions(rawOptions);
+  if (!normalized.ok) {
+    writeDiagnostics(context, normalized.diagnostics);
+    return createCommandResult(normalized.diagnostics);
+  }
+  const { runExportGraph } = await import("./run-export-graph.js");
+  const result = runExportGraph(context, normalized.options);
+  writeDiagnostics(context, [...result.diagnostics, ...result.graphDiagnostics]);
+  return {
+    exitCode: result.exitCode,
+    diagnostics: result.diagnostics
+  };
+};
+const registerExportGraphCommand = (program, context, setResult) => {
+  program.command("export-graph").description("Export a lite-fsm project graph document as JSON").option("--entry <path>", "entrypoint TypeScript file").option("--out <path>", "output JSON file").option("--tsconfig <path>", "explicit tsconfig for TypeScript module resolution").option("--include-source", "embed project source text in JSON export").action(async (options) => {
+    setResult(await runExportGraphCommand(context, options));
+  });
+};
+export {
+  registerExportGraphCommand,
+  runExportGraphCommand
+};

package/dist/export-graph/export-document.d.cts

@@ -0,0 +1,38 @@
+import type { LiteFsmGraphDocument, LiteFsmGraphProjectFile, LiteFsmGraphProjectResult } from "@lite-fsm/graph";
+import type { CliDiagnostic } from "../cli/diagnostics.js";
+export declare const PROJECT_GRAPH_EXPORT_VERSION = "lite-fsm.project-graph-export/v1";
+export declare const CLI_PACKAGE_NAME = "@lite-fsm/cli";
+export declare const CLI_PACKAGE_VERSION = "0.1.0";
+export type LiteFsmProjectGraphExportDocument = {
+    version: typeof PROJECT_GRAPH_EXPORT_VERSION;
+    createdBy: {
+        package: typeof CLI_PACKAGE_NAME;
+        version: string;
+    };
+    entry: {
+        path: string;
+        tsconfigPath?: string;
+    };
+    graph: LiteFsmGraphDocument;
+    files: readonly LiteFsmGraphProjectFile[];
+    diagnostics: readonly CliDiagnostic[];
+    sources?: LiteFsmProjectGraphSourceBundle;
+};
+export type LiteFsmProjectGraphSourceFile = {
+    fileName: string;
+    language: "ts";
+    hash: string;
+    text: string;
+};
+export type LiteFsmProjectGraphSourceBundle = {
+    files: readonly LiteFsmProjectGraphSourceFile[];
+};
+export type CreateProjectGraphExportDocumentOptions = {
+    entryPath: string;
+    tsconfigPath?: string;
+    graphResult: LiteFsmGraphProjectResult;
+    diagnostics: readonly CliDiagnostic[];
+    sources?: LiteFsmProjectGraphSourceBundle;
+};
+export declare const createProjectGraphExportDocument: ({ entryPath, tsconfigPath, graphResult, diagnostics, sources, }: CreateProjectGraphExportDocumentOptions) => LiteFsmProjectGraphExportDocument;
+export declare const stringifyProjectGraphExportDocument: (document: LiteFsmProjectGraphExportDocument) => string;

package/dist/export-graph/export-document.d.ts

@@ -0,0 +1,38 @@
+import type { LiteFsmGraphDocument, LiteFsmGraphProjectFile, LiteFsmGraphProjectResult } from "@lite-fsm/graph";
+import type { CliDiagnostic } from "../cli/diagnostics.js";
+export declare const PROJECT_GRAPH_EXPORT_VERSION = "lite-fsm.project-graph-export/v1";
+export declare const CLI_PACKAGE_NAME = "@lite-fsm/cli";
+export declare const CLI_PACKAGE_VERSION = "0.1.0";
+export type LiteFsmProjectGraphExportDocument = {
+    version: typeof PROJECT_GRAPH_EXPORT_VERSION;
+    createdBy: {
+        package: typeof CLI_PACKAGE_NAME;
+        version: string;
+    };
+    entry: {
+        path: string;
+        tsconfigPath?: string;
+    };
+    graph: LiteFsmGraphDocument;
+    files: readonly LiteFsmGraphProjectFile[];
+    diagnostics: readonly CliDiagnostic[];
+    sources?: LiteFsmProjectGraphSourceBundle;
+};
+export type LiteFsmProjectGraphSourceFile = {
+    fileName: string;
+    language: "ts";
+    hash: string;
+    text: string;
+};
+export type LiteFsmProjectGraphSourceBundle = {
+    files: readonly LiteFsmProjectGraphSourceFile[];
+};
+export type CreateProjectGraphExportDocumentOptions = {
+    entryPath: string;
+    tsconfigPath?: string;
+    graphResult: LiteFsmGraphProjectResult;
+    diagnostics: readonly CliDiagnostic[];
+    sources?: LiteFsmProjectGraphSourceBundle;
+};
+export declare const createProjectGraphExportDocument: ({ entryPath, tsconfigPath, graphResult, diagnostics, sources, }: CreateProjectGraphExportDocumentOptions) => LiteFsmProjectGraphExportDocument;
+export declare const stringifyProjectGraphExportDocument: (document: LiteFsmProjectGraphExportDocument) => string;

package/dist/export-graph/export-document.js

@@ -0,0 +1,35 @@
+import { stringifyStableJson } from "../output/stable-json.js";
+const PROJECT_GRAPH_EXPORT_VERSION = "lite-fsm.project-graph-export/v1";
+const CLI_PACKAGE_NAME = "@lite-fsm/cli";
+const CLI_PACKAGE_VERSION = "0.1.0";
+const createProjectGraphExportDocument = ({
+  entryPath,
+  tsconfigPath,
+  graphResult,
+  diagnostics,
+  sources
+}) => ({
+  version: PROJECT_GRAPH_EXPORT_VERSION,
+  createdBy: {
+    package: CLI_PACKAGE_NAME,
+    version: CLI_PACKAGE_VERSION
+  },
+  entry: {
+    path: entryPath,
+    ...tsconfigPath ? { tsconfigPath } : {}
+  },
+  graph: graphResult.document,
+  files: graphResult.files,
+  diagnostics,
+  ...sources ? { sources } : {}
+});
+const stringifyProjectGraphExportDocument = (document) => {
+  return stringifyStableJson(document);
+};
+export {
+  CLI_PACKAGE_NAME,
+  CLI_PACKAGE_VERSION,
+  PROJECT_GRAPH_EXPORT_VERSION,
+  createProjectGraphExportDocument,
+  stringifyProjectGraphExportDocument
+};

package/dist/export-graph/options.d.cts

@@ -0,0 +1,21 @@
+import type { CliDiagnostic } from "../cli/diagnostics.js";
+export type ExportGraphOptions = {
+    entry: string;
+    out: string;
+    tsconfig?: string;
+    includeSource: boolean;
+};
+export type RawExportGraphOptions = {
+    entry?: unknown;
+    out?: unknown;
+    tsconfig?: unknown;
+    includeSource?: unknown;
+};
+export type NormalizeExportGraphOptionsResult = {
+    ok: true;
+    options: ExportGraphOptions;
+} | {
+    ok: false;
+    diagnostics: CliDiagnostic[];
+};
+export declare const normalizeExportGraphOptions: (rawOptions: RawExportGraphOptions) => NormalizeExportGraphOptionsResult;

package/dist/export-graph/options.d.ts

@@ -0,0 +1,21 @@
+import type { CliDiagnostic } from "../cli/diagnostics.js";
+export type ExportGraphOptions = {
+    entry: string;
+    out: string;
+    tsconfig?: string;
+    includeSource: boolean;
+};
+export type RawExportGraphOptions = {
+    entry?: unknown;
+    out?: unknown;
+    tsconfig?: unknown;
+    includeSource?: unknown;
+};
+export type NormalizeExportGraphOptionsResult = {
+    ok: true;
+    options: ExportGraphOptions;
+} | {
+    ok: false;
+    diagnostics: CliDiagnostic[];
+};
+export declare const normalizeExportGraphOptions: (rawOptions: RawExportGraphOptions) => NormalizeExportGraphOptionsResult;

package/dist/export-graph/options.js

@@ -0,0 +1,40 @@
+import { cliDiagnostic } from "../cli/diagnostics.js";
+const stringOption = (value) => {
+  return typeof value === "string" && value.trim() !== "" ? value : void 0;
+};
+const normalizeExportGraphOptions = (rawOptions) => {
+  const entry = stringOption(rawOptions.entry);
+  const out = stringOption(rawOptions.out);
+  const tsconfig = stringOption(rawOptions.tsconfig);
+  const includeSource = rawOptions.includeSource === true;
+  const diagnostics = [];
+  if (!entry) {
+    diagnostics.push(
+      cliDiagnostic("LFC_INVALID_OPTIONS", "error", "Option --entry is required.", {
+        hint: "Pass --entry path/to/store/index.ts."
+      })
+    );
+  }
+  if (!out) {
+    diagnostics.push(
+      cliDiagnostic("LFC_INVALID_OPTIONS", "error", "Option --out is required.", {
+        hint: "Pass --out lite-fsm.graph.json."
+      })
+    );
+  } else if (out === "-") {
+    diagnostics.push(cliDiagnostic("LFC_INVALID_OPTIONS", "error", "JSON stdout output is not supported. Pass a file path to --out."));
+  }
+  if (diagnostics.length > 0) return { ok: false, diagnostics };
+  return {
+    ok: true,
+    options: {
+      entry,
+      out,
+      includeSource,
+      ...tsconfig ? { tsconfig } : {}
+    }
+  };
+};
+export {
+  normalizeExportGraphOptions
+};

package/dist/export-graph/run-export-graph.d.cts

@@ -0,0 +1,10 @@
+import type { GraphDiagnostic } from "@lite-fsm/graph";
+import type { CliContext } from "../cli/context.js";
+import type { CommandResult } from "../cli/result.js";
+import { type ProjectGraphBuildResult } from "../project/build-project-graph.js";
+import type { ExportGraphOptions } from "./options.js";
+export type ExportGraphRunResult = CommandResult & {
+    graphDiagnostics: GraphDiagnostic[];
+};
+export declare const createExportGraphRunResult: (context: CliContext, options: ExportGraphOptions, buildResult: ProjectGraphBuildResult) => ExportGraphRunResult;
+export declare const runExportGraph: (context: CliContext, options: ExportGraphOptions) => ExportGraphRunResult;

package/dist/export-graph/run-export-graph.d.ts

@@ -0,0 +1,10 @@
+import type { GraphDiagnostic } from "@lite-fsm/graph";
+import type { CliContext } from "../cli/context.js";
+import type { CommandResult } from "../cli/result.js";
+import { type ProjectGraphBuildResult } from "../project/build-project-graph.js";
+import type { ExportGraphOptions } from "./options.js";
+export type ExportGraphRunResult = CommandResult & {
+    graphDiagnostics: GraphDiagnostic[];
+};
+export declare const createExportGraphRunResult: (context: CliContext, options: ExportGraphOptions, buildResult: ProjectGraphBuildResult) => ExportGraphRunResult;
+export declare const runExportGraph: (context: CliContext, options: ExportGraphOptions) => ExportGraphRunResult;

package/dist/export-graph/run-export-graph.js

@@ -0,0 +1,53 @@
+import { cliDiagnostic, hasBlockingCliDiagnostics } from "../cli/diagnostics.js";
+import { buildProjectGraph } from "../project/build-project-graph.js";
+import { createProjectGraphExportDocument, stringifyProjectGraphExportDocument } from "./export-document.js";
+import { createProjectGraphSourceBundle } from "./source-bundle.js";
+import { writeOutput } from "./write-output.js";
+const graphHasBlockingDiagnostics = (diagnostics) => {
+  return diagnostics.some((diagnostic) => diagnostic.severity === "error");
+};
+const hasExportedMachines = (graphResult) => {
+  return graphResult.document.managers.some((manager) => manager.machineRefs.length > 0);
+};
+const result = (diagnostics, graphDiagnostics = []) => ({
+  exitCode: hasBlockingCliDiagnostics(diagnostics) ? 1 : 0,
+  diagnostics: [...diagnostics],
+  graphDiagnostics: [...graphDiagnostics]
+});
+const createExportGraphRunResult = (context, options, buildResult) => {
+  const graphDiagnostics = buildResult.graphResult?.diagnostics ?? [];
+  const diagnostics = [...buildResult.diagnostics];
+  if (buildResult.blocking) return result(diagnostics, graphDiagnostics);
+  if (!buildResult.graphResult) {
+    diagnostics.push(cliDiagnostic("LFC_GRAPH_PROJECT_FAILED", "error", "Project graph build did not return a graph result."));
+    return result(diagnostics, graphDiagnostics);
+  }
+  if (graphHasBlockingDiagnostics(graphDiagnostics)) {
+    diagnostics.push(cliDiagnostic("LFC_GRAPH_PROJECT_FAILED", "error", "Project graph compile finished with blocking diagnostics."));
+    return result(diagnostics, graphDiagnostics);
+  }
+  if (!hasExportedMachines(buildResult.graphResult)) {
+    diagnostics.push(cliDiagnostic("LFC_NO_MACHINES_EXPORTED", "error", "Project graph export has no manager machine refs."));
+    return result(diagnostics, graphDiagnostics);
+  }
+  const sources = options.includeSource ? createProjectGraphSourceBundle(context, buildResult.project.projectRoot, buildResult.graphResult.files) : void 0;
+  if (sources && !sources.ok) return result([...diagnostics, ...sources.diagnostics], graphDiagnostics);
+  const document = createProjectGraphExportDocument({
+    entryPath: buildResult.project.entryPath,
+    tsconfigPath: buildResult.project.tsconfigPath,
+    graphResult: buildResult.graphResult,
+    diagnostics,
+    ...sources ? { sources: sources.sources } : {}
+  });
+  const written = writeOutput(context, options.out, stringifyProjectGraphExportDocument(document));
+  if (!written.ok) return result([...diagnostics, ...written.diagnostics], graphDiagnostics);
+  return result(diagnostics, graphDiagnostics);
+};
+const runExportGraph = (context, options) => {
+  const buildResult = buildProjectGraph(context, { entry: options.entry, tsconfig: options.tsconfig });
+  return createExportGraphRunResult(context, options, buildResult);
+};
+export {
+  createExportGraphRunResult,
+  runExportGraph
+};

package/dist/export-graph/source-bundle.d.cts

@@ -0,0 +1,12 @@
+import type { LiteFsmGraphProjectFile } from "@lite-fsm/graph";
+import type { CliContext } from "../cli/context.js";
+import type { CliDiagnostic } from "../cli/diagnostics.js";
+import type { LiteFsmProjectGraphSourceBundle } from "./export-document.js";
+export type CreateProjectGraphSourceBundleResult = {
+    ok: true;
+    sources: LiteFsmProjectGraphSourceBundle;
+} | {
+    ok: false;
+    diagnostics: CliDiagnostic[];
+};
+export declare const createProjectGraphSourceBundle: (context: CliContext, projectRoot: string, files: readonly LiteFsmGraphProjectFile[]) => CreateProjectGraphSourceBundleResult;

package/dist/export-graph/source-bundle.d.ts

@@ -0,0 +1,12 @@
+import type { LiteFsmGraphProjectFile } from "@lite-fsm/graph";
+import type { CliContext } from "../cli/context.js";
+import type { CliDiagnostic } from "../cli/diagnostics.js";
+import type { LiteFsmProjectGraphSourceBundle } from "./export-document.js";
+export type CreateProjectGraphSourceBundleResult = {
+    ok: true;
+    sources: LiteFsmProjectGraphSourceBundle;
+} | {
+    ok: false;
+    diagnostics: CliDiagnostic[];
+};
+export declare const createProjectGraphSourceBundle: (context: CliContext, projectRoot: string, files: readonly LiteFsmGraphProjectFile[]) => CreateProjectGraphSourceBundleResult;