@packtory/cli 0.0.8 → 0.0.9

package/command-line-interface/spinner-shared-state.js

@@ -0,0 +1,167 @@
+const headerByteLength = 16;
+const slotByteLength = 384;
+const labelByteLength = 64;
+const messageByteLength = 256;
+const slotStateOffset = 4;
+const slotLabelLengthOffset = 8;
+const slotMessageLengthOffset = 10;
+const slotLabelOffset = 16;
+const slotMessageOffset = slotLabelOffset + labelByteLength;
+const headerControlIndex = 0;
+const headerColumnsIndex = 1;
+const headerIntervalIndex = 2;
+const slotGenerationIndex = 0;
+const controlShutdownValue = 1;
+const controlIdleValue = 0;
+const maximumReadSlotAttempts = 1024;
+const slotStateEmpty = 0;
+const slotStateRunning = 1;
+const slotStateSucceeded = 2;
+const slotStateFailed = 3;
+const slotStateCanceled = 4;
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder();
+const stateToByteMap = {
+    empty: slotStateEmpty,
+    running: slotStateRunning,
+    succeeded: slotStateSucceeded,
+    failed: slotStateFailed,
+    canceled: slotStateCanceled
+};
+const byteToStateMap = {
+    [slotStateEmpty]: 'empty',
+    [slotStateRunning]: 'running',
+    [slotStateSucceeded]: 'succeeded',
+    [slotStateFailed]: 'failed',
+    [slotStateCanceled]: 'canceled'
+};
+export function createSpinnerSharedLayout(slotCount) {
+    return {
+        bufferByteLength: headerByteLength + slotCount * slotByteLength,
+        slotCount,
+        slotByteLength,
+        headerByteLength
+    };
+}
+function stateToByte(state) {
+    return stateToByteMap[state];
+}
+function byteToState(byte) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- writers always go through stateToByteMap so the byte is one of the known state values
+    return byteToStateMap[byte];
+}
+const labelSlice = {
+    contentOffset: slotLabelOffset,
+    contentCapacity: labelByteLength,
+    lengthOffset: slotLabelLengthOffset
+};
+const messageSlice = {
+    contentOffset: slotMessageOffset,
+    contentCapacity: messageByteLength,
+    lengthOffset: slotMessageLengthOffset
+};
+function createViews(buffer, layout) {
+    const headerInt32 = new Int32Array(buffer);
+    const headerUint32 = new Uint32Array(buffer);
+    const slotOffset = (slotIndex) => {
+        return layout.headerByteLength + slotIndex * layout.slotByteLength;
+    };
+    return {
+        headerInt32,
+        headerUint32,
+        slotInt32: (slotIndex) => {
+            return new Int32Array(buffer, slotOffset(slotIndex), 1);
+        },
+        slotBytes: (slotIndex) => {
+            return new Uint8Array(buffer, slotOffset(slotIndex), layout.slotByteLength);
+        },
+        slotData: (slotIndex) => {
+            return new DataView(buffer, slotOffset(slotIndex), layout.slotByteLength);
+        }
+    };
+}
+function writeStringIntoSlot(views, slotIndex, slice, value) {
+    const target = views
+        .slotBytes(slotIndex)
+        .subarray(slice.contentOffset, slice.contentOffset + slice.contentCapacity);
+    target.fill(0);
+    const { written } = textEncoder.encodeInto(value, target);
+    views.slotData(slotIndex).setUint16(slice.lengthOffset, written, true);
+}
+function readStringFromSlot(views, slotIndex, slice) {
+    const length = views.slotData(slotIndex).getUint16(slice.lengthOffset, true);
+    return textDecoder.decode(views.slotBytes(slotIndex).subarray(slice.contentOffset, slice.contentOffset + length));
+}
+function readSlotContent(views, slotIndex) {
+    return {
+        state: byteToState(views.slotData(slotIndex).getUint8(slotStateOffset)),
+        label: readStringFromSlot(views, slotIndex, labelSlice),
+        message: readStringFromSlot(views, slotIndex, messageSlice)
+    };
+}
+export function createSpinnerSharedAccessors(buffer, layout) {
+    const views = createViews(buffer, layout);
+    function writeStateByte(slotIndex, stateByte) {
+        views.slotData(slotIndex).setUint8(slotStateOffset, stateByte);
+    }
+    function readSlotGeneration(slotIndex) {
+        return Atomics.load(views.slotInt32(slotIndex), slotGenerationIndex);
+    }
+    function readSlotAttempt(slotIndex) {
+        return {
+            slot: readSlotContent(views, slotIndex),
+            generationAfter: readSlotGeneration(slotIndex)
+        };
+    }
+    return {
+        layout,
+        buffer,
+        setColumns(columns) {
+            Atomics.store(views.headerUint32, headerColumnsIndex, columns);
+        },
+        getColumns() {
+            return Atomics.load(views.headerUint32, headerColumnsIndex);
+        },
+        setIntervalMs(intervalMs) {
+            Atomics.store(views.headerUint32, headerIntervalIndex, intervalMs);
+        },
+        getIntervalMs() {
+            return Atomics.load(views.headerUint32, headerIntervalIndex);
+        },
+        requestShutdown() {
+            Atomics.store(views.headerInt32, headerControlIndex, controlShutdownValue);
+        },
+        isShutdownRequested() {
+            return Atomics.load(views.headerInt32, headerControlIndex) !== controlIdleValue;
+        },
+        bumpSlotGeneration(slotIndex) {
+            Atomics.add(views.slotInt32(slotIndex), slotGenerationIndex, 1);
+        },
+        writeSlot(slotIndex, state, label, message) {
+            writeStateByte(slotIndex, stateToByte(state));
+            writeStringIntoSlot(views, slotIndex, labelSlice, label);
+            writeStringIntoSlot(views, slotIndex, messageSlice, message);
+        },
+        readSlot(slotIndex) {
+            // Seqlock retry: writers atomically bump the slot generation after
+            // updating the (non-atomic) label/message bytes; if the generation
+            // moves between the two reads we observed a torn write and retry.
+            let generationBefore = readSlotGeneration(slotIndex);
+            const attempts = Array.from({ length: maximumReadSlotAttempts + 1 }, (_value, index) => {
+                return maximumReadSlotAttempts - index;
+            });
+            for (const remainingAttempts of attempts) {
+                if (remainingAttempts === 0) {
+                    break;
+                }
+                const attemptResult = readSlotAttempt(slotIndex);
+                if (attemptResult.generationAfter === generationBefore) {
+                    return attemptResult.slot;
+                }
+                generationBefore = attemptResult.generationAfter;
+            }
+            throw new Error('Failed to read a stable spinner slot snapshot');
+        }
+    };
+}
+//# sourceMappingURL=spinner-shared-state.js.map

package/command-line-interface/spinner-shared-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-shared-state.js","sourceRoot":"","sources":["../../../../source/command-line-interface/spinner-shared-state.ts"],"names":[],"mappings":"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"}

package/command-line-interface/spinner-worker-backend.js

@@ -0,0 +1,62 @@
+import { createSpinnerSharedAccessors, createSpinnerSharedLayout } from "./spinner-shared-state.js";
+const defaultSlotCount = 64;
+const defaultIntervalMs = 80;
+const defaultColumns = 80;
+function resolveOptions(options) {
+    return {
+        slotCount: options.slotCount ?? defaultSlotCount,
+        intervalMs: options.intervalMs ?? defaultIntervalMs,
+        stdoutFileDescriptor: options.stdoutFileDescriptor ?? process.stdout.fd,
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- process.stdout.columns is undefined at runtime when stdout is not a TTY, despite the type declaring it as number
+        stdoutColumns: options.stdoutColumns ?? process.stdout.columns ?? defaultColumns,
+        spawnWorker: options.spawnWorker
+    };
+}
+function setupSharedBuffer(resolved) {
+    const layout = createSpinnerSharedLayout(resolved.slotCount);
+    const buffer = new SharedArrayBuffer(layout.bufferByteLength);
+    const accessors = createSpinnerSharedAccessors(buffer, layout);
+    accessors.setIntervalMs(resolved.intervalMs);
+    accessors.setColumns(resolved.stdoutColumns);
+    return accessors;
+}
+export function createSpinnerRuntime(options) {
+    const resolved = resolveOptions(options);
+    const accessors = setupSharedBuffer(resolved);
+    resolved.spawnWorker({
+        buffer: accessors.buffer,
+        slotCount: accessors.layout.slotCount,
+        stdoutFileDescriptor: resolved.stdoutFileDescriptor
+    });
+    return { accessors, slotCount: resolved.slotCount };
+}
+function writeSlot(accessors, update) {
+    accessors.writeSlot(update.slotIndex, update.state, update.label, update.message);
+    accessors.bumpSlotGeneration(update.slotIndex);
+}
+export function createWorkerSpinnerBackend(dependencies) {
+    const { runtime } = dependencies;
+    function ensureSlotIndexFits(slotIndex) {
+        if (slotIndex >= runtime.slotCount) {
+            throw new RangeError(`Spinner slot index ${slotIndex} exceeds backend capacity ${runtime.slotCount}; increase slotCount`);
+        }
+    }
+    return {
+        add(slotIndex, label, message) {
+            ensureSlotIndexFits(slotIndex);
+            writeSlot(runtime.accessors, { slotIndex, state: 'running', label, message });
+        },
+        update(slotIndex, label, message) {
+            ensureSlotIndexFits(slotIndex);
+            writeSlot(runtime.accessors, { slotIndex, state: 'running', label, message });
+        },
+        finish(slotIndex, status, label, message) {
+            ensureSlotIndexFits(slotIndex);
+            writeSlot(runtime.accessors, { slotIndex, state: status, label, message });
+        },
+        shutdown() {
+            runtime.accessors.requestShutdown();
+        }
+    };
+}
+//# sourceMappingURL=spinner-worker-backend.js.map

package/command-line-interface/spinner-worker-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-worker-backend.js","sourceRoot":"","sources":["../../../../source/command-line-interface/spinner-worker-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,yBAAyB,EAG5B,MAAM,2BAA2B,CAAC;AAGnC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,cAAc,GAAG,EAAE,CAAC;AA+B1B,SAAS,cAAc,CAAC,OAA8B;IAClD,OAAO;QACH,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,gBAAgB;QAChD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,iBAAiB;QACnD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE;QACvE,2LAA2L;QAC3L,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,cAAc;QAChF,WAAW,EAAE,OAAO,CAAC,WAAW;KACnC,CAAC;AACN,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAyB;IAChD,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC7C,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC7C,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IAC/D,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS;QACrC,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;KACtD,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;AACxD,CAAC;AASD,SAAS,SAAS,CAAC,SAAiC,EAAE,MAAkB;IACpE,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAClF,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACnD,CAAC;AAMD,MAAM,UAAU,0BAA0B,CAAC,YAA8C;IACrF,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC;IAEjC,SAAS,mBAAmB,CAAC,SAAiB;QAC1C,IAAI,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,UAAU,CAChB,sBAAsB,SAAS,6BAA6B,OAAO,CAAC,SAAS,sBAAsB,CACtG,CAAC;QACN,CAAC;IACL,CAAC;IAED,OAAO;QACH,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO;YACzB,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC/B,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO;YAC5B,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC/B,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;YACpC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC/B,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,QAAQ;YACJ,OAAO,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACxC,CAAC;KACJ,CAAC;AACN,CAAC"}

package/command-line-interface/terminal-spinner-renderer.js

@@ -1,6 +1,11 @@
+const cancelMessage = 'Canceled …';
 export function createTerminalSpinnerRenderer(dependencies) {
-    const { SpinnerClass } = dependencies;
+    const { backend } = dependencies;
     const spinners = new Map();
+    const usedSlots = new Set();
+    function nextFreeSlotIndex() {
+        return usedSlots.size;
+    }
     function getSpinnerById(id) {
         const spinner = spinners.get(id);
         if (spinner === undefined) {
@@ -16,31 +21,32 @@ export function createTerminalSpinnerRenderer(dependencies) {
     return {
         add(id, label, message) {
             ensureIdDoesNotExist(id);
-            const spinner = new SpinnerClass({ name: 'dots' });
-            spinners.set(id, { instance: spinner, isRunning: true });
-            spinner.start(message, { withPrefix: `${label}: ` });
+            const slotIndex = nextFreeSlotIndex();
+            usedSlots.add(slotIndex);
+            spinners.set(id, { slotIndex, label, message, status: 'running' });
+            backend.add(slotIndex, label, message);
         },
         updateMessage(id, message) {
             const spinner = getSpinnerById(id);
-            spinner.instance.text = message;
+            spinner.message = message;
+            backend.update(spinner.slotIndex, spinner.label, message);
         },
         stop(id, status, message) {
             const spinner = getSpinnerById(id);
-            spinners.set(id, { instance: spinner.instance, isRunning: false });
-            if (status === 'failure') {
-                spinner.instance.failed(message);
-            }
-            else {
-                spinner.instance.succeed(message);
-            }
+            spinner.message = message;
+            spinner.status = status;
+            const finalState = status === 'success' ? 'succeeded' : 'failed';
+            backend.finish(spinner.slotIndex, finalState, spinner.label, message);
         },
         stopAll() {
             for (const spinner of spinners.values()) {
-                if (spinner.isRunning) {
-                    spinner.instance.failed('Canceled …');
+                if (spinner.status === 'running') {
+                    spinner.message = cancelMessage;
+                    backend.finish(spinner.slotIndex, 'canceled', spinner.label, cancelMessage);
                 }
             }
-            SpinnerClass.reset();
+            spinners.clear();
+            backend.shutdown();
         }
     };
 }

package/command-line-interface/terminal-spinner-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-spinner-renderer.js","sourceRoot":"","sources":["../../../../source/command-line-interface/terminal-spinner-renderer.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,6BAA6B,CACzC,YAAiD;IAEjD,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEpD,SAAS,cAAc,CAAC,EAAU;QAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,SAAS,oBAAoB,CAAC,EAAU;QACpC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;IAED,OAAO;QACH,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO;YAClB,oBAAoB,CAAC,EAAE,CAAC,CAAC;YAEzB,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACnD,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,aAAa,CAAC,EAAE,EAAE,OAAO;YACrB,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO;YACpB,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YAEnC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAEnE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;QAED,OAAO;YACH,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC1C,CAAC;YACL,CAAC;YACD,YAAY,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;KACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"terminal-spinner-renderer.js","sourceRoot":"","sources":["../../../../source/command-line-interface/terminal-spinner-renderer.ts"],"names":[],"mappings":"AAgCA,MAAM,aAAa,GAAG,YAAY,CAAC;AAEnC,MAAM,UAAU,6BAA6B,CACzC,YAAiD;IAEjD,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,SAAS,iBAAiB;QACtB,OAAO,SAAS,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,SAAS,cAAc,CAAC,EAAU;QAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,SAAS,oBAAoB,CAAC,EAAU;QACpC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;IAED,OAAO;QACH,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO;YAClB,oBAAoB,CAAC,EAAE,CAAC,CAAC;YAEzB,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;YACtC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,aAAa,CAAC,EAAE,EAAE,OAAO;YACrB,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO;YACpB,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;YAC1B,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;YACxB,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;YACjE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO;YACH,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/B,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC;oBAChC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;gBAChF,CAAC;YACL,CAAC;YACD,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/common/typed-diff.js

@@ -0,0 +1,5 @@
+import { structuredPatch } from 'diff';
+export function createStructuredPatch(...args) {
+    return structuredPatch(...args);
+}
+//# sourceMappingURL=typed-diff.js.map

package/common/typed-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-diff.js","sourceRoot":"","sources":["../../../../source/common/typed-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAiE,MAAM,MAAM,CAAC;AAYtG,MAAM,UAAU,qBAAqB,CAAC,GAAG,IAAyB;IAC9D,OAAO,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -7,15 +7,15 @@
         "Christian Rackerseder <github@echooff.de>"
     ],
     "dependencies": {
-        "@topcli/spinner": "4.2.1",
         "cmd-ts": "0.15.0",
-        "effect": "2.2.5",
-        "kleur": "4.1.5",
-        "packtory": "0.0.8"
+        "diff": "9.0.0",
+        "packtory": "0.0.9",
+        "remeda": "2.34.1",
+        "yoctocolors": "2.1.2"
     },
     "description": "Effortlessly bundle and publish npm packages from the command line with @packtory/cli.",
     "engines": {
-        "node": "^22 || ^24"
+        "node": "^24 || ^26"
     },
     "keywords": [
         "bundler",
@@ -38,5 +38,5 @@
     },
     "type": "module",
     "types": "packages/command-line-interface/command-line-interface.entry-point.d.ts",
-    "version": "0.0.8"
+    "version": "0.0.9"
 }

package/packages/command-line-interface/command-line-interface.entry-point.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-line-interface.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/command-line-interface/command-line-interface.entry-point.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,KAAK,WAAW,MAAM,wBAAwB,CAAC;AA+B3D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC"}
+{"version":3,"file":"command-line-interface.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/command-line-interface/command-line-interface.entry-point.ts"],"names":[],"mappings":";AAOA,OAAO,KAAK,KAAK,WAAW,MAAM,wBAAwB,CAAC;AAsF3D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC"}

package/packages/command-line-interface/command-line-interface.entry-point.js

@@ -7,25 +7,79 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { Spinner } from '@topcli/spinner';
+import fs from 'node:fs/promises';
+import readline from 'node:readline/promises';
+import { createClock } from "packtory/common/clock.js";
+import { bootedSpinnerRuntime } from "../../command-line-interface/spinner-boot.entry-point.js";
+import { createOneTimePasswordPrompt } from "../../command-line-interface/one-time-password-prompt.js";
 import { createCommandLineInterfaceRunner } from "../../command-line-interface/runner.js";
 import { createTerminalSpinnerRenderer } from "../../command-line-interface/terminal-spinner-renderer.js";
+import { createWorkerSpinnerBackend } from "../../command-line-interface/spinner-worker-backend.js";
 import { createConfigLoader } from "../../command-line-interface/config-loader.js";
-import { buildAndPublishAll, resolveAndLinkAll, progressBroadcastConsumer } from "packtory/packages/packtory/packtory.entry-point.js";
+import { previewIo } from "../../command-line-interface/preview-io.js";
+import { createPacktory } from "packtory/packtory/packtory.js";
+import { createScheduler } from "packtory/packtory/scheduler.js";
+import { readCiEnvironment } from "packtory/bundle-emitter/repository-coherence.js";
+import { buildPackageProcessorComposition } from "packtory/packages/package-processor.composition.js";
 async function importModule(modulePath) {
     return import(__rewriteRelativeImportExtension(modulePath));
 }
+const spinnerRenderer = createTerminalSpinnerRenderer({
+    backend: createWorkerSpinnerBackend({ runtime: bootedSpinnerRuntime })
+});
+const clock = createClock();
+const promptForOneTimePassword = createOneTimePasswordPrompt({
+    clock,
+    isInteractiveTerminal: () => {
+        return process.stdin.isTTY && process.stdout.isTTY;
+    },
+    stopSpinner: () => {
+        spinnerRenderer.stopAll();
+    },
+    createInterface: () => {
+        return readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+    }
+});
+const { packageProcessor, progressBroadcaster, deadCodeEliminator } = buildPackageProcessorComposition({
+    promptForOneTimePassword,
+    ciEnvironment: readCiEnvironment(process.env)
+});
+const scheduler = createScheduler({
+    progressBroadcastProvider: progressBroadcaster.provider
+});
+const packtory = createPacktory({
+    scheduler,
+    packageProcessor,
+    deadCodeEliminator,
+    progressBroadcaster
+});
 const commandLinerInterfaceRunner = createCommandLineInterfaceRunner({
-    packtory: { buildAndPublishAll, resolveAndLinkAll },
-    progressBroadcaster: progressBroadcastConsumer,
-    spinnerRenderer: createTerminalSpinnerRenderer({ SpinnerClass: Spinner }),
+    packtory,
+    progressBroadcaster: progressBroadcaster.consumer,
+    spinnerRenderer,
     configLoader: createConfigLoader({ currentWorkingDirectory: process.cwd(), importModule }),
+    writeReportFile: async (filePath, content) => {
+        await fs.writeFile(filePath, content);
+    },
+    pageOutput: async (content) => {
+        const didPage = await previewIo.pagePreviewOutput(content);
+        if (!didPage) {
+            console.log(content);
+        }
+    },
+    openFile: previewIo.openPreviewFile,
+    createTemporaryFilePath: previewIo.createTemporaryPreviewHtmlPath,
     log: console.log
 });
+function setExitCode(exitCode) {
+    process.exitCode = exitCode;
+}
 async function main() {
     const exitCode = await commandLinerInterfaceRunner.run(process.argv);
-    // eslint-disable-next-line require-atomic-updates -- we intentionally want to override the exitCode no matter what its current value is
-    process.exitCode = exitCode;
+    setExitCode(exitCode);
 }
 function crash(error) {
     console.error(error);

package/packages/command-line-interface/command-line-interface.entry-point.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-line-interface.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/command-line-interface/command-line-interface.entry-point.ts"],"names":[],"mappings":";;;;;;;;;AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,EAAE,6BAA6B,EAAE,MAAM,2DAA2D,CAAC;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEvH,KAAK,UAAU,YAAY,CAAC,UAAkB;IAC1C,OAAO,MAAM,kCAAC,UAAU,EAAC,CAAC;AAC9B,CAAC;AAED,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;IACjE,QAAQ,EAAE,EAAE,kBAAkB,EAAE,iBAAiB,EAAE;IACnD,mBAAmB,EAAE,yBAAyB;IAC9C,eAAe,EAAE,6BAA6B,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IACzE,YAAY,EAAE,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,CAAC;IAC1F,GAAG,EAAE,OAAO,CAAC,GAAG;CACnB,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACf,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,wIAAwI;IACxI,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAChC,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IACzB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"command-line-interface.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/command-line-interface/command-line-interface.entry-point.ts"],"names":[],"mappings":"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"}

package/readme.md

@@ -18,12 +18,44 @@ packtory <command> [options]
 
 **Commands:**
 
+- **preview:** Runs a fresh dry-run build with report collection enabled and shows a human-oriented preview of the emitted package contents, file statuses, and changed-file diffs.
 - **publish:** Bundles and publishes npm packages based on the configuration in `packtory.config.js`.
 
 **Options:**
 
 - **--no-dry-run:** Disables dry-run mode (enabled by default), allowing actual publishing.
+- **preview --open:** Generates the same fresh preview report as `packtory preview`, writes a temporary HTML file, and opens it with the platform opener.
+- **publish --report-json:** Writes `packtory-report.json`, the machine-readable `BuildReport`.
+- **publish --report-html:** Writes `packtory-report.html`, the rich HTML report used by `packtory preview --open`.
+
+**Preview behavior:**
+
+- `packtory preview` always performs a fresh dry-run build. It does not reuse prior report files.
+- Previewable runs are shown through `$PAGER` when possible, otherwise `less -R`, otherwise standard output.
+- Failure-only runs skip the pager and print diagnostics directly to standard output.
+- The terminal preview always carries a visible dry-run label.
+- `packtory preview` exits with code `0` on a clean run and `1` on config errors, check failures, or partial failures.
+- `packtory preview --open` still exits successfully if report generation worked but opening the file failed; in that case it prints the temporary file path.
+
+**Report outputs:**
+
+- `--report-json` keeps the durable structured `BuildReport` contract.
+- `--report-html` and `preview --open` render the same human-facing HTML document.
+- The HTML report can still be written for failing runs when report data is available.
 
 **Configuration:**
 
-Create a `packtory.config.js` file in your project to define the configuration. Refer to the [full documentation](https://github.com/enormora/packtory/blob/main/readme.md) for detailed configuration options.
+Create a `packtory.config.js` file in your project to define the configuration. Refer to the [full documentation](../../../readme.md) for detailed configuration options.
+Your root `package.json` must declare `"type": "module"`.
+
+**One-time-password support:**
+
+- If the registry challenges a publish with a one-time password, the CLI prompts for it when running in an interactive TTY.
+- The prompt times out after 90 seconds.
+- Non-interactive runs cannot answer a one-time-password challenge. For CI, prefer an auth method that does not require live one-time-password entry, such as npm trusted publishing / OIDC or a suitable registry token setup.
+
+**Publish settings:**
+
+Every package needs a `publishSettings` value, either set in `commonPackageSettings` as a default or on each package entry directly. If neither is set, the CLI exits with `publishSettings must be set in commonPackageSettings or in every package`. See the [main configuration docs](../../../readme.md) for the full shape and the access ↔ provenance constraint.
+
+For the full list of publish-time errors and remediation, see [Supply Chain → CLI error reference](../../../documentation/supply-chain.md#cli-error-reference).

package/report/changed-artifacts.js

@@ -0,0 +1,10 @@
+export function collectChangedArtifacts(tree) {
+    return tree.flatMap((node) => {
+        if (node.type !== 'file') {
+            return [];
+        }
+        const { artifact } = node;
+        return artifact.diff === undefined ? [] : [{ ...artifact, diff: artifact.diff }];
+    });
+}
+//# sourceMappingURL=changed-artifacts.js.map

package/report/changed-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-artifacts.js","sourceRoot":"","sources":["../../../../source/report/changed-artifacts.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,uBAAuB,CAAC,IAAoC;IACxE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC1B,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;AACP,CAAC"}

package/report/html-escaping.js

@@ -0,0 +1,9 @@
+export function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+//# sourceMappingURL=html-escaping.js.map

package/report/html-escaping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-escaping.js","sourceRoot":"","sources":["../../../../source/report/html-escaping.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAa;IACpC,OAAO,KAAK;SACP,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC"}