@capaxle/cli 0.1.0-alpha.1

package/dist/framework-cli.d.ts

@@ -0,0 +1,105 @@
+import { type FrameworkDevDependencies } from "./dev.js";
+import { type CompilationDiagnostic, type CompilationResult, type CompilationSuccess, type CompilerArtifactProducer, type CompilerOptions, type EmissionResult } from "@capaxle/compiler";
+import { type JsonValue } from "@capaxle/ir";
+export type FrameworkCommand = "check" | "build" | "list" | "describe" | "invoke" | "dev";
+export type CommandDiagnosticCode = "CAP_CLI_USAGE" | "CAP_CLI_COMMAND_UNKNOWN" | "CAP_CLI_CAPABILITY_NOT_FOUND" | "CAP_CLI_INTERNAL";
+export type CommandDiagnosticReason = "missing-command" | "unknown-command" | "unknown-option" | "duplicate-option" | "missing-option-value" | "option-not-allowed" | "missing-id" | "missing-input" | "extra-positional" | "invalid-option-value" | "invalid-id" | "capability-not-found" | "unexpected";
+type ParseDetails = {
+    readonly reason: "missing-command" | "missing-id" | "missing-input";
+} | {
+    readonly reason: "unknown-command" | "extra-positional" | "invalid-id";
+    readonly token: string;
+} | {
+    readonly reason: "unknown-option" | "duplicate-option" | "missing-option-value" | "option-not-allowed" | "invalid-option-value";
+    readonly option: string;
+};
+export interface CommandDiagnostic {
+    readonly code: CommandDiagnosticCode;
+    readonly severity: "error";
+    readonly phase: "command";
+    readonly subphase: "parse" | "lookup" | "internal";
+    readonly message: string;
+    readonly argumentIndex?: number;
+    readonly details: ParseDetails | {
+        readonly reason: "capability-not-found";
+        readonly id: string;
+    } | {
+        readonly reason: "unexpected";
+    };
+}
+export interface ParsedFrameworkCommand {
+    readonly command: FrameworkCommand;
+    readonly project?: string;
+    readonly output?: string;
+    readonly outputArgumentIndex?: number;
+    readonly format?: string;
+    readonly strict: boolean;
+    readonly json: boolean;
+    readonly id?: string;
+    readonly idArgumentIndex?: number;
+    /** JSON text supplied by the required invoke-only --input option. */
+    readonly input?: string;
+    readonly host?: string;
+    readonly port?: number;
+}
+export type ParseResult = {
+    readonly ok: true;
+    readonly value: ParsedFrameworkCommand;
+} | {
+    readonly ok: false;
+    readonly command: string | null;
+    readonly json: boolean;
+    readonly diagnostics: readonly CommandDiagnostic[];
+};
+export interface FrameworkCliDependencies {
+    readonly cwd: () => string;
+    readonly schemaProviders: CompilerOptions["schemaProviders"];
+    readonly artifactProducers?: readonly CompilerArtifactProducer[];
+    readonly openCliArtifactProducer?: CompilerArtifactProducer;
+    readonly sdkHttpArtifactProducer?: CompilerArtifactProducer;
+    readonly dev?: FrameworkDevDependencies;
+    readonly compileProject: (options: CompilerOptions) => Promise<CompilationResult>;
+    readonly emitCompilerArtifacts: (options: {
+        readonly projectRoot: string;
+        readonly compilation: CompilationSuccess;
+        readonly outputDirectory?: string;
+        readonly outputDiagnosticSource?: {
+            readonly kind: "command-option";
+            readonly command: "build";
+            readonly option: "--output";
+            readonly argumentIndex: number;
+        };
+    }) => Promise<EmissionResult>;
+}
+export interface FrameworkCliIo {
+    readonly stdout: {
+        write(value: string): unknown;
+    };
+    readonly stderr: {
+        write(value: string): unknown;
+    };
+}
+export declare function createInternalFacadeArtifactProducer(): CompilerArtifactProducer;
+export declare function createSdkHttpArtifactProducer(): CompilerArtifactProducer;
+export declare function createDocsSchemaArtifactProducer(options?: Readonly<{
+    profile?: "private" | "public";
+    sensitiveRequirementNames?: readonly string[];
+}>): CompilerArtifactProducer;
+type FrameworkEnvelope = Readonly<Record<string, JsonValue>>;
+export interface FrameworkCliResult {
+    readonly exitCode: 0 | 2 | 3 | 4 | 5 | 6 | 7 | 70 | 130;
+    readonly json: boolean;
+    readonly envelope: FrameworkEnvelope;
+    readonly stdout: string;
+    readonly diagnostics: readonly (CompilationDiagnostic | CommandDiagnostic)[];
+}
+export declare function parseFrameworkArguments(argv: readonly string[]): ParseResult;
+export declare function executeFrameworkCli(argv: readonly string[], dependencies: FrameworkCliDependencies, io?: FrameworkCliIo): Promise<FrameworkCliResult>;
+export declare function renderFrameworkResult(result: FrameworkCliResult): {
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export declare function runFrameworkCli(argv: readonly string[], dependencies: FrameworkCliDependencies, io: FrameworkCliIo): Promise<FrameworkCliResult["exitCode"]>;
+export declare const defaultFrameworkCliDependencies: FrameworkCliDependencies;
+export {};
+//# sourceMappingURL=framework-cli.d.ts.map

package/dist/framework-cli.d.ts.map

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