@flow-as-code/cli 0.1.0

package/dist/render.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// `flow-cli render <dir-or-file> --resources <map.json>`: standalone
+// materialization. FlowDoc in, deployable Flow language JSON out, with every
+// `${cdref:...}` token replaced from the resource map.
+//
+// This is the one path where literal ARNs are the goal rather than a mistake
+// (packages/core/SPEC.md, Materialization), so the map's values are not
+// linted. What is enforced is completeness: @flow-as-code/core's MaterializeError
+// carries every unmapped token, and all of them are printed, for every
+// document, before the command exits 1. One run, one round of map edits.
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { MaterializeError, materializeWithMap, serializeContent } from "@flow-as-code/core";
+import { defaultOutDir, loadDocs, readStringMap } from "./docs.js";
+import { CliError } from "./errors.js";
+export function runRender(target, options) {
+    const docs = loadDocs(target);
+    const resourceMap = readStringMap(options.resources, "resource map");
+    const outDir = resolve(options.out ?? defaultOutDir(target));
+    const problems = [];
+    const rendered = [];
+    for (const { path, doc } of docs) {
+        try {
+            rendered.push({
+                path: join(outDir, `${doc.name}.json`),
+                text: serializeContent(materializeWithMap(doc, resourceMap)),
+            });
+        }
+        catch (error) {
+            if (!(error instanceof MaterializeError))
+                throw error;
+            problems.push(`${path}: ${String(error.missingTokens.length)} unmapped token(s):`);
+            for (const token of error.missingTokens)
+                problems.push(`    ${token}`);
+        }
+    }
+    if (problems.length > 0) {
+        throw new CliError(`Cannot render:\n  ${problems.join("\n  ")}\n` +
+            `Add the missing key(s) to ${resolve(options.resources)}.`);
+    }
+    mkdirSync(outDir, { recursive: true });
+    for (const { path, text } of rendered)
+        writeFileSync(path, text, "utf8");
+    return rendered.map((r) => r.path);
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qEAAqE;AACrE,6EAA6E;AAC7E,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,kFAAkF;AAClF,uEAAuE;AACvE,yEAAyE;AAEzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOvC,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,OAAsB;IAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAqC,EAAE,CAAC;IACtD,KAAK,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC;gBACtC,IAAI,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;aAC7D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,gBAAgB,CAAC;gBAAE,MAAM,KAAK,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACnF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,aAAa;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAChB,qBAAqB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;YAC5C,6BAA6B,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC7D,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,QAAQ;QAAE,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACzE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,13 @@
+import type { CommanderError } from "commander";
+/** Wraps a command body so it reports failures as a message plus an exit code. */
+export declare function action<A extends unknown[]>(body: (...args: A) => void | Promise<void>): (...args: A) => Promise<void>;
+/**
+ * For a command's `exitOverride`: commander's own usage errors (a required
+ * option not given, an unknown option, a missing argument) exit with `code`
+ * instead of its default 1, so a command that reserves 1 for a result can
+ * keep bad arguments apart from it. Commander has written the message to
+ * stderr by the time this runs; help and version exit 0 and are left alone.
+ * https://github.com/tj/commander.js#override-exit-and-output-handling
+ */
+export declare function usageErrorsExit(code: number): (error: CommanderError) => void;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,EACxC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAS/B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAI7E"}

package/dist/run.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// The one place a command's failure becomes an exit code.
+//
+// Every action is wrapped, so no command can throw past commander: a CliError
+// prints its own message and its own code, anything else prints its message and
+// exits 1. Nothing prints a stack trace, because a stack trace is never the
+// answer to "which file is wrong".
+import { CliError, messageOf } from "./errors.js";
+/** Wraps a command body so it reports failures as a message plus an exit code. */
+export function action(body) {
+    return async (...args) => {
+        try {
+            await body(...args);
+        }
+        catch (error) {
+            console.error(messageOf(error));
+            process.exitCode = error instanceof CliError ? error.exitCode : 1;
+        }
+    };
+}
+/**
+ * For a command's `exitOverride`: commander's own usage errors (a required
+ * option not given, an unknown option, a missing argument) exit with `code`
+ * instead of its default 1, so a command that reserves 1 for a result can
+ * keep bad arguments apart from it. Commander has written the message to
+ * stderr by the time this runs; help and version exit 0 and are left alone.
+ * https://github.com/tj/commander.js#override-exit-and-output-handling
+ */
+export function usageErrorsExit(code) {
+    return (error) => {
+        if (error.exitCode !== 0)
+            process.exit(code);
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,0DAA0D;AAC1D,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,mCAAmC;AAInC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElD,kFAAkF;AAClF,MAAM,UAAU,MAAM,CACpB,IAA0C;IAE1C,OAAO,KAAK,EAAE,GAAG,IAAO,EAAiB,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAChC,OAAO,CAAC,QAAQ,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC"}

package/dist/simulate.d.ts

@@ -0,0 +1,35 @@
+import type { RunOptions, Scenario, SimulationRun } from "@flow-as-code/core";
+import { type LiveClients } from "./aws.js";
+/** Absolute path of the packaged scenario schema (`../schema` from src or dist). */
+export declare const SCENARIO_SCHEMA_PATH: string;
+export interface SimulateOptions {
+    instance: string;
+    resourceMap?: string;
+    format?: string;
+    out?: string;
+}
+export interface LoadedScenario {
+    /** Absolute path the scenario was read from. */
+    path: string;
+    scenario: Scenario;
+}
+/**
+ * Schema violations for a value that claims to be a scenario, then the
+ * cross-field findings for one that passes the schema. Empty when it is valid.
+ */
+export declare function scenarioProblems(value: unknown): string[];
+/**
+ * Absolute paths of the scenario files a `<scenarios>` argument names. A file
+ * contributes itself. A directory contributes every `scenario.json` and
+ * `*.scenario.json` in it and in its immediate subdirectories (the layout of
+ * conformance/simulate/, one `<case>/scenario.json` per case), sorted by path.
+ */
+export declare function resolveScenarioPaths(target: string): string[];
+/** Reads and validates every scenario a `<scenarios>` argument names. */
+export declare function loadScenarios(target: string): LoadedScenario[];
+/**
+ * Runs the suite. `timing` exists for the tests, which must not wait on real
+ * poll intervals; it is the subset of RunOptions that changes no behaviour.
+ */
+export declare function runSimulate(target: string, options: SimulateOptions, clients?: LiveClients, timing?: Pick<RunOptions, "now" | "sleep" | "pollIntervalMs">): Promise<SimulationRun>;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../src/simulate.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAkB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAY9F,OAAO,EAAE,KAAK,WAAW,EAAiC,MAAM,UAAU,CAAC;AAI3E,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AAWF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAczD;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA2B7D;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CA+B9D;AAWD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,WAAyB,EAClC,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,OAAO,GAAG,gBAAgB,CAAM,GAChE,OAAO,CAAC,aAAa,CAAC,CAmDxB"}

package/dist/simulate.js

@@ -0,0 +1,194 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// `flow-cli simulate <scenarios> --instance <arn> [--resource-map <file>] [--format junit|json] [--out <file>]`.
+//
+// Runs a scenario suite through @flow-as-code/core's runScenarios, which owns the
+// TestCase lifecycle (create published, execute, poll, collect, delete) and the
+// documented limits: 5 concurrent, 100 in flight including the running 5,
+// 5 minutes per scenario.
+// https://docs.aws.amazon.com/connect/latest/adminguide/testing-simulation-execute-test-cases.html
+//
+// Everything that can fail offline fails before the instance is touched, and
+// all at once: every scenario file is schema-validated against the packaged
+// byte copy of conformance/schema/scenario-0.1.schema.json, then checked by
+// @flow-as-code/core's validateScenario for the cross-field rules the schema cannot
+// express, and every ${cdref:...} token is resolved against --resource-map. A
+// suite with one broken scenario creates no test case.
+//
+// The report goes to --out or stdout; failures also go to stderr, one block per
+// scenario that did not pass, so a CI log says why without opening the XML.
+// Exit 0 means every scenario PASSED. Anything else (FAILED, TIMED_OUT,
+// ERRORED, STOPPED) exits 1.
+import { readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { compileScenario, jsonReport, junitReport, resolveScenario, runScenarios, validateScenario, } from "@flow-as-code/core";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { parseInstanceArn, SDK_CLIENTS } from "./aws.js";
+import { readStringMap } from "./docs.js";
+import { CliError, messageOf } from "./errors.js";
+/** Absolute path of the packaged scenario schema (`../schema` from src or dist). */
+export const SCENARIO_SCHEMA_PATH = fileURLToPath(new URL("../schema/scenario-0.1.schema.json", import.meta.url));
+/** The file names a directory argument picks up, matching conformance/simulate/. */
+const SCENARIO_FILE = "scenario.json";
+const SCENARIO_SUFFIX = ".scenario.json";
+const FORMATS = new Set(["junit", "json"]);
+/** Errors reported for one scenario before the rest are elided. */
+const MAX_SCHEMA_ERRORS = 10;
+let compiled;
+function scenarioValidator() {
+    if (compiled === undefined) {
+        const schema = JSON.parse(readFileSync(SCENARIO_SCHEMA_PATH, "utf8"));
+        compiled = new Ajv2020({ allErrors: true, strict: false }).compile(schema);
+    }
+    return compiled;
+}
+/**
+ * Schema violations for a value that claims to be a scenario, then the
+ * cross-field findings for one that passes the schema. Empty when it is valid.
+ */
+export function scenarioProblems(value) {
+    const validate = scenarioValidator();
+    if (!validate(value)) {
+        const errors = validate.errors ?? [];
+        const shown = errors.slice(0, MAX_SCHEMA_ERRORS).map((error) => {
+            const where = error.instancePath === "" ? "(root)" : error.instancePath;
+            return `${where} ${error.message ?? "is invalid"}`;
+        });
+        if (errors.length > MAX_SCHEMA_ERRORS) {
+            shown.push(`... and ${String(errors.length - MAX_SCHEMA_ERRORS)} more`);
+        }
+        return shown;
+    }
+    return validateScenario(value).map((finding) => `${finding.path}: ${finding.message}`);
+}
+function isScenarioFile(name) {
+    return name === SCENARIO_FILE || name.endsWith(SCENARIO_SUFFIX);
+}
+/**
+ * Absolute paths of the scenario files a `<scenarios>` argument names. A file
+ * contributes itself. A directory contributes every `scenario.json` and
+ * `*.scenario.json` in it and in its immediate subdirectories (the layout of
+ * conformance/simulate/, one `<case>/scenario.json` per case), sorted by path.
+ */
+export function resolveScenarioPaths(target) {
+    const abs = resolve(target);
+    let stat;
+    try {
+        stat = statSync(abs);
+    }
+    catch {
+        throw new CliError(`No such file or directory: ${abs}`);
+    }
+    if (!stat.isDirectory())
+        return [abs];
+    const found = [];
+    for (const entry of readdirSync(abs, { withFileTypes: true })) {
+        const path = join(abs, entry.name);
+        if (entry.isDirectory()) {
+            for (const inner of readdirSync(path)) {
+                if (isScenarioFile(inner))
+                    found.push(join(path, inner));
+            }
+        }
+        else if (isScenarioFile(entry.name)) {
+            found.push(path);
+        }
+    }
+    if (found.length === 0) {
+        throw new CliError(`No ${SCENARIO_FILE} or *${SCENARIO_SUFFIX} files in ${abs} or its subdirectories`);
+    }
+    return found.sort();
+}
+/** Reads and validates every scenario a `<scenarios>` argument names. */
+export function loadScenarios(target) {
+    const problems = [];
+    const loaded = [];
+    for (const path of resolveScenarioPaths(target)) {
+        let raw;
+        try {
+            raw = readFileSync(path, "utf8");
+        }
+        catch (error) {
+            problems.push(`${path}: ${messageOf(error)}`);
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (error) {
+            problems.push(`${path}: invalid JSON: ${messageOf(error)}`);
+            continue;
+        }
+        const found = scenarioProblems(parsed);
+        if (found.length > 0) {
+            for (const problem of found)
+                problems.push(`${path}: ${problem}`);
+            continue;
+        }
+        loaded.push({ path, scenario: parsed });
+    }
+    if (problems.length > 0) {
+        throw new CliError(`${String(problems.length)} problem(s):\n  - ${problems.join("\n  - ")}`);
+    }
+    return loaded;
+}
+/** The lines stderr gets for one scenario that did not pass. */
+function describeFailure(result) {
+    const lines = [
+        `${result.status}: ${result.name}${result.message === undefined ? "" : `: ${result.message}`}`,
+    ];
+    for (const detail of result.details ?? [])
+        lines.push(`  ${detail}`);
+    return lines.join("\n");
+}
+/**
+ * Runs the suite. `timing` exists for the tests, which must not wait on real
+ * poll intervals; it is the subset of RunOptions that changes no behaviour.
+ */
+export async function runSimulate(target, options, clients = SDK_CLIENTS, timing = {}) {
+    const format = options.format ?? "junit";
+    if (!FORMATS.has(format)) {
+        throw new CliError(`Unknown --format "${format}". Use "junit" or "json".`);
+    }
+    const instance = parseInstanceArn(options.instance);
+    const scenarios = loadScenarios(target);
+    const resourceMap = options.resourceMap === undefined ? {} : readStringMap(options.resourceMap, "resource map");
+    // Every unresolved token in the suite, before a single test case exists.
+    const unresolved = [];
+    for (const { path, scenario } of scenarios) {
+        try {
+            resolveScenario(compileScenario(scenario), resourceMap);
+        }
+        catch (error) {
+            unresolved.push(`${path}: ${messageOf(error)}`);
+        }
+    }
+    if (unresolved.length > 0) {
+        throw new CliError(`${String(unresolved.length)} scenario(s) cannot be resolved` +
+            `${options.resourceMap === undefined ? " (no --resource-map given)" : ""}:\n  - ` +
+            unresolved.join("\n  - "));
+    }
+    const client = await clients.test(instance);
+    const run = await runScenarios(scenarios.map((s) => s.scenario), client, { resourceMap, ...timing });
+    const report = format === "json" ? jsonReport(run) : junitReport(run);
+    if (options.out === undefined) {
+        process.stdout.write(report);
+    }
+    else {
+        const out = resolve(options.out);
+        writeFileSync(out, report, "utf8");
+        console.log(out);
+    }
+    const notPassed = run.results.filter((result) => result.status !== "PASSED");
+    for (const result of notPassed)
+        console.error(describeFailure(result));
+    if (notPassed.length > 0) {
+        throw new CliError(`${String(notPassed.length)} of ${String(run.results.length)} scenario(s) did not pass`);
+    }
+    return run;
+}
+//# sourceMappingURL=simulate.js.map

package/dist/simulate.js.map

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

package/dist/studio.d.ts

@@ -0,0 +1,23 @@
+import type { BridgeEvent } from "./bridge/protocol.js";
+import { type StudioServer } from "./bridge/server.js";
+/**
+ * Absolute path of the built studio assets. Throws a CliError naming the fix
+ * when the package is missing or has not been built.
+ */
+export declare function resolveStudioAssets(): string;
+export interface StudioOptions {
+    /** Commander passes strings; 0 or absent means "pick a free port". */
+    port?: string;
+    /** Test seam: skip the asset directory (API only). */
+    assetsDir?: string;
+}
+/** One line per bridge event, so the terminal shows the sync happening. */
+export declare function eventLine(event: BridgeEvent, dir: string): string;
+/**
+ * Starts the studio server and returns it. The caller keeps the process alive;
+ * the command body below waits for a signal.
+ */
+export declare function runStudio(dir: string | undefined, options?: StudioOptions): Promise<StudioServer>;
+/** The command body: run until the terminal interrupts it. */
+export declare function studioCommand(dir: string | undefined, options: StudioOptions): Promise<void>;
+//# sourceMappingURL=studio.d.ts.map

package/dist/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../src/studio.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAO1E;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CA+B5C;AAED,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,aAAkB,yBAiCnF;AAED,8DAA8D;AAC9D,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/studio.js

@@ -0,0 +1,120 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// `flow-cli studio [dir]`: serve the local visual editor over a directory.
+//
+// The command is thin on purpose. Everything it does is start the bridge in
+// src/bridge/server.ts, point it at the studio's built assets, and print the
+// URL; the interesting behaviour is testable there without a subprocess. It
+// asks the bridge for `ensurePairs`, which writes the missing `<name>.flow.ts`
+// for every document in the directory so that a directory of FlowDocs alone
+// can start the edit-the-builder-file loop, and prints what that wrote.
+//
+// The assets are resolved through the studio package's own exports rather than
+// a relative path, because @flow-as-code/cli is published and installed on its
+// own: in a user's node_modules the studio is a sibling package, not a sibling
+// directory. A studio that is installed but not built is the common local
+// failure and gets its own message naming the command that fixes it.
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { basename, dirname, relative, resolve } from "node:path";
+import { PACKAGE_NAMES } from "@flow-as-code/core";
+import { startStudioServer } from "./bridge/server.js";
+import { CliError } from "./errors.js";
+/** The studio's published entry point, resolved through its package exports. */
+const STUDIO_INDEX = `${PACKAGE_NAMES.studio}/dist/index.html`;
+const STUDIO_PACKAGE = `${PACKAGE_NAMES.studio}/package.json`;
+/**
+ * Absolute path of the built studio assets. Throws a CliError naming the fix
+ * when the package is missing or has not been built.
+ */
+export function resolveStudioAssets() {
+    const require = createRequire(import.meta.url);
+    let packageJson;
+    try {
+        packageJson = require.resolve(STUDIO_PACKAGE);
+    }
+    catch {
+        throw new CliError(`flow-cli studio needs ${PACKAGE_NAMES.studio}, which is not installed. ` +
+            `It ships as a dependency of ${PACKAGE_NAMES.cli}, so this usually means a partial install: ` +
+            `run "npm install".`);
+    }
+    const dist = resolve(dirname(packageJson), "dist");
+    if (!existsSync(resolve(dist, "index.html"))) {
+        throw new CliError(`The studio has not been built: ${resolve(dist, "index.html")} does not exist. ` +
+            `Run "npm run build --workspace ${PACKAGE_NAMES.studio}" (or "npm run build" ` +
+            `at the repository root) and try again.`);
+    }
+    // Resolving the entry through the exports map as well, so a package whose
+    // exports stop publishing dist/ fails here rather than serving nothing.
+    try {
+        require.resolve(STUDIO_INDEX);
+    }
+    catch {
+        throw new CliError(`${PACKAGE_NAMES.studio} does not export ${STUDIO_INDEX.split("/").pop() ?? "dist"}; ` +
+            `this flow-cli is not compatible with the installed studio.`);
+    }
+    return dist;
+}
+/** One line per bridge event, so the terminal shows the sync happening. */
+export function eventLine(event, dir) {
+    const where = (path) => relative(dir, path) || path;
+    switch (event.kind) {
+        case "synced":
+            return `synced   ${event.name}`;
+        case "conflict":
+            return `conflict ${event.name}: ${event.reason}`;
+        case "error":
+            return `error    ${where(event.path)}: ${event.message}`;
+    }
+}
+/**
+ * Starts the studio server and returns it. The caller keeps the process alive;
+ * the command body below waits for a signal.
+ */
+export async function runStudio(dir, options = {}) {
+    const target = resolve(dir ?? process.cwd());
+    const port = options.port === undefined ? 0 : Number(options.port);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new CliError(`--port must be a whole number between 0 and 65535, not "${options.port}".`);
+    }
+    const assetsDir = options.assetsDir ?? resolveStudioAssets();
+    let server;
+    try {
+        server = await startStudioServer({
+            dir: target,
+            assetsDir,
+            port,
+            // A directory of FlowDocs with no builder files beside them cannot start
+            // the loop this command exists for, because there is nothing to edit.
+            ensurePairs: true,
+            onEvent: (event) => console.log(eventLine(event, target)),
+        });
+    }
+    catch (error) {
+        throw new CliError(error instanceof Error ? error.message : String(error));
+    }
+    for (const { tsPath, name } of server.prepared.generated) {
+        console.log(`wrote    ${basename(tsPath)} from ${name}.flowdoc.json`);
+    }
+    for (const { name, message } of server.prepared.problems) {
+        console.log(`skipped  ${name}.flowdoc.json: ${message}`);
+    }
+    console.log(`flow-cli studio serving ${target}`);
+    console.log(`  open ${server.url}`);
+    console.log(`  the bridge listens on ${server.host} only; press Ctrl+C to stop`);
+    return server;
+}
+/** The command body: run until the terminal interrupts it. */
+export async function studioCommand(dir, options) {
+    const server = await runStudio(dir, options);
+    await new Promise((resolveP) => {
+        const stop = () => {
+            void server.close().then(() => resolveP());
+        };
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+}
+//# sourceMappingURL=studio.js.map

package/dist/studio.js.map

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

package/dist/synth-resolve-hook.d.ts

@@ -0,0 +1,19 @@
+export interface HookData {
+    fallbackParentURL?: string;
+    flowCorePackage?: string;
+}
+export declare function initialize(data: HookData | undefined): void;
+interface ResolveContext {
+    parentURL?: string;
+    conditions?: readonly string[];
+    importAttributes?: Record<string, string>;
+}
+interface Resolution {
+    url: string;
+    format?: string | null;
+    shortCircuit?: boolean;
+}
+type NextResolve = (specifier: string, context: ResolveContext) => Promise<Resolution>;
+export declare function resolve(specifier: string, context: ResolveContext, nextResolve: NextResolve): Promise<Resolution>;
+export {};
+//# sourceMappingURL=synth-resolve-hook.d.ts.map

package/dist/synth-resolve-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synth-resolve-hook.d.ts","sourceRoot":"","sources":["../src/synth-resolve-hook.ts"],"names":[],"mappings":"AA+DA,MAAM,WAAW,QAAQ;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAG3D;AAED,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,KAAK,WAAW,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAiCvF,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,UAAU,CAAC,CA6BrB"}