@assemora/cli 0.1.0

package/dist/commands/new.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What node is given to run the server.
+ *
+ * Everything after `--` is node's, and node reads its own options before the script
+ * path: `assemora dev -- --inspect` runs `node --watch --inspect src/server.ts`.
+ * Arguments meant for the server itself have a better home — a server already reads
+ * its port and its database URL from the environment, and the environment is
+ * inherited whole.
+ *
+ * The watchdog is preloaded with the pid of the process supervising the server, which
+ * is what it watches. `--watch` hands node's own flags on to the process it restarts,
+ * so the server has it under `dev` too, one process below.
+ */
+export declare const serverArgv: (options: {
+    readonly watch: boolean;
+    readonly passthrough: readonly string[];
+    readonly entry: string;
+    readonly supervisor: number;
+}) => string[];
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AA+KA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,YAAa;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,KAAG,MAAM,EAMT,CAAA"}

package/dist/commands/run.js

@@ -0,0 +1,355 @@
+/**
+ * `dev`, `start` and `build` — running the project (SPEC.md §77).
+ *
+ * The three commands are one idea: the CLI spawns a process and lives exactly as
+ * long as it does. Node 24 executes TypeScript directly, so `assemora dev` is
+ * `node --watch src/server.ts` and nothing more. There is no transpiler here and
+ * there must not be one — it would put a build step back between the file a
+ * developer edits and the file that runs, which is the step Node removed.
+ *
+ * `build` is the exception that proves it: the only thing this CLI compiles is the
+ * project's types, and it does that with the project's own TypeScript. A project that
+ * bundles something of its own declares a `build` script, and that script is the last
+ * of `build`'s three steps rather than a replacement for the other two.
+ */
+import { spawn } from 'node:child_process';
+import { readFile, stat } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { constants } from 'node:os';
+import { dirname, join } from 'node:path';
+import { ConfigurationError } from '@assemora/core';
+import { bool } from '../args.js';
+import { loadConfig } from '../config.js';
+import { fail, line, ok } from '../output.js';
+import { commandNamed, defineCommand, register } from '../registry.js';
+const isFile = async (path) => {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+const isRecord = (value) => typeof value === 'object' && value !== null;
+/** What the shell reports for a process a signal killed, and what Ctrl-C leaves behind. */
+const codeForSignal = (signal) => 128 + (constants.signals[signal] ?? 0);
+/**
+ * The signals a terminal sends when it wants what is running to stop.
+ *
+ * SIGHUP is here because the child runs in a process group of its own: closing the
+ * terminal signals its foreground group, which is now the CLI alone, so a hangup the
+ * CLI does not pass on is a `dev` server left running with no terminal to stop it from.
+ */
+const FORWARDED = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+/**
+ * Whether a signal can address a whole process group.
+ *
+ * POSIX has one; Windows has nothing equivalent — the shape of the answer there is
+ * `taskkill /T`, a second process spawned to end the first, which is not something to
+ * write untested. On Windows the child alone is signalled, exactly as before.
+ */
+const GROUPS = process.platform !== 'win32';
+/**
+ * Stops the child, and everything the child started with it.
+ *
+ * A negative pid addresses the process group, which is the whole reason the child is
+ * spawned detached. `assemora dev` runs `node --watch`, and the watcher is a wrapper:
+ * the server holding the port is *its* child. Signalling the wrapper alone — and
+ * SIGKILL in particular, which it cannot pass on — left the server running with init
+ * for a parent and the port still held, which is exactly what the docstring below
+ * promises cannot happen.
+ */
+const stop = (child, signal) => {
+    const { pid } = child;
+    if (pid === undefined)
+        return;
+    try {
+        if (GROUPS)
+            process.kill(-pid, signal);
+        else
+            child.kill(signal);
+    }
+    catch {
+        // ESRCH is the group having already gone, which is the outcome being asked for;
+        // anything else is a group that could not be signalled, and the child alone is
+        // better than nothing. Neither may throw: this runs inside a signal listener,
+        // where an exception ends the process with the child still running.
+        child.kill(signal);
+    }
+};
+/**
+ * Runs a child process to completion and answers with its exit code.
+ *
+ * Three things here are the whole point. Listening for the terminal's signals
+ * suppresses Node's default of dying on the spot, so Ctrl-C asks the child to stop and
+ * the CLI stays alive until it has — a `dev` server never outlives the command that
+ * started it, and never keeps the port. A second signal escalates to SIGKILL, because
+ * a child that ignores SIGTERM would otherwise make Ctrl-C look broken. And every
+ * signal goes to the child's process group rather than to the child, because what is
+ * spawned is often a wrapper — `node --watch`, a package manager — and the process
+ * that holds the port is one below it.
+ *
+ * `detached` is what creates that group. It also takes the child out of the terminal's
+ * foreground group, so the terminal's own Ctrl-C no longer reaches it directly and the
+ * forwarding below is the only path — which is why SIGHUP is forwarded too. And it
+ * means a CLI killed outright, with nothing forwarded, leaves the group untouched:
+ * `watchdog.ts` is preloaded into the server for exactly that case.
+ */
+const spawnProcess = (executable, argv, options) => new Promise((resolve, reject) => {
+    const child = spawn(executable, [...argv], {
+        cwd: options.cwd,
+        stdio: 'inherit',
+        detached: GROUPS,
+    });
+    let asked = false;
+    const forward = (signal) => {
+        stop(child, asked ? 'SIGKILL' : signal);
+        asked = true;
+    };
+    const listeners = FORWARDED.map((signal) => {
+        const listener = () => forward(signal);
+        process.on(signal, listener);
+        return [signal, listener];
+    });
+    // A CLI that ran two commands in one process would otherwise keep signalling a
+    // child that had already exited, and the listeners alone would stop Node leaving.
+    const release = () => {
+        for (const [signal, listener] of listeners)
+            process.off(signal, listener);
+    };
+    child.once('error', (error) => {
+        release();
+        reject(error);
+    });
+    child.once('exit', (code, signal) => {
+        release();
+        resolve(code ?? (signal === null ? 1 : codeForSignal(signal)));
+    });
+});
+const serverEntry = async (loaded) => {
+    if (loaded.server === undefined) {
+        throw new ConfigurationError(`${loaded.file} declares no "server", so there is nothing to run. ` +
+            "Add `server: 'src/server.ts'` — the file that starts the application.");
+    }
+    if (!(await isFile(loaded.server))) {
+        throw new ConfigurationError(`${loaded.file} names ${loaded.server} as the server to run, and there is no such file.`);
+    }
+    return loaded.server;
+};
+/**
+ * The preload that takes the server down when the CLI dies with no chance to say so.
+ *
+ * Under Vitest this module runs from its source, and the file beside it is the source
+ * too; Node executes it as it executes the project's own `server.ts`.
+ */
+const WATCHDOG = new URL(import.meta.url.endsWith('.ts') ? './watchdog.ts' : './watchdog.js', import.meta.url);
+/**
+ * What node is given to run the server.
+ *
+ * Everything after `--` is node's, and node reads its own options before the script
+ * path: `assemora dev -- --inspect` runs `node --watch --inspect src/server.ts`.
+ * Arguments meant for the server itself have a better home — a server already reads
+ * its port and its database URL from the environment, and the environment is
+ * inherited whole.
+ *
+ * The watchdog is preloaded with the pid of the process supervising the server, which
+ * is what it watches. `--watch` hands node's own flags on to the process it restarts,
+ * so the server has it under `dev` too, one process below.
+ */
+export const serverArgv = (options) => [
+    ...(options.watch ? ['--watch'] : []),
+    '--import',
+    `${WATCHDOG.href}?parent=${options.supervisor}`,
+    ...options.passthrough,
+    options.entry,
+];
+/**
+ * `dev` and `start`, which differ by one flag.
+ *
+ * The child is `process.execPath` rather than the word `node`, so the server runs
+ * under the same Node the CLI is running under, whatever PATH happens to say.
+ */
+const runServer = async (cwd, args, watch) => {
+    const loaded = await loadConfig(cwd);
+    const entry = await serverEntry(loaded);
+    return spawnProcess(process.execPath, serverArgv({ watch, passthrough: args.passthrough, entry, supervisor: process.pid }), { cwd: loaded.root });
+};
+const manifestAt = async (root) => {
+    try {
+        const parsed = JSON.parse(await readFile(join(root, 'package.json'), 'utf8'));
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        // The only question being asked of the manifest is whether it declares a build
+        // script. A project that has no readable one has not declared anything.
+        return {};
+    }
+};
+const scriptNamed = (manifest, name) => {
+    const scripts = manifest.scripts;
+    if (!isRecord(scripts))
+        return undefined;
+    const script = scripts[name];
+    return typeof script === 'string' && script.trim() !== '' ? script : undefined;
+};
+const LOCKFILES = [
+    { file: 'pnpm-lock.yaml', executable: 'pnpm' },
+    { file: 'yarn.lock', executable: 'yarn' },
+    { file: 'bun.lockb', executable: 'bun' },
+    { file: 'package-lock.json', executable: 'npm' },
+];
+/**
+ * Which package manager runs the project's own `build` script.
+ *
+ * `packageManager` is asked first because it is the field a project uses to say so;
+ * the lockfile answers when it is absent, and npm is what is left when a project has
+ * neither. Getting this wrong is cheap and loud — the wrong manager fails to start
+ * — where guessing npm unconditionally would run a script against the wrong
+ * `node_modules`.
+ */
+const packageManagerFor = async (root, manifest) => {
+    const declared = manifest.packageManager;
+    if (typeof declared === 'string') {
+        const name = declared.split('@')[0];
+        if (name !== undefined && name !== '')
+            return name;
+    }
+    for (const { file, executable } of LOCKFILES) {
+        if (await isFile(join(root, file)))
+            return executable;
+    }
+    return 'npm';
+};
+/** On Windows a package manager is a `.cmd` shim, and spawn does not find it otherwise. */
+const executableName = (name) => process.platform === 'win32' ? `${name}.cmd` : name;
+/**
+ * The project's own TypeScript, run as a script by the Node already running.
+ *
+ * Resolving `typescript/package.json` from the project root is what finds it: every
+ * version of the package exports that file, where `typescript/bin/tsc` is not
+ * reachable through the package's own `exports`. Spawning it through
+ * `process.execPath` avoids depending on `node_modules/.bin` being populated, which
+ * a pnpm store layout or a hoisting setting is free to change.
+ */
+const compilerIn = (root) => {
+    try {
+        const resolve = createRequire(join(root, 'package.json'));
+        return join(dirname(resolve.resolve('typescript/package.json')), 'bin', 'tsc');
+    }
+    catch {
+        return undefined;
+    }
+};
+const typecheck = async (root) => {
+    const tsconfig = join(root, 'tsconfig.json');
+    if (!(await isFile(tsconfig))) {
+        throw new ConfigurationError(`There is no tsconfig.json in ${root}, so the project cannot be typechecked. ` +
+            'Add one, or run `assemora build --no-typecheck`.');
+    }
+    const compiler = compilerIn(root);
+    if (compiler === undefined) {
+        throw new ConfigurationError(`TypeScript is not installed in ${root}, so there is nothing to typecheck with. ` +
+            'Install it as a dependency of the project, or run `assemora build --no-typecheck`.');
+    }
+    return spawnProcess(process.execPath, [compiler, '--project', tsconfig, '--noEmit'], {
+        cwd: root,
+    });
+};
+const NO_ARGUMENTS = {
+    command: undefined,
+    positionals: [],
+    flags: {},
+    passthrough: [],
+};
+/**
+ * Regenerates one artifact by running the command that owns it.
+ *
+ * `build` generates nothing itself. `api:openapi` and `sdk:generate` already know
+ * how, and reaching them through the command table is what stops a build writing a
+ * document that differs from the one the command writes — the reason the table
+ * exists at all.
+ */
+const regenerate = async (name, cwd) => {
+    const command = commandNamed(name);
+    if (command === undefined) {
+        // Every group registers from `commands/index.ts`, so a missing one is a mistake
+        // in the CLI rather than anything the project can fix. It still has to stop the
+        // build: a green build that quietly generated nothing is how a stale document
+        // reaches a deployment.
+        throw new ConfigurationError(`The config declares an artifact for "${name}", and this CLI has no such command.`);
+    }
+    line(`Running ${name}`);
+    return command.handler({ args: NO_ARGUMENTS, cwd });
+};
+/**
+ * Everything that must be current before the project is deployed.
+ *
+ * Three steps, in the only order that makes sense. Typecheck first, because generating
+ * an OpenAPI document from an application that does not compile is worse than
+ * generating nothing. Then regenerate exactly what the config declares. Then the
+ * project's own `build` script, if it declares one — last, because the generated SDK is
+ * an input to whatever bundles it, and a bundle built before it is a bundle built
+ * against the previous client.
+ *
+ * The project's script used to be an alternative to the other two rather than a step
+ * after them, and the scaffolded project declares one — so `assemora build` there did
+ * neither of the things this command exists to do, and `--no-typecheck` was a flag with
+ * nowhere to take effect.
+ *
+ * Any failed step answers `1`. A child's own code is not passed through, because `2`
+ * already means the invocation was wrong and a compiler's `2` does not mean that.
+ */
+const build = async ({ args, cwd }) => {
+    const loaded = await loadConfig(cwd);
+    const manifest = await manifestAt(loaded.root);
+    const own = scriptNamed(manifest, 'build');
+    if (!bool(args, 'no-typecheck')) {
+        line('Typechecking');
+        if ((await typecheck(loaded.root)) !== 0) {
+            fail('The typecheck failed, so nothing was regenerated and nothing was built.');
+            return 1;
+        }
+    }
+    const declared = [
+        ...(loaded.config.openapi === undefined ? [] : ['api:openapi']),
+        ...(loaded.config.sdk === undefined ? [] : ['sdk:generate']),
+    ];
+    if (declared.length === 0)
+        line('The config declares no artifacts to regenerate.');
+    for (const name of declared) {
+        if ((await regenerate(name, loaded.root)) !== 0) {
+            fail(`${name} failed, so the build is not complete.`);
+            return 1;
+        }
+    }
+    if (own !== undefined) {
+        const manager = await packageManagerFor(loaded.root, manifest);
+        line(`Running the project's own build script (${manager} run build): ${own}`);
+        if ((await spawnProcess(executableName(manager), ['run', 'build'], { cwd: loaded.root })) !== 0) {
+            fail("The project's own build script failed, so the build is not complete.");
+            return 1;
+        }
+    }
+    ok('Build complete.');
+    return 0;
+};
+register(defineCommand({
+    name: 'dev',
+    group: 'run',
+    summary: 'run the server and restart it when a file changes',
+    usage: 'assemora dev [-- <node options>]',
+    handler: ({ args, cwd }) => runServer(cwd, args, true),
+}), defineCommand({
+    name: 'build',
+    group: 'run',
+    summary: "typecheck, regenerate what the config declares, run the project's build",
+    usage: 'assemora build [--no-typecheck]',
+    handler: build,
+}), defineCommand({
+    name: 'start',
+    group: 'run',
+    summary: 'run the server',
+    usage: 'assemora start [-- <node options>]',
+    handler: ({ args, cwd }) => runServer(cwd, args, false),
+}));
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EAAE,IAAI,EAAmB,MAAM,YAAY,CAAA;AAClD,OAAO,EAAqB,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAuB,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE3F,MAAM,MAAM,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IACtD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AAE7C,2FAA2F;AAC3F,MAAM,aAAa,GAAG,CAAC,MAAsB,EAAU,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;AAEhG;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAA8C,CAAA;AAE9F;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAA;AAE3C;;;;;;;;;GASG;AACH,MAAM,IAAI,GAAG,CAAC,KAAmB,EAAE,MAAsB,EAAQ,EAAE;IACjE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAA;IAErB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAM;IAE7B,IAAI,CAAC;QACH,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;;YACjC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;QAChF,+EAA+E;QAC/E,8EAA8E;QAC9E,oEAAoE;QACpE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACpB,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,YAAY,GAAG,CACnB,UAAkB,EAClB,IAAuB,EACvB,OAAiC,EAChB,EAAE,CACnB,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;QACzC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAA;IAEF,IAAI,KAAK,GAAG,KAAK,CAAA;IAEjB,MAAM,OAAO,GAAG,CAAC,MAAsB,EAAQ,EAAE;QAC/C,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QACvC,KAAK,GAAG,IAAI,CAAA;IACd,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC5C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAE5B,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,+EAA+E;IAC/E,kFAAkF;IAClF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC3E,CAAC,CAAA;IAED,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5B,OAAO,EAAE,CAAA;QACT,MAAM,CAAC,KAAK,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAClC,OAAO,EAAE,CAAA;QACT,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEJ,MAAM,WAAW,GAAG,KAAK,EAAE,MAAoB,EAAmB,EAAE;IAClE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAC1B,GAAG,MAAM,CAAC,IAAI,qDAAqD;YACjE,uEAAuE,CAC1E,CAAA;IACH,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,kBAAkB,CAC1B,GAAG,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,MAAM,mDAAmD,CACzF,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,EACnE,OAAO,IAAI,CAAC,GAAG,CAChB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAK1B,EAAY,EAAE,CAAC;IACd,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,UAAU;IACV,GAAG,QAAQ,CAAC,IAAI,WAAW,OAAO,CAAC,UAAU,EAAE;IAC/C,GAAG,OAAO,CAAC,WAAW;IACtB,OAAO,CAAC,KAAK;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,SAAS,GAAG,KAAK,EAAE,GAAW,EAAE,IAAgB,EAAE,KAAc,EAAmB,EAAE;IACzF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAA;IAEvC,OAAO,YAAY,CACjB,OAAO,CAAC,QAAQ,EAChB,UAAU,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,EACpF,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,CACrB,CAAA;AACH,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAoC,EAAE;IAC1E,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QAEtF,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;QAC/E,wEAAwE;QACxE,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,QAAiC,EAAE,IAAY,EAAsB,EAAE;IAC1F,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAA;IAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAA;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AAChF,CAAC,CAAA;AAED,MAAM,SAAS,GAAG;IAChB,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE;IAC9C,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE;IACzC,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE;IACxC,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,KAAK,EAAE;CACxC,CAAA;AAEV;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,KAAK,EAC7B,IAAY,EACZ,QAAiC,EAChB,EAAE;IACnB,MAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,CAAA;IAExC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACnC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,IAAI,CAAA;IACpD,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,SAAS,EAAE,CAAC;QAC7C,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,UAAU,CAAA;IACvD,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,2FAA2F;AAC3F,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAC9C,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AAErD;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY,EAAsB,EAAE;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QAEzD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,KAAK,EAAE,IAAY,EAAmB,EAAE;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IAE5C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAC1B,gCAAgC,IAAI,0CAA0C;YAC5E,kDAAkD,CACrD,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAEjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,kBAAkB,CAC1B,kCAAkC,IAAI,2CAA2C;YAC/E,oFAAoF,CACvF,CAAA;IACH,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE;QACnF,GAAG,EAAE,IAAI;KACV,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,YAAY,GAAe;IAC/B,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,EAAE;IACf,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,EAAE;CAChB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAE,GAAW,EAAmB,EAAE;IACtE,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAElC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,gFAAgF;QAChF,gFAAgF;QAChF,8EAA8E;QAC9E,wBAAwB;QACxB,MAAM,IAAI,kBAAkB,CAC1B,wCAAwC,IAAI,sCAAsC,CACnF,CAAA;IACH,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAA;IAEvB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,KAAK,GAAmB,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE;IACpD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAE1C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC,cAAc,CAAC,CAAA;QAEpB,IAAI,CAAC,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,yEAAyE,CAAC,CAAA;YAE/E,OAAO,CAAC,CAAA;QACV,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAC/D,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;KAC7D,CAAA;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,IAAI,CAAC,iDAAiD,CAAC,CAAA;IAElF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,GAAG,IAAI,wCAAwC,CAAC,CAAA;YAErD,OAAO,CAAC,CAAA;QACV,CAAC;IACH,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QAE9D,IAAI,CAAC,2CAA2C,OAAO,gBAAgB,GAAG,EAAE,CAAC,CAAA;QAE7E,IACE,CAAC,MAAM,YAAY,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,EAC3F,CAAC;YACD,IAAI,CAAC,sEAAsE,CAAC,CAAA;YAE5E,OAAO,CAAC,CAAA;QACV,CAAC;IACH,CAAC;IAED,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAErB,OAAO,CAAC,CAAA;AACV,CAAC,CAAA;AAED,QAAQ,CACN,aAAa,CAAC;IACZ,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,mDAAmD;IAC5D,KAAK,EAAE,kCAAkC;IACzC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;CACvD,CAAC,EACF,aAAa,CAAC;IACZ,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,yEAAyE;IAClF,KAAK,EAAE,iCAAiC;IACxC,OAAO,EAAE,KAAK;CACf,CAAC,EACF,aAAa,CAAC;IACZ,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,oCAAoC;IAC3C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC;CACxD,CAAC,CACH,CAAA"}

package/dist/commands/watchdog.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watchdog.d.ts.map

package/dist/commands/watchdog.d.ts.map

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

package/dist/commands/watchdog.js

@@ -0,0 +1,74 @@
+/**
+ * What keeps a server from outliving the CLI that started it.
+ *
+ * `assemora dev` and `assemora start` preload this file into the server with
+ * `--import`, naming the CLI's pid in the URL. It polls that pid, and when it is gone
+ * it stops the process group it is in — the server, and under `--watch` the wrapper
+ * above it. A signal the CLI forwards is the ordinary way down; this is for the CLI
+ * dying with no chance to forward anything, which is a `kill -9`, a crash, or a tool
+ * that kills the process group of the shell it started. The child runs detached in a
+ * group of its own, so that last one reaches the CLI and nothing below it — and after
+ * an afternoon of it, nineteen servers were listening with init for a parent (#27).
+ *
+ * The pid comes from the URL rather than the environment because the environment is
+ * inherited whole by the server and by whatever the server starts, and a variable in
+ * it is a fact the CLI would be leaking into an application. The import specifier is
+ * the CLI's own, read by nobody else.
+ *
+ * It watches the CLI and not its parent, because under `--watch` its parent is Node's
+ * wrapper, which outlives the CLI: Node runs a preload in the script's process and not
+ * in the wrapper's, so the wrapper cannot watch anything for itself. It is instead
+ * taken down with the group — signalling pid 0 addresses the caller's own group, and
+ * the wrapper answers a SIGTERM by stopping its child and leaving.
+ *
+ * Nothing here may keep the event loop alive or throw: a server that has finished its
+ * work has to be able to exit, and a preload that fails takes the server with it.
+ */
+const EVERY = 500;
+const GRACE = 5_000;
+const supervisor = Number(new URL(import.meta.url).searchParams.get('parent'));
+/**
+ * Whether a pid names nothing any more.
+ *
+ * `ESRCH` is that. `EPERM` is a live process belonging to somebody else, which after a
+ * pid is reused is "not the CLI" too — but it cannot be told apart from the CLI
+ * running under another user, so it counts as alive and the server stays.
+ */
+const gone = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return false;
+    }
+    catch (error) {
+        return error.code === 'ESRCH';
+    }
+};
+/**
+ * Signals this process and everything grouped with it.
+ *
+ * Windows has no process groups; there the process signals itself, and a `--watch`
+ * wrapper stays waiting for a file change, holding nothing. That is the same limit
+ * `run.ts` states for the signals it forwards.
+ */
+const everyone = (signal) => {
+    try {
+        process.kill(process.platform === 'win32' ? process.pid : 0, signal);
+    }
+    catch {
+        // The group has already gone, which is the outcome being asked for.
+    }
+};
+if (Number.isInteger(supervisor) && supervisor > 0) {
+    const timer = setInterval(() => {
+        if (!gone(supervisor))
+            return;
+        clearInterval(timer);
+        everyone('SIGTERM');
+        // A server draining gracefully is the reason for the grace; a server that ignores
+        // SIGTERM is the reason for what follows it.
+        setTimeout(() => everyone('SIGKILL'), GRACE).unref();
+    }, EVERY);
+    timer.unref();
+}
+export {};
+//# sourceMappingURL=watchdog.js.map

package/dist/commands/watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog.js","sourceRoot":"","sources":["../../src/commands/watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,KAAK,GAAG,GAAG,CAAA;AACjB,MAAM,KAAK,GAAG,KAAK,CAAA;AAEnB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;AAE9E;;;;;;GAMG;AACH,MAAM,IAAI,GAAG,CAAC,GAAW,EAAW,EAAE;IACpC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAEpB,OAAO,KAAK,CAAA;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAA;IAC1D,CAAC;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAQ,EAAE;IAChD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;AACH,CAAC,CAAA;AAED,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAM;QAE7B,aAAa,CAAC,KAAK,CAAC,CAAA;QACpB,QAAQ,CAAC,SAAS,CAAC,CAAA;QAEnB,kFAAkF;QAClF,6CAA6C;QAC7C,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAA;IACtD,CAAC,EAAE,KAAK,CAAC,CAAA;IAET,KAAK,CAAC,KAAK,EAAE,CAAA;AACf,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,89 @@
+import { type Application } from '@assemora/core';
+import type { OpenApiInfo } from '@assemora/openapi';
+import type { GenerateOptions } from '@assemora/sdk';
+export type AssemoraPaths = {
+    /** Where `make:*` writes. Defaults to `src`. */
+    readonly source?: string;
+    /** Where `db:generate` writes and `db:migrate` reads. Defaults to `database/migrations`. */
+    readonly migrations?: string;
+    /** Machine-owned output, never edited by hand. Defaults to `.assemora/generated`. */
+    readonly generated?: string;
+};
+/**
+ * What a config's `app()` may hand back.
+ *
+ * The application itself, or the thing `assemora()` built around one. Both are accepted
+ * because the second is the better answer and used to be impossible to give: `app: () =>
+ * createApp().app` was the line every starter carried, and that `.app` threw away the
+ * half of the application that knows about MCP, the server and the frontend — which is
+ * how `assemora mcp` came to have nothing to serve.
+ *
+ * Structural rather than imported: `@assemora/cli` may not depend on the umbrella, and
+ * naming the one member it reads is the whole of what it needs (ADR-0021).
+ */
+export type ConfiguredApplication = Application | {
+    readonly app: Application;
+};
+export type AssemoraConfig = {
+    /**
+     * How the CLI gets the application.
+     *
+     * What comes back has *not* been booted: the CLI boots it once, so two commands in
+     * one process — and `console`, which is many — share a single application and a
+     * single database pool.
+     */
+    readonly app: () => ConfiguredApplication | Promise<ConfiguredApplication>;
+    /** What `dev` and `start` run, relative to the config. */
+    readonly server?: string;
+    readonly paths?: AssemoraPaths;
+    readonly openapi?: {
+        /** Where `api:openapi` writes when `--out` is not given. */
+        readonly out?: string;
+        readonly info?: OpenApiInfo;
+    };
+    readonly sdk?: GenerateOptions & {
+        /** Where `sdk:generate` writes when `--out` is not given. */
+        readonly out?: string;
+    };
+};
+/**
+ * Identity, plus types.
+ *
+ * It exists so that the object is checked where it is written, which is the only
+ * place a mistake in it is cheap to fix.
+ */
+export declare const defineConfig: (config: AssemoraConfig) => AssemoraConfig;
+/** In the order they are looked for, in each directory, on the way up. */
+export declare const CONFIG_FILENAMES: readonly ['assemora.config.ts', 'assemora.config.js'];
+export declare const DEFAULT_PATHS: {
+    readonly source: 'src';
+    readonly migrations: 'database/migrations';
+    readonly generated: '.assemora/generated';
+};
+/** `paths`, defaulted and made absolute. */
+export type ResolvedPaths = {
+    readonly source: string;
+    readonly migrations: string;
+    readonly generated: string;
+};
+export type LoadedConfig = {
+    /** The default export, exactly as it was written. */
+    readonly config: AssemoraConfig;
+    /** Absolute path of the config file that was found. */
+    readonly file: string;
+    /** The directory holding it. Every relative path in the config is relative to this. */
+    readonly root: string;
+    readonly paths: ResolvedPaths;
+    /** `server`, made absolute, or undefined when the config declares none. */
+    readonly server: string | undefined;
+    /** Makes any other path the config carries absolute. An absolute one is left alone. */
+    resolve(path: string): string;
+};
+/**
+ * Finds the project's config, walking up from `cwd`, and validates it.
+ *
+ * Walking up is what lets a command be typed from anywhere inside the project, which
+ * is how every other tool a developer already has behaves.
+ */
+export declare const loadConfig: (cwd: string) => Promise<LoadedConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,WAAW,EAAqC,MAAM,gBAAgB,CAAA;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,MAAM,aAAa,GAAG;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAA;AAE/E,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC1E,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,4DAA4D;QAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAC5B,CAAA;IACD,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG;QAC/B,6DAA6D;QAC7D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,WAAY,cAAc,KAAG,cAAwB,CAAA;AAE9E,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,YAAI,oBAAoB,EAAE,oBAAoB,CAAU,CAAA;AAErF,eAAO,MAAM,aAAa;qBAChB,KAAK;yBACD,qBAAqB;wBACtB,qBAAqB;CACU,CAAA;AAE5C,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,uFAAuF;IACvF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAC9B,CAAA;AAsHD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAAe,MAAM,KAAG,OAAO,CAAC,YAAY,CA0ClE,CAAA"}