@vltpkg/cli-sdk 0.0.0-9 → 1.0.0-rc.2

package/dist/esm/print-err.js

@@ -1,21 +1,45 @@
-import { isErrorWithCode } from '@vltpkg/error-cause';
+import { splitDepID } from '@vltpkg/dep-id';
+import { parseError } from '@vltpkg/output/error';
+import { isErrorWithCause, isObject } from '@vltpkg/types';
+import { XDG } from '@vltpkg/xdg';
+import { isGraphRunError } from 'graph-run';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
 import { formatWithOptions } from 'node:util';
-const trimStack = (err) => {
-    if (err.stack) {
-        const lines = err.stack.trim().split('\n');
-        if (lines[0] === `${err.name}: ${err.message}`) {
-            lines.shift();
-        }
-        return lines.map(l => l.trim()).join('\n');
-    }
+export const formatOptions = {
+    depth: Infinity,
+    maxArrayLength: Infinity,
+    maxStringLength: Infinity,
 };
-const indent = (lines, num = 2) => lines
+const isNonEmptyString = (v) => !!v && typeof v === 'string';
+const formatURL = (v, format) => v instanceof URL ? v.toString() : /* c8 ignore next */ format(v);
+const formatArray = (v, format, joiner = ', ') => Array.isArray(v) ? v.join(joiner) : /* c8 ignore next */ format(v);
+export const indent = (lines, num = 2) => lines
     .split('\n')
     .map(l => ' '.repeat(num) + l)
     .join('\n');
-export const printErr = (err, usage, stderr, baseOpts) => {
+const writeErrorLog = (e, format) => {
+    try {
+        const dir = new XDG('vlt/error-logs').data();
+        const file = join(dir, `error-${process.pid}.log`);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(file, format(e, {
+            colors: false,
+            maxLines: Infinity,
+        }));
+        return file;
+    }
+    catch {
+        return null;
+    }
+};
+export const printErr = (e, usage, stderr, baseOpts) => {
     const format = (arg, opts) => {
-        const { maxLines = 200, ...rest } = { ...baseOpts, ...opts };
+        const { maxLines = 200, ...rest } = {
+            ...formatOptions,
+            ...baseOpts,
+            ...opts,
+        };
         const lines = formatWithOptions(rest, arg).split('\n');
         const totalLines = lines.length;
         if (totalLines > maxLines) {
@@ -24,42 +48,70 @@ export const printErr = (err, usage, stderr, baseOpts) => {
         }
         return lines.join('\n');
     };
-    // This is an error with a cause, check if it we know about its
-    // code and try to print it. If it did not print then fallback
-    // to the next option.
-    if (isErrorWithCode(err) && print(err, usage, stderr, format)) {
-        return;
+    const err = parseError(e);
+    const knownError = printCode(err, usage, stderr, format);
+    const fileWritten = !knownError || knownError.file ? writeErrorLog(e, format) : null;
+    // We could not write an error log and its not a know error,
+    // so we print the entire formatted value.
+    if (!fileWritten && !knownError) {
+        return stderr(format(e));
     }
-    // We have a real but we dont know anything special about its
-    // properties. Just print the standard error properties as best we can.
-    if (err instanceof Error) {
+    if (err && !knownError) {
         stderr(`${err.name}: ${err.message}`);
-        if ('cause' in err) {
-            stderr(`Cause:`);
-            if (err.cause instanceof Error) {
-                stderr(indent(format(err.cause)));
+    }
+    if (fileWritten) {
+        stderr('');
+        stderr(`Full details written to: ${fileWritten}`);
+    }
+    if (!knownError || knownError.bug) {
+        stderr('');
+        stderr('Open an issue with the full error details at:');
+        stderr(indent('https://github.com/vltpkg/vltpkg/issues/new'));
+    }
+};
+const printCode = (err, usage, stderr, format) => {
+    if (!err)
+        return;
+    switch (err.cause?.code) {
+        case 'GRAPHRUN_TRAVERSAL': {
+            if (!isGraphRunError(err))
+                break;
+            const { node, path, cause } = err.cause;
+            stderr(`Graph traversal failure at: ${splitDepID(node.id).join(' ')}`);
+            if (Array.isArray(path) && path.length) {
+                stderr(indent(`Path: ${path.map(n => n.id).join(',')}`));
             }
-            else if (err.cause && typeof err.cause === 'object') {
-                for (const key in err.cause) {
-                    stderr(indent(`${key}: ${format(err.cause[key])}`));
+            if (isErrorWithCause(cause) &&
+                isObject(cause.cause) &&
+                'command' in cause.cause &&
+                'stdout' in cause.cause &&
+                'stderr' in cause.cause &&
+                'status' in cause.cause &&
+                'signal' in cause.cause &&
+                'cwd' in cause.cause) {
+                const { command, args, cwd, stdout: cmdStdout, stderr: cmdStderr, status, signal, } = cause.cause;
+                stderr(`Command: ${command}`);
+                if (args && Array.isArray(args) && args.length) {
+                    stderr(`Args: ${args.map(a => JSON.stringify(a)).join(', ')}`);
                 }
+                stderr(`Cwd: ${cwd}`);
+                if (cmdStderr || cmdStdout) {
+                    stderr('');
+                    if (isNonEmptyString(cmdStderr)) {
+                        stderr(cmdStderr);
+                    }
+                    if (isNonEmptyString(cmdStdout)) {
+                        stderr(cmdStdout);
+                    }
+                    stderr('');
+                }
+                if (signal !== null)
+                    stderr(`Signal: ${format(signal)}`);
+                if (status !== null)
+                    stderr(`Status: ${format(status)}`);
             }
-            else {
-                stderr(indent(format(err.cause)));
-            }
-        }
-        const stack = trimStack(err);
-        if (stack) {
-            stderr(`Stack:`);
-            stderr(indent(format(stack)));
+            return { file: true };
         }
-        return;
-    }
-    // We don't know what this is, just print it.
-    stderr(`Unknown Error:`, format(err));
-};
-const print = (err, usage, stderr, format) => {
-    switch (err.cause.code) {
         case 'EUSAGE': {
             const { found, validOptions } = err.cause;
             stderr(usage().usage());
@@ -68,15 +120,15 @@ const print = (err, usage, stderr, format) => {
                 stderr(indent(`Found: ${format(found)}`));
             }
             if (validOptions) {
-                stderr(indent(`Valid options: ${format(validOptions.join(', '))}`));
+                stderr(indent(`Valid options: ${formatArray(validOptions, format)}`));
             }
-            return true;
+            return {};
         }
         case 'ERESOLVE': {
             const { url, from, response, spec } = err.cause;
             stderr(`Resolve Error: ${err.message}`);
             if (url) {
-                stderr(indent(`While fetching: ${url}`));
+                stderr(indent(`While fetching: ${formatURL(url, format)}`));
             }
             if (spec) {
                 stderr(indent(`To satisfy: ${format(spec)}`));
@@ -87,7 +139,39 @@ const print = (err, usage, stderr, format) => {
             if (response) {
                 stderr(indent(`Response: ${format(response)}`));
             }
-            return true;
+            return { file: true };
+        }
+        case 'EREQUEST': {
+            const { url, method } = err.cause;
+            const { code, syscall } = err.cause.cause ?? {};
+            stderr(`Request Error: ${err.message}`);
+            if (code) {
+                stderr(indent(`Code: ${format(code)}`));
+            }
+            if (syscall) {
+                stderr(indent(`Syscall: ${format(syscall)}`));
+            }
+            if (url) {
+                stderr(indent(`URL: ${formatURL(url, format)}`));
+            }
+            if (method) {
+                stderr(indent(`Method: ${format(method)}`));
+            }
+            return { file: true };
+        }
+        case 'ECONFIG': {
+            const { found, wanted, validOptions } = err.cause;
+            stderr(`Config Error: ${err.message}`);
+            if (found) {
+                stderr(indent(`Found: ${format(found)}`));
+            }
+            if (wanted) {
+                stderr(indent(`Wanted: ${format(wanted)}`));
+            }
+            if (validOptions) {
+                stderr(indent(`Valid Options: ${format(validOptions)}`));
+            }
+            return {};
         }
     }
 };

package/dist/esm/print-err.js.map

@@ -1 +1 @@
-{"version":3,"file":"print-err.js","sourceRoot":"","sources":["../../src/print-err.ts"],"names":[],"mappings":"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","sourcesContent":["import { isErrorWithCode } from '@vltpkg/error-cause'\nimport type { ErrorWithCode } from '@vltpkg/error-cause'\nimport type { CommandUsage } from './index.ts'\nimport type { InspectOptions } from 'node:util'\nimport { formatWithOptions } from 'node:util'\n\nexport type ErrorFormatOptions = InspectOptions & {\n  maxLines?: number\n}\n\ntype Formatter = (\n  arg: unknown,\n  options?: ErrorFormatOptions,\n) => string\n\nconst trimStack = (err: Error) => {\n  if (err.stack) {\n    const lines = err.stack.trim().split('\\n')\n    if (lines[0] === `${err.name}: ${err.message}`) {\n      lines.shift()\n    }\n    return lines.map(l => l.trim()).join('\\n')\n  }\n}\n\nconst indent = (lines: string, num = 2) =>\n  lines\n    .split('\\n')\n    .map(l => ' '.repeat(num) + l)\n    .join('\\n')\n\nexport const printErr = (\n  err: unknown,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  baseOpts?: ErrorFormatOptions,\n) => {\n  const format: Formatter = (arg: unknown, opts) => {\n    const { maxLines = 200, ...rest } = { ...baseOpts, ...opts }\n    const lines = formatWithOptions(rest, arg).split('\\n')\n    const totalLines = lines.length\n    if (totalLines > maxLines) {\n      lines.length = maxLines\n      lines.push(`... ${totalLines - maxLines} lines hidden ...`)\n    }\n    return lines.join('\\n')\n  }\n\n  // This is an error with a cause, check if it we know about its\n  // code and try to print it. If it did not print then fallback\n  // to the next option.\n  if (isErrorWithCode(err) && print(err, usage, stderr, format)) {\n    return\n  }\n\n  // We have a real but we dont know anything special about its\n  // properties. Just print the standard error properties as best we can.\n  if (err instanceof Error) {\n    stderr(`${err.name}: ${err.message}`)\n    if ('cause' in err) {\n      stderr(`Cause:`)\n      if (err.cause instanceof Error) {\n        stderr(indent(format(err.cause)))\n      } else if (err.cause && typeof err.cause === 'object') {\n        for (const key in err.cause) {\n          stderr(\n            indent(\n              `${key}: ${format((err.cause as Record<string, unknown>)[key])}`,\n            ),\n          )\n        }\n      } else {\n        stderr(indent(format(err.cause)))\n      }\n    }\n    const stack = trimStack(err)\n    if (stack) {\n      stderr(`Stack:`)\n      stderr(indent(format(stack)))\n    }\n    return\n  }\n\n  // We don't know what this is, just print it.\n  stderr(`Unknown Error:`, format(err))\n}\n\nconst print = (\n  err: ErrorWithCode,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  format: Formatter,\n) => {\n  switch (err.cause.code) {\n    case 'EUSAGE': {\n      const { found, validOptions } = err.cause\n      stderr(usage().usage())\n      stderr(`Usage Error: ${err.message}`)\n      if (found) {\n        stderr(indent(`Found: ${format(found)}`))\n      }\n      if (validOptions) {\n        stderr(\n          indent(`Valid options: ${format(validOptions.join(', '))}`),\n        )\n      }\n      return true\n    }\n\n    case 'ERESOLVE': {\n      const { url, from, response, spec } = err.cause\n      stderr(`Resolve Error: ${err.message}`)\n      if (url) {\n        stderr(indent(`While fetching: ${url}`))\n      }\n      if (spec) {\n        stderr(indent(`To satisfy: ${format(spec)}`))\n      }\n      if (from) {\n        stderr(indent(`From: ${format(from)}`))\n      }\n      if (response) {\n        stderr(indent(`Response: ${format(response)}`))\n      }\n      return true\n    }\n  }\n}\n"]}
+{"version":3,"file":"print-err.js","sourceRoot":"","sources":["../../src/print-err.ts"],"names":[],"mappings":"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","sourcesContent":["import { splitDepID } from '@vltpkg/dep-id'\nimport type { Node } from '@vltpkg/graph'\nimport type { ParsedError } from '@vltpkg/output/error'\nimport { parseError } from '@vltpkg/output/error'\nimport { isErrorWithCause, isObject } from '@vltpkg/types'\nimport { XDG } from '@vltpkg/xdg'\nimport { isGraphRunError } from 'graph-run'\nimport { mkdirSync, writeFileSync } from 'node:fs'\nimport { join } from 'node:path'\nimport type { InspectOptions } from 'node:util'\nimport { formatWithOptions } from 'node:util'\nimport type { CommandUsage } from './index.ts'\n\nexport const formatOptions = {\n  depth: Infinity,\n  maxArrayLength: Infinity,\n  maxStringLength: Infinity,\n} as const satisfies InspectOptions\n\nexport type ErrorFormatOptions = InspectOptions & {\n  maxLines?: number\n}\n\nexport type Formatter = (\n  arg: unknown,\n  options?: ErrorFormatOptions,\n) => string\n\nconst isNonEmptyString = (v: unknown): v is string =>\n  !!v && typeof v === 'string'\n\nconst formatURL = (v: unknown, format: Formatter) =>\n  v instanceof URL ? v.toString() : /* c8 ignore next */ format(v)\n\nconst formatArray = (v: unknown, format: Formatter, joiner = ', ') =>\n  Array.isArray(v) ? v.join(joiner) : /* c8 ignore next */ format(v)\n\nexport const indent = (lines: string, num = 2) =>\n  lines\n    .split('\\n')\n    .map(l => ' '.repeat(num) + l)\n    .join('\\n')\n\nconst writeErrorLog = (e: unknown, format: Formatter) => {\n  try {\n    const dir = new XDG('vlt/error-logs').data()\n    const file = join(dir, `error-${process.pid}.log`)\n    mkdirSync(dir, { recursive: true })\n    writeFileSync(\n      file,\n      format(e, {\n        colors: false,\n        maxLines: Infinity,\n      }),\n    )\n    return file\n  } catch {\n    return null\n  }\n}\n\nexport const printErr = (\n  e: unknown,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  baseOpts?: ErrorFormatOptions,\n) => {\n  const format: Formatter = (arg: unknown, opts) => {\n    const { maxLines = 200, ...rest } = {\n      ...formatOptions,\n      ...baseOpts,\n      ...opts,\n    }\n    const lines = formatWithOptions(rest, arg).split('\\n')\n    const totalLines = lines.length\n    if (totalLines > maxLines) {\n      lines.length = maxLines\n      lines.push(`... ${totalLines - maxLines} lines hidden ...`)\n    }\n    return lines.join('\\n')\n  }\n\n  const err = parseError(e)\n  const knownError = printCode(err, usage, stderr, format)\n  const fileWritten =\n    !knownError || knownError.file ? writeErrorLog(e, format) : null\n\n  // We could not write an error log and its not a know error,\n  // so we print the entire formatted value.\n  if (!fileWritten && !knownError) {\n    return stderr(format(e))\n  }\n\n  if (err && !knownError) {\n    stderr(`${err.name}: ${err.message}`)\n  }\n  if (fileWritten) {\n    stderr('')\n    stderr(`Full details written to: ${fileWritten}`)\n  }\n  if (!knownError || knownError.bug) {\n    stderr('')\n    stderr('Open an issue with the full error details at:')\n    stderr(indent('https://github.com/vltpkg/vltpkg/issues/new'))\n  }\n}\n\nconst printCode = (\n  err: ParsedError | null,\n  usage: CommandUsage,\n  stderr: (...a: string[]) => void,\n  format: Formatter,\n): void | { bug?: boolean; file?: boolean } => {\n  if (!err) return\n\n  switch (err.cause?.code) {\n    case 'GRAPHRUN_TRAVERSAL': {\n      if (!isGraphRunError<Node>(err)) break\n      const { node, path, cause } = err.cause\n      stderr(\n        `Graph traversal failure at: ${splitDepID(node.id).join(' ')}`,\n      )\n      if (Array.isArray(path) && path.length) {\n        stderr(indent(`Path: ${path.map(n => n.id).join(',')}`))\n      }\n      if (\n        isErrorWithCause(cause) &&\n        isObject(cause.cause) &&\n        'command' in cause.cause &&\n        'stdout' in cause.cause &&\n        'stderr' in cause.cause &&\n        'status' in cause.cause &&\n        'signal' in cause.cause &&\n        'cwd' in cause.cause\n      ) {\n        const {\n          command,\n          args,\n          cwd,\n          stdout: cmdStdout,\n          stderr: cmdStderr,\n          status,\n          signal,\n        } = cause.cause\n        stderr(`Command: ${command}`)\n        if (args && Array.isArray(args) && args.length) {\n          stderr(\n            `Args: ${args.map(a => JSON.stringify(a)).join(', ')}`,\n          )\n        }\n        stderr(`Cwd: ${cwd}`)\n\n        if (cmdStderr || cmdStdout) {\n          stderr('')\n          if (isNonEmptyString(cmdStderr)) {\n            stderr(cmdStderr)\n          }\n          if (isNonEmptyString(cmdStdout)) {\n            stderr(cmdStdout)\n          }\n          stderr('')\n        }\n\n        if (signal !== null) stderr(`Signal: ${format(signal)}`)\n        if (status !== null) stderr(`Status: ${format(status)}`)\n      }\n      return { file: true }\n    }\n\n    case 'EUSAGE': {\n      const { found, validOptions } = err.cause\n      stderr(usage().usage())\n      stderr(`Usage Error: ${err.message}`)\n      if (found) {\n        stderr(indent(`Found: ${format(found)}`))\n      }\n      if (validOptions) {\n        stderr(\n          indent(\n            `Valid options: ${formatArray(validOptions, format)}`,\n          ),\n        )\n      }\n      return {}\n    }\n\n    case 'ERESOLVE': {\n      const { url, from, response, spec } = err.cause\n      stderr(`Resolve Error: ${err.message}`)\n      if (url) {\n        stderr(indent(`While fetching: ${formatURL(url, format)}`))\n      }\n      if (spec) {\n        stderr(indent(`To satisfy: ${format(spec)}`))\n      }\n      if (from) {\n        stderr(indent(`From: ${format(from)}`))\n      }\n      if (response) {\n        stderr(indent(`Response: ${format(response)}`))\n      }\n      return { file: true }\n    }\n\n    case 'EREQUEST': {\n      const { url, method } = err.cause\n      const { code, syscall } = err.cause.cause ?? {}\n      stderr(`Request Error: ${err.message}`)\n      if (code) {\n        stderr(indent(`Code: ${format(code)}`))\n      }\n      if (syscall) {\n        stderr(indent(`Syscall: ${format(syscall)}`))\n      }\n      if (url) {\n        stderr(indent(`URL: ${formatURL(url, format)}`))\n      }\n      if (method) {\n        stderr(indent(`Method: ${format(method)}`))\n      }\n      return { file: true }\n    }\n\n    case 'ECONFIG': {\n      const { found, wanted, validOptions } = err.cause\n      stderr(`Config Error: ${err.message}`)\n      if (found) {\n        stderr(indent(`Found: ${format(found)}`))\n      }\n      if (wanted) {\n        stderr(indent(`Wanted: ${format(wanted)}`))\n      }\n      if (validOptions) {\n        stderr(indent(`Valid Options: ${format(validOptions)}`))\n      }\n      return {}\n    }\n  }\n}\n"]}

package/dist/esm/query-host-contexts.d.ts

@@ -0,0 +1,16 @@
+import { SecurityArchive } from '@vltpkg/security-archive';
+import type { EdgeLike, NodeLike } from '@vltpkg/types';
+import type { LoadedConfig } from './config/index.ts';
+export type HostContextsMapResult = {
+    initialEdges: EdgeLike[];
+    initialNodes: NodeLike[];
+    edges: EdgeLike[];
+    nodes: NodeLike[];
+    securityArchive: SecurityArchive;
+};
+/**
+ * Creates a Map of host context functions that can be used by the :host
+ * pseudo selector to dynamically load graphs from different sources.
+ */
+export declare const createHostContextsMap: (conf: LoadedConfig) => Promise<Map<string, () => Promise<HostContextsMapResult>>>;
+//# sourceMappingURL=query-host-contexts.d.ts.map

package/dist/esm/query-host-contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-host-contexts.d.ts","sourceRoot":"","sources":["../../src/query-host-contexts.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,EAAE,QAAQ,EAAE,CAAA;IACxB,YAAY,EAAE,QAAQ,EAAE,CAAA;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,eAAe,EAAE,eAAe,CAAA;CACjC,CAAA;AA8CD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,SAC1B,YAAY,KACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAiH3D,CAAA"}

package/dist/esm/query-host-contexts.js

@@ -0,0 +1,135 @@
+import { homedir } from 'node:os';
+import { parse, posix } from 'node:path';
+import { getProjectData, readProjectFolders, reloadConfig, } from '@vltpkg/server';
+import { actual, createVirtualRoot } from '@vltpkg/graph';
+import { SecurityArchive } from '@vltpkg/security-archive';
+import { error } from '@vltpkg/error-cause';
+// In restricted environments (like locked-down Codespaces),
+// homedir() might fail. Fall back to parent directory.
+let foundHome;
+try {
+    foundHome = posix.format(parse(homedir()));
+    /* c8 ignore next 3 */
+}
+catch { }
+const home = foundHome ?? posix.dirname(posix.format(parse(process.cwd())));
+/**
+ * Generates possible project keys for a given folder.
+ */
+const getPossibleProjectKeys = (folder, scurry) => {
+    const relativePath = posix.relative(scurry.cwd.fullpathPosix(), folder.fullpathPosix());
+    const absolutePath = folder.fullpathPosix();
+    const homeRelativePath = posix.relative(scurry.resolvePosix(home), folder.fullpathPosix());
+    const dotRelativeKey = relativePath === '' ? 'file:.' : `file:./${relativePath}`;
+    const relativeKey = `file:${relativePath}`;
+    const absoluteKey = `file:${absolutePath}`;
+    const homeRelativeKey = `file:~/${homeRelativePath}`;
+    const keys = [
+        relativeKey,
+        dotRelativeKey,
+        absoluteKey,
+        homeRelativeKey,
+        `${relativeKey}/`,
+        `${dotRelativeKey}/`,
+        `${absoluteKey}/`,
+        `${homeRelativeKey}/`,
+    ];
+    return new Set(keys);
+};
+/**
+ * Creates a Map of host context functions that can be used by the :host
+ * pseudo selector to dynamically load graphs from different sources.
+ */
+export const createHostContextsMap = async (conf) => {
+    const hostContexts = new Map();
+    // Read all project folders from the configured paths
+    const { scurry } = conf.options;
+    const projectFolders = await readProjectFolders({
+        scurry,
+        userDefinedProjectPaths: conf.options['dashboard-root'] ?? [],
+    });
+    for (const folder of projectFolders) {
+        const retrieveProjectGraph = async () => {
+            const initialEdges = [];
+            const initialNodes = [];
+            const config = await reloadConfig(folder.fullpath());
+            // load each individual graph
+            const graph = actual.load({
+                ...config.options,
+                projectRoot: folder.fullpath(),
+                skipLoadingNodesOnModifiersChange: false,
+            });
+            initialEdges.push(...graph.edges);
+            initialNodes.push(...graph.nodes.values());
+            // Initialize security archive with all loaded nodes
+            const securityArchive = await SecurityArchive.start({
+                nodes: initialNodes,
+            });
+            return {
+                initialEdges,
+                initialNodes,
+                edges: [],
+                nodes: [graph.mainImporter],
+                securityArchive,
+            };
+        };
+        // add multiple keys for each project folder
+        for (const path of getPossibleProjectKeys(folder, scurry)) {
+            if (!hostContexts.has(path)) {
+                hostContexts.set(path, retrieveProjectGraph);
+            }
+        }
+    }
+    // Define local context - loads graphs from all projects in user's project paths
+    hostContexts.set('local', async () => {
+        // Load graphs from each project folder
+        const initialEdges = [];
+        const initialNodes = [];
+        const mainImporters = [];
+        for (const folder of projectFolders) {
+            try {
+                const config = await reloadConfig(folder.fullpath());
+                const projectInfo = getProjectData({
+                    packageJson: config.options.packageJson,
+                    scurry: config.options.scurry,
+                }, folder);
+                // only include projects that are vlt-installed
+                if (!projectInfo.vltInstalled) {
+                    continue;
+                }
+                // load each individual graph
+                const graph = actual.load({
+                    ...config.options,
+                    projectRoot: folder.fullpath(),
+                    skipLoadingNodesOnModifiersChange: false,
+                });
+                initialEdges.push(...graph.edges);
+                initialNodes.push(...graph.nodes.values());
+                mainImporters.push(graph.mainImporter);
+            }
+            catch (_error) {
+                // Skip projects that fail to load
+                // This might happen for projects without proper package.json
+                // or other loading issues
+                continue;
+            }
+        }
+        // Initialize security archive with all loaded nodes
+        const securityArchive = await SecurityArchive.start({
+            nodes: initialNodes,
+        });
+        const virtualRoot = createVirtualRoot('local', conf.options, mainImporters);
+        if (!virtualRoot) {
+            throw error('Failed to create virtual root for local context');
+        }
+        return {
+            initialEdges,
+            initialNodes,
+            edges: [],
+            nodes: [virtualRoot],
+            securityArchive,
+        };
+    });
+    return hostContexts;
+};
+//# sourceMappingURL=query-host-contexts.js.map

package/dist/esm/query-host-contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-host-contexts.js","sourceRoot":"","sources":["../../src/query-host-contexts.ts"],"names":[],"mappings":"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","sourcesContent":["import { homedir } from 'node:os'\nimport { parse, posix } from 'node:path'\nimport {\n  getProjectData,\n  readProjectFolders,\n  reloadConfig,\n} from '@vltpkg/server'\nimport { actual, createVirtualRoot } from '@vltpkg/graph'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport { error } from '@vltpkg/error-cause'\nimport type { PathBase, PathScurry } from 'path-scurry'\nimport type { EdgeLike, NodeLike } from '@vltpkg/types'\nimport type { LoadedConfig } from './config/index.ts'\n\nexport type HostContextsMapResult = {\n  initialEdges: EdgeLike[]\n  initialNodes: NodeLike[]\n  edges: EdgeLike[]\n  nodes: NodeLike[]\n  securityArchive: SecurityArchive\n}\n\n// In restricted environments (like locked-down Codespaces),\n// homedir() might fail. Fall back to parent directory.\nlet foundHome\ntry {\n  foundHome = posix.format(parse(homedir()))\n  /* c8 ignore next 3 */\n} catch {}\nconst home =\n  foundHome ?? posix.dirname(posix.format(parse(process.cwd())))\n\n/**\n * Generates possible project keys for a given folder.\n */\nconst getPossibleProjectKeys = (\n  folder: PathBase,\n  scurry: PathScurry,\n): Set<string> => {\n  const relativePath = posix.relative(\n    scurry.cwd.fullpathPosix(),\n    folder.fullpathPosix(),\n  )\n  const absolutePath = folder.fullpathPosix()\n  const homeRelativePath = posix.relative(\n    scurry.resolvePosix(home),\n    folder.fullpathPosix(),\n  )\n  const dotRelativeKey =\n    relativePath === '' ? 'file:.' : `file:./${relativePath}`\n  const relativeKey = `file:${relativePath}`\n  const absoluteKey = `file:${absolutePath}`\n  const homeRelativeKey = `file:~/${homeRelativePath}`\n  const keys = [\n    relativeKey,\n    dotRelativeKey,\n    absoluteKey,\n    homeRelativeKey,\n    `${relativeKey}/`,\n    `${dotRelativeKey}/`,\n    `${absoluteKey}/`,\n    `${homeRelativeKey}/`,\n  ]\n  return new Set(keys)\n}\n\n/**\n * Creates a Map of host context functions that can be used by the :host\n * pseudo selector to dynamically load graphs from different sources.\n */\nexport const createHostContextsMap = async (\n  conf: LoadedConfig,\n): Promise<Map<string, () => Promise<HostContextsMapResult>>> => {\n  const hostContexts = new Map<\n    string,\n    () => Promise<HostContextsMapResult>\n  >()\n  // Read all project folders from the configured paths\n  const { scurry } = conf.options\n  const projectFolders = await readProjectFolders({\n    scurry,\n    userDefinedProjectPaths: conf.options['dashboard-root'] ?? [],\n  })\n\n  for (const folder of projectFolders) {\n    const retrieveProjectGraph = async () => {\n      const initialEdges: EdgeLike[] = []\n      const initialNodes: NodeLike[] = []\n      const config = await reloadConfig(folder.fullpath())\n\n      // load each individual graph\n      const graph = actual.load({\n        ...config.options,\n        projectRoot: folder.fullpath(),\n        skipLoadingNodesOnModifiersChange: false,\n      })\n      initialEdges.push(...graph.edges)\n      initialNodes.push(...graph.nodes.values())\n\n      // Initialize security archive with all loaded nodes\n      const securityArchive = await SecurityArchive.start({\n        nodes: initialNodes,\n      })\n\n      return {\n        initialEdges,\n        initialNodes,\n        edges: [],\n        nodes: [graph.mainImporter],\n        securityArchive,\n      }\n    }\n\n    // add multiple keys for each project folder\n    for (const path of getPossibleProjectKeys(folder, scurry)) {\n      if (!hostContexts.has(path)) {\n        hostContexts.set(path, retrieveProjectGraph)\n      }\n    }\n  }\n\n  // Define local context - loads graphs from all projects in user's project paths\n  hostContexts.set('local', async () => {\n    // Load graphs from each project folder\n    const initialEdges: EdgeLike[] = []\n    const initialNodes: NodeLike[] = []\n    const mainImporters: NodeLike[] = []\n    for (const folder of projectFolders) {\n      try {\n        const config = await reloadConfig(folder.fullpath())\n        const projectInfo = getProjectData(\n          {\n            packageJson: config.options.packageJson,\n            scurry: config.options.scurry,\n          },\n          folder,\n        )\n\n        // only include projects that are vlt-installed\n        if (!projectInfo.vltInstalled) {\n          continue\n        }\n\n        // load each individual graph\n        const graph = actual.load({\n          ...config.options,\n          projectRoot: folder.fullpath(),\n          skipLoadingNodesOnModifiersChange: false,\n        })\n        initialEdges.push(...graph.edges)\n        initialNodes.push(...graph.nodes.values())\n        mainImporters.push(graph.mainImporter)\n      } catch (_error) {\n        // Skip projects that fail to load\n        // This might happen for projects without proper package.json\n        // or other loading issues\n        continue\n      }\n    }\n\n    // Initialize security archive with all loaded nodes\n    const securityArchive = await SecurityArchive.start({\n      nodes: initialNodes,\n    })\n\n    const virtualRoot = createVirtualRoot(\n      'local',\n      conf.options,\n      mainImporters,\n    )\n\n    if (!virtualRoot) {\n      throw error('Failed to create virtual root for local context')\n    }\n\n    return {\n      initialEdges,\n      initialNodes,\n      edges: [],\n      nodes: [virtualRoot],\n      securityArchive,\n    }\n  })\n\n  return hostContexts\n}\n"]}

package/dist/esm/start-gui.d.ts

@@ -1,6 +1,7 @@
 import type { PathScurry } from 'path-scurry';
 import type { LoadedConfig } from './config/index.ts';
 export declare const getDefaultStartingRoute: (options: {
+    queryString?: string;
     startingRoute?: string;
     projectRoot: string;
     scurry: PathScurry;

package/dist/esm/start-gui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-gui.d.ts","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,eAAO,MAAM,uBAAuB,YAAmB;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;CACnB,oBAOA,CAAA;AAaD,eAAO,MAAM,QAAQ,SACb,YAAY,kBACF,MAAM,gDAuBvB,CAAA"}
+{"version":3,"file":"start-gui.d.ts","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,eAAO,MAAM,uBAAuB,YAAmB;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;CACnB,oBAcA,CAAA;AAaD,eAAO,MAAM,QAAQ,SACb,YAAY,kBACF,MAAM,gDA0CvB,CAAA"}

package/dist/esm/start-gui.js

@@ -1,15 +1,17 @@
+import { resolve } from 'node:path';
+import LZString from 'lz-string';
 import { createServer } from '@vltpkg/server';
 import { urlOpen } from '@vltpkg/url-open';
 import { stdout } from "./output.js";
-import { resolve } from 'node:path';
 export const getDefaultStartingRoute = async (options) => {
-    const { startingRoute, projectRoot, scurry } = options;
+    const { queryString = ':root', startingRoute, projectRoot, scurry, } = options;
     if (startingRoute)
         return startingRoute;
     const stat = await scurry.lstat(`${projectRoot}/package.json`);
-    return stat?.isFile() && !stat.isSymbolicLink() ?
-        `/explore?query=${encodeURIComponent(':root')}`
-        : '/';
+    const res = stat?.isFile() && !stat.isSymbolicLink() ?
+        `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`
+        : '/dashboard';
+    return res;
 };
 const getAssetsDir = () => {
     /* c8 ignore start */
@@ -19,18 +21,36 @@ const getAssetsDir = () => {
     /* c8 ignore stop */
 };
 export const startGUI = async (conf, startingRoute) => {
+    /* c8 ignore start */
+    const allowScripts = conf.get('allow-scripts') ?
+        String(conf.get('allow-scripts'))
+        : ':not(*)';
+    /* c8 ignore stop */
     const server = createServer({
         ...conf.options,
         assetsDir: getAssetsDir(),
+        loadedConfig: conf,
+        allowScripts,
     });
-    server.on('needConfigUpdate', dir => {
+    server.on('needConfigUpdate', async (dir) => {
         conf.resetOptions(dir);
-        server.updateOptions(conf.options);
+        const listeningServer = server;
+        listeningServer.updateOptions({ ...conf.options, allowScripts });
+        await conf
+            .reloadFromDisk()
+            .then(() => {
+            listeningServer.updateOptions({
+                ...conf.options,
+                allowScripts,
+            });
+        })
+            .catch(() => { });
     });
     const { projectRoot, scurry } = conf.options;
     await server.start();
-    stdout(`⚡️ vlt GUI running at ${server.address()}`);
+    stdout(`⚡️ vlt UI running at ${server.address()}`);
     void urlOpen(server.address(await getDefaultStartingRoute({
+        queryString: conf.values.target,
         startingRoute,
         projectRoot,
         scurry,

package/dist/esm/start-gui.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-gui.js","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,OAI7C,EAAE,EAAE;IACH,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACtD,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,eAAe,CAAC,CAAA;IAC9D,OAAO,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7C,kBAAkB,kBAAkB,CAAC,OAAO,CAAC,EAAE;QACjD,CAAC,CAAC,GAAG,CAAA;AACT,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,GAAG,EAAE;IACxB,qBAAqB;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;QAC9C,OAAO,OAAO,CACZ,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAC1C,CAAA;IACH,CAAC;IACD,oBAAoB;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,IAAkB,EAClB,aAAsB,EACtB,EAAE;IACF,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG,IAAI,CAAC,OAAO;QACf,SAAS,EAAE,YAAY,EAAE;KAC1B,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,GAAG,CAAC,EAAE;QAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CACrB;QAAC,MAA6B,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IACF,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACpB,MAAM,CAAC,yBAAyB,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACnD,KAAK,OAAO,CACV,MAAM,CAAC,OAAO,CACZ,MAAM,uBAAuB,CAAC;QAC5B,aAAa;QACb,WAAW;QACX,MAAM;KACP,CAAC,CACH,CACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["import type { VltServerListening } from '@vltpkg/server'\nimport { createServer } from '@vltpkg/server'\nimport { urlOpen } from '@vltpkg/url-open'\nimport type { PathScurry } from 'path-scurry'\nimport type { LoadedConfig } from './config/index.ts'\nimport { stdout } from './output.ts'\nimport { resolve } from 'node:path'\n\nexport const getDefaultStartingRoute = async (options: {\n  startingRoute?: string\n  projectRoot: string\n  scurry: PathScurry\n}) => {\n  const { startingRoute, projectRoot, scurry } = options\n  if (startingRoute) return startingRoute\n  const stat = await scurry.lstat(`${projectRoot}/package.json`)\n  return stat?.isFile() && !stat.isSymbolicLink() ?\n      `/explore?query=${encodeURIComponent(':root')}`\n    : '/'\n}\n\nconst getAssetsDir = () => {\n  /* c8 ignore start */\n  if (process.env.__VLT_INTERNAL_GUI_ASSETS_DIR) {\n    return resolve(\n      import.meta.dirname,\n      process.env.__VLT_INTERNAL_GUI_ASSETS_DIR,\n    )\n  }\n  /* c8 ignore stop */\n}\n\nexport const startGUI = async (\n  conf: LoadedConfig,\n  startingRoute?: string,\n) => {\n  const server = createServer({\n    ...conf.options,\n    assetsDir: getAssetsDir(),\n  })\n  server.on('needConfigUpdate', dir => {\n    conf.resetOptions(dir)\n    ;(server as VltServerListening).updateOptions(conf.options)\n  })\n  const { projectRoot, scurry } = conf.options\n  await server.start()\n  stdout(`⚡️ vlt GUI running at ${server.address()}`)\n  void urlOpen(\n    server.address(\n      await getDefaultStartingRoute({\n        startingRoute,\n        projectRoot,\n        scurry,\n      }),\n    ),\n  )\n  return server\n}\n"]}
+{"version":3,"file":"start-gui.js","sourceRoot":"","sources":["../../src/start-gui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,OAK7C,EAAE,EAAE;IACH,MAAM,EACJ,WAAW,GAAG,OAAO,EACrB,aAAa,EACb,WAAW,EACX,MAAM,GACP,GAAG,OAAO,CAAA;IACX,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,eAAe,CAAC,CAAA;IAC9D,MAAM,GAAG,GACP,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACxC,YAAY,QAAQ,CAAC,6BAA6B,CAAC,WAAW,CAAC,WAAW;QAC5E,CAAC,CAAC,YAAY,CAAA;IAChB,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,GAAG,EAAE;IACxB,qBAAqB;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;QAC9C,OAAO,OAAO,CACZ,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAC1C,CAAA;IACH,CAAC;IACD,oBAAoB;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,IAAkB,EAClB,aAAsB,EACtB,EAAE;IACF,qBAAqB;IACrB,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC,CAAC,SAAS,CAAA;IACb,oBAAoB;IACpB,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG,IAAI,CAAC,OAAO;QACf,SAAS,EAAE,YAAY,EAAE;QACzB,YAAY,EAAE,IAAI;QAClB,YAAY;KACb,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE;QACxC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;QACtB,MAAM,eAAe,GAAG,MAA4B,CAAA;QACpD,eAAe,CAAC,aAAa,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAA;QAChE,MAAM,IAAI;aACP,cAAc,EAAE;aAChB,IAAI,CAAC,GAAG,EAAE;YACT,eAAe,CAAC,aAAa,CAAC;gBAC5B,GAAG,IAAI,CAAC,OAAO;gBACf,YAAY;aACb,CAAC,CAAA;QACJ,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;IACF,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACpB,MAAM,CAAC,wBAAwB,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAClD,KAAK,OAAO,CACV,MAAM,CAAC,OAAO,CACZ,MAAM,uBAAuB,CAAC;QAC5B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QAC/B,aAAa;QACb,WAAW;QACX,MAAM;KACP,CAAC,CACH,CACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["import { resolve } from 'node:path'\nimport LZString from 'lz-string'\nimport { createServer } from '@vltpkg/server'\nimport { urlOpen } from '@vltpkg/url-open'\nimport { stdout } from './output.ts'\nimport type { PathScurry } from 'path-scurry'\nimport type { LoadedConfig } from './config/index.ts'\nimport type { VltServerListening } from '@vltpkg/server'\n\nexport const getDefaultStartingRoute = async (options: {\n  queryString?: string\n  startingRoute?: string\n  projectRoot: string\n  scurry: PathScurry\n}) => {\n  const {\n    queryString = ':root',\n    startingRoute,\n    projectRoot,\n    scurry,\n  } = options\n  if (startingRoute) return startingRoute\n  const stat = await scurry.lstat(`${projectRoot}/package.json`)\n  const res =\n    stat?.isFile() && !stat.isSymbolicLink() ?\n      `/explore/${LZString.compressToEncodedURIComponent(queryString)}/overview`\n    : '/dashboard'\n  return res\n}\n\nconst getAssetsDir = () => {\n  /* c8 ignore start */\n  if (process.env.__VLT_INTERNAL_GUI_ASSETS_DIR) {\n    return resolve(\n      import.meta.dirname,\n      process.env.__VLT_INTERNAL_GUI_ASSETS_DIR,\n    )\n  }\n  /* c8 ignore stop */\n}\n\nexport const startGUI = async (\n  conf: LoadedConfig,\n  startingRoute?: string,\n) => {\n  /* c8 ignore start */\n  const allowScripts =\n    conf.get('allow-scripts') ?\n      String(conf.get('allow-scripts'))\n    : ':not(*)'\n  /* c8 ignore stop */\n  const server = createServer({\n    ...conf.options,\n    assetsDir: getAssetsDir(),\n    loadedConfig: conf,\n    allowScripts,\n  })\n  server.on('needConfigUpdate', async dir => {\n    conf.resetOptions(dir)\n    const listeningServer = server as VltServerListening\n    listeningServer.updateOptions({ ...conf.options, allowScripts })\n    await conf\n      .reloadFromDisk()\n      .then(() => {\n        listeningServer.updateOptions({\n          ...conf.options,\n          allowScripts,\n        })\n      })\n      .catch(() => {})\n  })\n  const { projectRoot, scurry } = conf.options\n  await server.start()\n  stdout(`⚡️ vlt UI running at ${server.address()}`)\n  void urlOpen(\n    server.address(\n      await getDefaultStartingRoute({\n        queryString: conf.values.target,\n        startingRoute,\n        projectRoot,\n        scurry,\n      }),\n    ),\n  )\n  return server\n}\n"]}

package/dist/esm/view.d.ts

@@ -1,7 +1,6 @@
-import type { ChalkInstance } from 'chalk';
 import type { LoadedConfig } from './config/index.ts';
 export type ViewOptions = {
-    colors?: ChalkInstance;
+    colors?: boolean;
 };
 /**
  * The base class for all View classes
@@ -21,7 +20,7 @@ export declare class ViewClass<T = unknown> {
     start(): void;
     done(_result: T, _opts: {
         time: number;
-    }): unknown;
+    }): Promise<unknown>;
     error(_err: unknown): void;
 }
 export type ViewFn<T = unknown> = (result: T, options: ViewOptions, conf: LoadedConfig) => unknown;

package/dist/esm/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,aAAa,CAAA;CAAE,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;gBAER,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;IAQtD,KAAK;IACL,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAGlD,KAAK,CAAC,IAAI,EAAE,OAAO;CACpB;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,OAAO,IAAI,CAChC,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,YAAY,KACf,OAAO,CAAA;AAEZ,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,CAAA;AAE/D,eAAO,MAAM,WAAW,GAAI,CAAC,kBACrB,IAAI,CAAC,CAAC,CAAC,KACZ,IAAI,IAAI,OAAO,SAAS,CAAC,CAAC,CAGQ,CAAA;AAErC,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAChC,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;gBAER,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;IAQtD,KAAK;IACC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAGjE,KAAK,CAAC,IAAI,EAAE,OAAO;CACpB;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,OAAO,IAAI,CAChC,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,YAAY,KACf,OAAO,CAAA;AAEZ,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,CAAA;AAE/D,eAAO,MAAM,WAAW,GAAI,CAAC,kBACrB,IAAI,CAAC,CAAC,CAAC,KACZ,IAAI,IAAI,OAAO,SAAS,CAAC,CAAC,CAGQ,CAAA;AAErC,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/esm/view.js

@@ -20,7 +20,7 @@ export class ViewClass {
     // run the command", for example to have the gui just open a web browser
     // to the page relevant to a given thing, rather than computing it twice
     start() { }
-    done(_result, _opts) {
+    async done(_result, _opts) {
         return;
     }
     error(_err) { }

package/dist/esm/view.js.map

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAS;IACpB,OAAO,CAAa;IACpB,MAAM,CAAc;IAEpB,YAAY,OAAoB,EAAE,MAAoB;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,oEAAoE;IACpE,wEAAwE;IACxE,wEAAwE;IACxE,KAAK,KAAI,CAAC;IACV,IAAI,CAAC,OAAU,EAAE,KAAuB;QACtC,OAAM;IACR,CAAC;IACD,KAAK,CAAC,IAAa,IAAG,CAAC;CACxB;AAUD,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAAa,EACgB,EAAE,CAC/B,OAAO,IAAI,KAAK,UAAU;IAC1B,WAAW,IAAI,IAAI;IACnB,IAAI,CAAC,SAAS,YAAY,SAAS,CAAA","sourcesContent":["import type { ChalkInstance } from 'chalk'\nimport type { LoadedConfig } from './config/index.ts'\n\nexport type ViewOptions = { colors?: ChalkInstance }\n\n/**\n * The base class for all View classes\n *\n * Do not override the constructor, just provide start/done/error methods.\n *\n * These classes should be used as one or more of the exported views for\n * commands that need to know when the processing starts, handle errors in\n * various ways, etc. Fancy stuff.\n *\n * For simple use cases, usually better to create a {@link ViewFn} instead.\n */\nexport class ViewClass<T = unknown> {\n  options: ViewOptions\n  config: LoadedConfig\n\n  constructor(options: ViewOptions, config: LoadedConfig) {\n    this.options = options\n    this.config = config\n  }\n\n  // TODO: maybe have start() return a flag to say \"i got this, do not\n  // run the command\", for example to have the gui just open a web browser\n  // to the page relevant to a given thing, rather than computing it twice\n  start() {}\n  done(_result: T, _opts: { time: number }): unknown {\n    return\n  }\n  error(_err: unknown) {}\n}\n\nexport type ViewFn<T = unknown> = (\n  result: T,\n  options: ViewOptions,\n  conf: LoadedConfig,\n) => unknown\n\nexport type View<T = unknown> = ViewFn<T> | typeof ViewClass<T>\n\nexport const isViewClass = <T = unknown>(\n  view: View<T>,\n): view is typeof ViewClass<T> =>\n  typeof view === 'function' &&\n  'prototype' in view &&\n  view.prototype instanceof ViewClass\n\nexport type Views<T = unknown> = View<T> | Record<string, View<T>>\n"]}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/view.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAS;IACpB,OAAO,CAAa;IACpB,MAAM,CAAc;IAEpB,YAAY,OAAoB,EAAE,MAAoB;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,oEAAoE;IACpE,wEAAwE;IACxE,wEAAwE;IACxE,KAAK,KAAI,CAAC;IACV,KAAK,CAAC,IAAI,CAAC,OAAU,EAAE,KAAuB;QAC5C,OAAM;IACR,CAAC;IACD,KAAK,CAAC,IAAa,IAAG,CAAC;CACxB;AAUD,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAAa,EACgB,EAAE,CAC/B,OAAO,IAAI,KAAK,UAAU;IAC1B,WAAW,IAAI,IAAI;IACnB,IAAI,CAAC,SAAS,YAAY,SAAS,CAAA","sourcesContent":["import type { LoadedConfig } from './config/index.ts'\n\nexport type ViewOptions = { colors?: boolean }\n\n/**\n * The base class for all View classes\n *\n * Do not override the constructor, just provide start/done/error methods.\n *\n * These classes should be used as one or more of the exported views for\n * commands that need to know when the processing starts, handle errors in\n * various ways, etc. Fancy stuff.\n *\n * For simple use cases, usually better to create a {@link ViewFn} instead.\n */\nexport class ViewClass<T = unknown> {\n  options: ViewOptions\n  config: LoadedConfig\n\n  constructor(options: ViewOptions, config: LoadedConfig) {\n    this.options = options\n    this.config = config\n  }\n\n  // TODO: maybe have start() return a flag to say \"i got this, do not\n  // run the command\", for example to have the gui just open a web browser\n  // to the page relevant to a given thing, rather than computing it twice\n  start() {}\n  async done(_result: T, _opts: { time: number }): Promise<unknown> {\n    return\n  }\n  error(_err: unknown) {}\n}\n\nexport type ViewFn<T = unknown> = (\n  result: T,\n  options: ViewOptions,\n  conf: LoadedConfig,\n) => unknown\n\nexport type View<T = unknown> = ViewFn<T> | typeof ViewClass<T>\n\nexport const isViewClass = <T = unknown>(\n  view: View<T>,\n): view is typeof ViewClass<T> =>\n  typeof view === 'function' &&\n  'prototype' in view &&\n  view.prototype instanceof ViewClass\n\nexport type Views<T = unknown> = View<T> | Record<string, View<T>>\n"]}