@ethlete/cli 3.0.0-next.27 → 3.0.0-next.28

package/src/lib/design/run-abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-abort.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/design/run-abort.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+BAAoF;AAEpF,MAAa,eAAgB,SAAQ,KAAK;IACxC;QACE,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACjF,CAAC;CACF;AAJD,0CAIC;AAED,IAAI,OAAO,GAAuB,IAAI,CAAC;AAEvC,iHAAiH;AAC1G,MAAM,aAAa,GAAG,CAAU,MAA+B,EAAE,GAAqB,EAAE,EAAE;IAC/F,MAAM,KAAK,GAAG,OAAO,CAAC;IAEtB,OAAO,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;AACH,CAAC,CAAA,CAAC;AAVW,QAAA,aAAa,iBAUxB;AAEF,iEAAiE;AAC1D,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;AAA1B,QAAA,SAAS,aAAiB;AAEvC,2FAA2F;AACpF,MAAM,aAAa,GAAG,CAAI,MAA0B,EAAE,IAAgB,EAAE,EAAE;IAC/E,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAEjE,OAAO,IAAA,qBAAc,EACnB,IAAA,WAAI,EAAC,IAAA,WAAI,EAAC,IAAI,CAAC,EAAE,IAAA,gBAAS,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAA,gBAAS,EAAC,GAAG,EAAE,CAAC,IAAA,iBAAU,EAAC,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAC5G,CAAC;AACJ,CAAC,CAAC;AAPW,QAAA,aAAa,iBAOxB"}

package/src/lib/design/run-deadline.d.ts

@@ -0,0 +1,19 @@
+/** The hard deadline of each design command that drives a browser. */
+export declare const RUN_DEADLINES_MS: Readonly<Record<string, number>>;
+export declare const DEADLINE_EXIT_CODE = 124;
+/** Names what the run in progress does now; a run that passes its deadline writes it into its log. */
+export declare const noteStep: (text: string) => void;
+/** The deadline of `command` in ms, or null when it has none. `ETHLETE_DESIGN_DEADLINE_MS` overrides it. */
+export declare const deadlineMsOf: (command: string, env?: NodeJS.ProcessEnv) => number | null;
+/** Where deadline logs go: `$ETHLETE_DESIGN_STATE_DIR/deadline`, else `<tmpdir>/et-design/deadline`. */
+export declare const deadlineLogDirOf: (env?: NodeJS.ProcessEnv) => string;
+/**
+ * Runs `run` and ends the process with `DEADLINE_EXIT_CODE` when it is still running after `ms`, with a log of the
+ * last noted step, the phases it ended and its last output; the log's path goes to stderr. A null `ms` runs without one.
+ */
+export declare const withRunDeadline: (options: {
+    argv: string[];
+    ms: number | null;
+    logDir?: string;
+    exit?: (code: number) => void;
+}, run: () => Promise<number>) => Promise<number>;

package/src/lib/design/run-deadline.js

@@ -0,0 +1,104 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRunDeadline = exports.deadlineLogDirOf = exports.deadlineMsOf = exports.noteStep = exports.DEADLINE_EXIT_CODE = exports.RUN_DEADLINES_MS = void 0;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const rxjs_1 = require("rxjs");
+const timings_1 = require("./timings");
+/** The hard deadline of each design command that drives a browser. */
+exports.RUN_DEADLINES_MS = { shot: 5 * 60000, check: 20 * 60000 };
+exports.DEADLINE_EXIT_CODE = 124;
+const KEPT_LINES = 200;
+let step = null;
+/** Names what the run in progress does now; a run that passes its deadline writes it into its log. */
+const noteStep = (text) => {
+    step = text;
+};
+exports.noteStep = noteStep;
+/** The deadline of `command` in ms, or null when it has none. `ETHLETE_DESIGN_DEADLINE_MS` overrides it. */
+const deadlineMsOf = (command, env = process.env) => {
+    const base = exports.RUN_DEADLINES_MS[command];
+    if (base === undefined)
+        return null;
+    const forced = Number(env['ETHLETE_DESIGN_DEADLINE_MS']);
+    return forced > 0 ? forced : base;
+};
+exports.deadlineMsOf = deadlineMsOf;
+/** Where deadline logs go: `$ETHLETE_DESIGN_STATE_DIR/deadline`, else `<tmpdir>/et-design/deadline`. */
+const deadlineLogDirOf = (env = process.env) => (0, path_1.join)(env['ETHLETE_DESIGN_STATE_DIR'] || (0, path_1.join)((0, os_1.tmpdir)(), 'et-design'), 'deadline');
+exports.deadlineLogDirOf = deadlineLogDirOf;
+const textOf = (chunk) => typeof chunk === 'string' ? chunk : chunk instanceof Uint8Array ? Buffer.from(chunk).toString('utf8') : '';
+/**
+ * Runs `run` and ends the process with `DEADLINE_EXIT_CODE` when it is still running after `ms`, with a log of the
+ * last noted step, the phases it ended and its last output; the log's path goes to stderr. A null `ms` runs without one.
+ */
+const withRunDeadline = (options, run) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { argv, ms } = options;
+    if (ms === null)
+        return run();
+    const exit = (_a = options.exit) !== null && _a !== void 0 ? _a : ((code) => process.exit(code));
+    const lines = [''];
+    const keep = (chunk) => {
+        const [first = '', ...rest] = textOf(chunk).split('\n');
+        lines[lines.length - 1] += first;
+        lines.push(...rest);
+        lines.splice(0, Math.max(0, lines.length - KEPT_LINES));
+    };
+    const streams = [process.stdout, process.stderr];
+    const writes = streams.map((stream) => stream.write);
+    const restore = () => streams.forEach((stream, index) => (stream.write = writes[index]));
+    streams.forEach((stream, index) => {
+        const write = writes[index];
+        stream.write = ((chunk, ...rest) => {
+            keep(chunk);
+            return write.call(stream, chunk, ...rest);
+        });
+    });
+    const began = new Date();
+    step = null;
+    const pass = () => {
+        var _a, _b;
+        restore();
+        const dir = (_a = options.logDir) !== null && _a !== void 0 ? _a : (0, exports.deadlineLogDirOf)();
+        const file = (0, path_1.join)(dir, `${(_b = argv[0]) !== null && _b !== void 0 ? _b : 'design'}-${began.toISOString().replace(/[:.]/g, '-')}-${process.pid}.log`);
+        const log = [
+            `design ${argv.join(' ')} passed its deadline of ${Math.round(ms / 1000)} s`,
+            `pid ${process.pid}, started ${began.toISOString()}, ended ${new Date().toISOString()}`,
+            `last step: ${step !== null && step !== void 0 ? step : 'none noted'}`,
+            'ended phases:',
+            ...(0, timings_1.phasesSoFar)().map(({ name, ms: took, at }) => `  ${name} ${took} ms${at === undefined ? '' : ` at ${at} ms`}`),
+            `last output (${lines.length} lines):`,
+            ...lines,
+        ].join('\n');
+        try {
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+            (0, fs_1.writeFileSync)(file, `${log}\n`);
+            process.stderr.write(`design-explore: \`${argv[0]}\` passed its deadline of ${Math.round(ms / 1000)} s; log: ${file}\n`);
+        }
+        catch (error) {
+            process.stderr.write(`design-explore: \`${argv[0]}\` passed its deadline; the log failed: ${String(error)}\n${log}\n`);
+        }
+        exit(exports.DEADLINE_EXIT_CODE);
+    };
+    const deadline = (0, rxjs_1.timer)(ms).pipe((0, rxjs_1.tap)(pass)).subscribe();
+    try {
+        return yield run();
+    }
+    finally {
+        deadline.unsubscribe();
+        restore();
+    }
+});
+exports.withRunDeadline = withRunDeadline;
+//# sourceMappingURL=run-deadline.js.map

package/src/lib/design/run-deadline.js.map

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

package/src/lib/design/run-yield.d.ts

@@ -0,0 +1,8 @@
+export type YieldTurn = () => Promise<void>;
+/** Runs `run` as a design run that hands its turn to `turn` whenever it calls `yieldRun` between two parts. */
+export declare const withRunYield: <T>(turn: YieldTurn | undefined, run: () => Promise<T>) => Promise<T>;
+/**
+ * Lets the resident design process run the requests waiting for it before this run draws its next part. Call it only
+ * where the run has no draw in flight: everything the run writes while it waits goes to the waiting request.
+ */
+export declare const yieldRun: () => Promise<void>;

package/src/lib/design/run-yield.js

@@ -0,0 +1,43 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yieldRun = exports.withRunYield = void 0;
+let current = null;
+/** Runs `run` as a design run that hands its turn to `turn` whenever it calls `yieldRun` between two parts. */
+const withRunYield = (turn, run) => __awaiter(void 0, void 0, void 0, function* () {
+    const outer = current;
+    current = turn !== null && turn !== void 0 ? turn : null;
+    try {
+        return yield run();
+    }
+    finally {
+        current = outer;
+    }
+});
+exports.withRunYield = withRunYield;
+/**
+ * Lets the resident design process run the requests waiting for it before this run draws its next part. Call it only
+ * where the run has no draw in flight: everything the run writes while it waits goes to the waiting request.
+ */
+const yieldRun = () => __awaiter(void 0, void 0, void 0, function* () {
+    const turn = current;
+    if (!turn)
+        return;
+    current = null;
+    try {
+        yield turn();
+    }
+    finally {
+        current = turn;
+    }
+});
+exports.yieldRun = yieldRun;
+//# sourceMappingURL=run-yield.js.map

package/src/lib/design/run-yield.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-yield.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/design/run-yield.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,IAAI,OAAO,GAAqB,IAAI,CAAC;AAErC,+GAA+G;AACxG,MAAM,YAAY,GAAG,CAAU,IAA2B,EAAE,GAAqB,EAAE,EAAE;IAC1F,MAAM,KAAK,GAAG,OAAO,CAAC;IAEtB,OAAO,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,IAAI,CAAC;IAEvB,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;AACH,CAAC,CAAA,CAAC;AAVW,QAAA,YAAY,gBAUvB;AAEF;;;GAGG;AACI,MAAM,QAAQ,GAAG,GAAS,EAAE;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC;IAErB,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,OAAO,GAAG,IAAI,CAAC;IAEf,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;YAAS,CAAC;QACT,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;AACH,CAAC,CAAA,CAAC;AAZW,QAAA,QAAQ,YAYnB"}

package/src/lib/design/serve-state.d.ts

@@ -0,0 +1,15 @@
+import { ServerIdentity } from './server-identity';
+import { BuildStamp } from './stamp';
+type Served = Partial<ServerIdentity> & Partial<BuildStamp>;
+/** The lines that say who serves the design port, which cli build it runs against `own`, and how to restart it. */
+export declare const serveStateLines: (options: {
+    base: string;
+    own: BuildStamp;
+    served: Served | null;
+}) => string[];
+/** Prints the serve state of `base`; exits 0 also when nothing answers. */
+export declare const designServeState: (options: {
+    base: string;
+    own: BuildStamp;
+}) => Promise<number>;
+export {};

package/src/lib/design/serve-state.js

@@ -0,0 +1,56 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.designServeState = exports.serveStateLines = void 0;
+const stamp_1 = require("./stamp");
+const fetchServed = (base) => __awaiter(void 0, void 0, void 0, function* () {
+    for (const url of (0, stamp_1.stampUrlsOf)(base)) {
+        try {
+            return (yield (yield fetch(url)).json());
+        }
+        catch (_a) {
+            continue;
+        }
+    }
+    return null;
+});
+/** The lines that say who serves the design port, which cli build it runs against `own`, and how to restart it. */
+const serveStateLines = (options) => {
+    var _a, _b, _c;
+    const { base, own, served } = options;
+    if (!served)
+        return [`serve: nothing answers at ${base}. Start it with \`et design\`, or open Studio.`];
+    const stamp = (_a = served.stamp) !== null && _a !== void 0 ? _a : (served.version && served.build ? served : null);
+    const owner = (_b = served.owner) !== null && _b !== void 0 ? _b : 'unknown';
+    const pid = (_c = served.pid) !== null && _c !== void 0 ? _c : 'unknown';
+    const label = { studio: 'the Studio app', terminal: 'a terminal', unknown: 'an unknown owner (an older cli)' }[owner];
+    const same = !!stamp && stamp.version === own.version && stamp.build === own.build;
+    const restart = owner === 'studio'
+        ? 'Press restart in Studio (the design_server_restart command). Do not kill the process, Studio would be left without a server.'
+        : owner === 'terminal'
+            ? `Stop pid ${pid} (Ctrl+C in its terminal) and run \`et design\` again.`
+            : `Restart whatever started pid ${pid}; Studio if it runs in the Studio app.`;
+    return [
+        `serve: ${base} is served by ${label} (pid ${pid})`,
+        `serve: cli ${stamp ? `${stamp.version} build ${stamp.build}` : 'unknown'}${served.cliRoot ? ` from ${served.cliRoot}` : ''}`,
+        `serve: this checkout's cli is ${own.version} build ${own.build}: ${same ? 'the server runs it' : 'the server runs a different build'}`,
+        `serve: ${same ? 'to restart' : 'to load this cli'}: ${restart}`,
+    ];
+};
+exports.serveStateLines = serveStateLines;
+/** Prints the serve state of `base`; exits 0 also when nothing answers. */
+const designServeState = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const served = yield fetchServed(options.base);
+    console.log((0, exports.serveStateLines)(Object.assign(Object.assign({}, options), { served })).join('\n'));
+    return 0;
+});
+exports.designServeState = designServeState;
+//# sourceMappingURL=serve-state.js.map

package/src/lib/design/serve-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-state.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/design/serve-state.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,mCAAkD;AAIlD,MAAM,WAAW,GAAG,CAAO,IAAY,EAA0B,EAAE;IACjE,KAAK,MAAM,GAAG,IAAI,IAAA,mBAAW,EAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAW,CAAC;QACrD,CAAC;QAAC,WAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAA,CAAC;AAEF,mHAAmH;AAC5G,MAAM,eAAe,GAAG,CAAC,OAAiE,EAAE,EAAE;;IACnG,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEtC,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,6BAA6B,IAAI,gDAAgD,CAAC,CAAC;IAExG,MAAM,KAAK,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,MAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,SAAS,CAAC;IACxC,MAAM,GAAG,GAAG,MAAA,MAAM,CAAC,GAAG,mCAAI,SAAS,CAAC;IACpC,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,KAAK,CAAC,CAAC;IACtH,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC;IACnF,MAAM,OAAO,GACX,KAAK,KAAK,QAAQ;QAChB,CAAC,CAAC,8HAA8H;QAChI,CAAC,CAAC,KAAK,KAAK,UAAU;YACpB,CAAC,CAAC,YAAY,GAAG,wDAAwD;YACzE,CAAC,CAAC,gCAAgC,GAAG,wCAAwC,CAAC;IAEpF,OAAO;QACL,UAAU,IAAI,iBAAiB,KAAK,SAAS,GAAG,GAAG;QACnD,cAAc,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7H,iCAAiC,GAAG,CAAC,OAAO,UAAU,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,mCAAmC,EAAE;QACvI,UAAU,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,KAAK,OAAO,EAAE;KACjE,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,eAAe,mBAuB1B;AAEF,2EAA2E;AACpE,MAAM,gBAAgB,GAAG,CAAO,OAA0C,EAAE,EAAE;IACnF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,OAAO,CAAC,GAAG,CAAC,IAAA,uBAAe,kCAAM,OAAO,KAAE,MAAM,IAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhE,OAAO,CAAC,CAAC;AACX,CAAC,CAAA,CAAC;AANW,QAAA,gBAAgB,oBAM3B"}

package/src/lib/design/serve.d.ts

@@ -1,6 +1,17 @@
 import { ServerResponse } from 'http';
+import { SystemModules } from './system/system-modules';
 import { CheckSketches } from './system/sketch/sketch-checker';
-import { DesignConfig } from './paths';
+import { DesignConfig } from './design-config';
+/**
+ * The entries of the env and system modules that a frame with the search params `query` can read: its product's parts,
+ * tokens and stylesheets, and those of the sketch variants it names; a call frame's project stylesheets and themes.
+ */
+export declare const registrySliceOf: (options: {
+    target: string;
+    config: DesignConfig;
+    system: SystemModules;
+    query: URLSearchParams;
+}) => string;
 export declare const KEEP_ALIVE_MS = 15000;
 /**
  * Sends `answered` as JSON, and a space every `KEEP_ALIVE_MS` while it is pending: WebKit fails a fetch with "Load
@@ -12,6 +23,8 @@ export declare const sendHeldJson: (response: ServerResponse, answered: Promise<
     body: unknown;
 }>) => Promise<void>;
 export declare const DESIGN_EVENTS_HEARTBEAT_MS = 20000;
+/** Test tooling: when set to a whole number of ms, every `/frame.html` document waits that long before it is served. */
+export declare const DELAY_FRAMES_ENV = "ETHLETE_DESIGN_DELAY_FRAMES_MS";
 /** The real directories a checkout's `node_modules` points into, which Vite refuses to serve unless allowed. */
 export declare const installedRootsOf: (target: string) => string[];
 /**
@@ -29,7 +42,12 @@ export declare const createDesignServer: (options: {
     host?: string;
     sketchesRoot?: string;
     checkSketches?: CheckSketches;
-}) => Promise<import("vite", { with: { "resolution-mode": "import" } }).ViteDevServer>;
+}) => Promise<import("vite", { with: { "resolution-mode": "import" } }).ViteDevServer & {
+    /** A disk store of this server's part pictures under `dir`; an entry is served while every file it was drawn from is unchanged. */
+    shotStore: (dir: string, salt: string) => import("./shot-store").ShotStore;
+    /** Forgets every loaded part, sketch and module, so the next draw reads the files as they are now: a server started with `port` does not watch them. */
+    forgetDrawn: () => void;
+}>;
 /**
  * Starts the design server for a checkout and keeps it running. The returned exit code is the
  * command's, not the server's: a listening server holds the process open on its own. With