@fnndsc/brasa 0.15.0 → 0.16.0

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from './core/sink.js';
 export * from './core/progress.js';
 export * from './core/surface.js';
 export * from './core/promptContext.js';
+export * from './core/warmupFailures.js';
 export * from './core/connect.js';
 export * from './core/question.js';
 export * from './core/elevation.js';

package/dist/index.js

@@ -17,6 +17,7 @@ export * from './core/sink.js';
 export * from './core/progress.js';
 export * from './core/surface.js';
 export * from './core/promptContext.js';
+export * from './core/warmupFailures.js';
 export * from './core/connect.js';
 export * from './core/question.js';
 export * from './core/elevation.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,kBAAkB,CAAC;AACjC,iEAAiE;AACjE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,kBAAkB,CAAC;AACjC,iEAAiE;AACjE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}

package/dist/lib/announceIndent.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file Where a boot step's label starts.
+ *
+ * A step is announced while it runs and again when it finishes. Both lines
+ * describe the same step, so their labels must begin in the same column;
+ * otherwise the readout jitters as each step settles.
+ *
+ * The finished line is rendered by the host as a status tag padded to a
+ * fixed width, a space, then the label. The running line has to reproduce
+ * that column without knowing the tag. An animated spinner draws a frame
+ * and a space of its own and owes only the remainder; a plain log line
+ * draws nothing and owes the whole width.
+ *
+ * Kept free of imports so it can be unit tested: the wider engine graph
+ * cannot be loaded under jest.
+ *
+ * @module
+ */
+/** Columns an animated spinner draws for itself: one glyph and one space. */
+export declare const SPINNER_GLYPH_WIDTH: number;
+/**
+ * Spaces a running announcement must emit before its label.
+ *
+ * @param statusWidth - Width of the host's status-tag column.
+ * @param animated - Whether a spinner glyph precedes the text.
+ * @returns Leading spaces, never negative.
+ */
+export declare function announceIndent_get(statusWidth: number, animated: boolean): number;

package/dist/lib/announceIndent.js

@@ -0,0 +1,32 @@
+/**
+ * @file Where a boot step's label starts.
+ *
+ * A step is announced while it runs and again when it finishes. Both lines
+ * describe the same step, so their labels must begin in the same column;
+ * otherwise the readout jitters as each step settles.
+ *
+ * The finished line is rendered by the host as a status tag padded to a
+ * fixed width, a space, then the label. The running line has to reproduce
+ * that column without knowing the tag. An animated spinner draws a frame
+ * and a space of its own and owes only the remainder; a plain log line
+ * draws nothing and owes the whole width.
+ *
+ * Kept free of imports so it can be unit tested: the wider engine graph
+ * cannot be loaded under jest.
+ *
+ * @module
+ */
+/** Columns an animated spinner draws for itself: one glyph and one space. */
+export const SPINNER_GLYPH_WIDTH = 2;
+/**
+ * Spaces a running announcement must emit before its label.
+ *
+ * @param statusWidth - Width of the host's status-tag column.
+ * @param animated - Whether a spinner glyph precedes the text.
+ * @returns Leading spaces, never negative.
+ */
+export function announceIndent_get(statusWidth, animated) {
+    const target = statusWidth + 1;
+    return Math.max(target - (animated ? SPINNER_GLYPH_WIDTH : 0), 0);
+}
+//# sourceMappingURL=announceIndent.js.map

package/dist/lib/announceIndent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announceIndent.js","sourceRoot":"","sources":["../../src/lib/announceIndent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAW,CAAC,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,QAAiB;IACvE,MAAM,MAAM,GAAW,WAAW,GAAG,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/lib/prefetch.d.ts

@@ -21,5 +21,7 @@ export declare function prefetch_path(target: string): Promise<PrefetchResult>;
  * @param message      - Descriptive message shown next to the label.
  * @param isInteractive - Whether the session is interactive (controls spinner vs plain log).
  * @param action       - Async work to run; returns a PrefetchResult.
+ * @param statusWidth  - Width of the host's status-tag column, so a running
+ *   row's label lines up with the finished row that replaces it.
  */
-export declare function prefetch_withSpinner(label: string, message: string, isInteractive: boolean, action: () => Promise<PrefetchResult>): Promise<PrefetchResult>;
+export declare function prefetch_withSpinner(label: string, message: string, isInteractive: boolean, action: () => Promise<PrefetchResult>, statusWidth?: number): Promise<PrefetchResult>;

package/dist/lib/prefetch.js

@@ -10,6 +10,14 @@ import { errorStack } from '@fnndsc/cumin';
 import { vfs } from './vfs/vfs.js';
 import { spinner } from './spinner.js';
 import { error_stripDebugPrefix } from '../builtins/index.js';
+import { announceIndent_get } from './announceIndent.js';
+/**
+ * Status-tag column assumed when a host does not declare its own.
+ *
+ * Hosts that render a status tag before the label pass their real width,
+ * so the spinner and the finished row agree on where the label starts.
+ */
+const DEFAULT_STATUS_WIDTH = 7;
 /**
  * Prefetch a VFS path into the list cache.
  *
@@ -37,14 +45,19 @@ export async function prefetch_path(target) {
  * @param message      - Descriptive message shown next to the label.
  * @param isInteractive - Whether the session is interactive (controls spinner vs plain log).
  * @param action       - Async work to run; returns a PrefetchResult.
+ * @param statusWidth  - Width of the host's status-tag column, so a running
+ *   row's label lines up with the finished row that replaces it.
  */
-export async function prefetch_withSpinner(label, message, isInteractive, action) {
+export async function prefetch_withSpinner(label, message, isInteractive, action, statusWidth = DEFAULT_STATUS_WIDTH) {
     const paddedLabel = label.padEnd(12);
-    // Spinner adds its own glyph and a following space. Pad so the label column
-    // aligns with the fixed-width status logs (e.g., "[ OK ] " = 7 chars).
-    const spinnerPrefix = ' '.repeat(5); // 1 glyph + 1 space + 5 = 7
-    const spinnerMessage = `${spinnerPrefix}${paddedLabel} ${message}`;
     const showSpinner = isInteractive && process.stdout.isTTY;
+    // A running row and the finished row that replaces it describe the same
+    // step, so their labels must start in the same column. The host writes
+    // its status tag then a space, which is the column to match. An animated
+    // spinner already writes a glyph and a space of its own and owes only the
+    // remainder; a plain log line writes nothing and owes the whole width.
+    const indent = announceIndent_get(statusWidth, showSpinner);
+    const spinnerMessage = `${' '.repeat(indent)}${paddedLabel} ${message}`;
     if (showSpinner) {
         spinner.start(spinnerMessage, true);
     }

package/dist/lib/prefetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"prefetch.js","sourceRoot":"","sources":["../../src/lib/prefetch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAY9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClD,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,uBAAuB,MAAM,EAAE,EAAE,CAAC;IAC7G,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAW,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAa,EACb,OAAe,EACf,aAAsB,EACtB,MAAqC;IAErC,MAAM,WAAW,GAAW,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,uEAAuE;IACvE,MAAM,aAAa,GAAW,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B;IACzE,MAAM,cAAc,GAAW,GAAG,aAAa,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAY,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAEnE,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"prefetch.js","sourceRoot":"","sources":["../../src/lib/prefetch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,oBAAoB,GAAW,CAAC,CAAC;AAYvC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClD,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,uBAAuB,MAAM,EAAE,EAAE,CAAC;IAC7G,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAW,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAa,EACb,OAAe,EACf,aAAsB,EACtB,MAAqC,EACrC,cAAsB,oBAAoB;IAE1C,MAAM,WAAW,GAAW,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAY,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACnE,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,MAAM,GAAW,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACpE,MAAM,cAAc,GAAW,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;IAEhF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fnndsc/brasa",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "BRASA Runs Abstracted Shell Actions - the hostable ChRIS shell engine (kernel)",
   "repository": {
     "type": "git",
@@ -44,8 +44,8 @@
   "license": "MIT",
   "dependencies": {
     "@fnndsc/chili": "^3.6.5",
-    "@fnndsc/cumin": "^3.16.0",
-    "@fnndsc/salsa": "^3.11.0",
+    "@fnndsc/cumin": "^3.17.0",
+    "@fnndsc/salsa": "^3.12.1",
     "chalk": "^4.1.2",
     "cli-highlight": "^2.1.11",
     "js-yaml": "^4.1.0",