@apimatic/cli 1.4.0 → 2.0.0-beta.1

package/lib/prompts/portal/source.js

@@ -0,0 +1,253 @@
+import { log } from '@clack/prompts';
+import { APIMATIC_CONFIG_FILE_NAME } from '../../types/apimatic-config/document.js';
+import { listedInProse } from '../../utils/string-utils.js';
+import { NAVIGATION_FILE_NAME } from '../../types/portal/portal-navigation.js';
+import { TRANSFORMATIONS_DIRECTORY_NAME } from '../../types/transform-context.js';
+import { CONTENT_DIRECTORY_NAME, SPEC_DIRECTORY_NAME, STATIC_DIRECTORY_NAME } from '../../types/project-layout.js';
+import { format as f } from '../format.js';
+const TITLE_EXAMPLE = ['---', 'title: Getting started', '---'].join('\n');
+const ROOT_NAVIGATION_FILE = `${CONTENT_DIRECTORY_NAME}/${NAVIGATION_FILE_NAME}`;
+export const specPath = (sourceDirectory) => f.path(sourceDirectory.join(SPEC_DIRECTORY_NAME));
+export const contentPath = (sourceDirectory) => f.path(sourceDirectory.join(CONTENT_DIRECTORY_NAME));
+export const staticPath = (sourceDirectory) => f.path(sourceDirectory.join(STATIC_DIRECTORY_NAME));
+const relative = (file, sourceDirectory) => f.var(file.relativeTo(sourceDirectory));
+const spelt = (found, sourceDirectory) => `spelt ${relative(found, sourceDirectory)} on disk`;
+// Found by this machine's file system, which ignores case, and lost by the host.
+function reportSpellings(files) {
+    if (files.some(({ foundAs }) => foundAs !== null)) {
+        log.message('Names are matched exactly, as the servers a portal is published to match them, so write each name as the ' +
+            'file is spelt.');
+    }
+}
+const transformCommand = (flags) => [f.cmdAlt('apimatic', 'api', 'transform'), f.flag('format', 'openapi3yaml'), ...flags].join(' ');
+// Quickstart refuses a spec for the same reason, and has to point at the same fix.
+export const convertToOpenApi3 = () => `Convert it with ${transformCommand([f.flag('file', '<your spec>')])}, and use the file it writes into a ` +
+    `${f.var(TRANSFORMATIONS_DIRECTORY_NAME)} folder.`;
+function reportSpecConversion({ file, format, converted, others }, sourceDirectory) {
+    const name = f.var(file.name().toString());
+    log.error(`No OpenAPI 3.x document found in ${specPath(sourceDirectory)}.` + (format === null ? '' : ` ${name} is ${format}.`));
+    const command = transformCommand([
+        f.flag('file', f.relative(file)),
+        f.flag('destination', f.relative(file.directory()))
+    ]);
+    const convert = format === null ? `If ${name} is an API definition in another format, convert` : 'Convert';
+    const documents = others === 1 ? 'document' : `${others} documents`;
+    log.message(`${convert} it with:\n` +
+        `  ${command}\n` +
+        `then move ${f.relativePath(converted)} up into ${specPath(sourceDirectory)}, which is the only folder read.` +
+        (others === 0 ? '' : ` Convert the other ${documents} the same way.`));
+}
+/**
+ * Shared by `portal generate` and `portal serve`: both read the same source directory, so
+ * a broken one has to be explained the same way in both. `offerQuickstart` is false once a
+ * preview of the directory is running: quickstart refuses a directory that is not empty.
+ */
+export function reportSourceProblem(problem, sourceDirectory, { offerQuickstart = true } = {}) {
+    const quickstart = `Run ${f.cmdAlt('apimatic', 'quickstart')} to set up a portal.`;
+    switch (problem.kind) {
+        case 'missingConfig': {
+            log.error(`No ${f.var(APIMATIC_CONFIG_FILE_NAME)} found in ${f.path(sourceDirectory)}.`);
+            if (offerQuickstart) {
+                log.message(quickstart);
+            }
+            return;
+        }
+        case 'invalidConfig': {
+            log.error(`The ${f.var(APIMATIC_CONFIG_FILE_NAME)} in ${f.path(sourceDirectory)} is not valid:`);
+            log.message(problem.errors.map((error) => `  • ${error}`).join('\n'));
+            // A file without the block is no worse off than no file: the same command sets it up.
+            if (problem.missingPortal && offerQuickstart) {
+                log.message(quickstart);
+            }
+            return;
+        }
+        case 'invalidContent': {
+            reportContentProblems(problem.problems, sourceDirectory);
+            return;
+        }
+        case 'unreadableSpec': {
+            log.error(`${f.var(problem.fileName.toString())} could not be read as JSON or YAML.`);
+            return;
+        }
+        case 'missingStaticFiles': {
+            const one = problem.files.length === 1;
+            const [subject, verb] = one ? ['A file', 'is'] : ['Files', 'are'];
+            const heading = `${subject} named in ${f.var(APIMATIC_CONFIG_FILE_NAME)} ${verb} not in ${f.path(sourceDirectory)}:`;
+            const lines = problem.files.map(({ setting, file, foundAs }) => `  • ${relative(file, sourceDirectory)}, named by ${f.var(setting)}` +
+                (foundAs === null ? '' : `, which is ${spelt(foundAs, sourceDirectory)}`));
+            log.error(heading);
+            log.message(lines.join('\n'));
+            log.message(one
+                ? 'Add the file there, or remove the setting that names it.'
+                : 'Add each file there, or remove the setting that names it.');
+            reportSpellings(problem.files);
+            return;
+        }
+        case 'emptySpecDirectory': {
+            const message = `${specPath(sourceDirectory)} has no files. Add your OpenAPI 3.x document to it as a ` +
+                `${f.var('.json')}, ${f.var('.yaml')} or ${f.var('.yml')} file.`;
+            log.error(message);
+            if (problem.folders.length > 0) {
+                const folders = listedInProse(problem.folders.map((folder) => f.var(folder.leafName())));
+                log.message(`A document in a folder inside it, such as ${folders}, is not read: move it up.`);
+            }
+            return;
+        }
+        case 'noOpenApiSpec': {
+            reportSpecConversion(problem.conversion, sourceDirectory);
+            return;
+        }
+    }
+}
+/** Each problem in turn, so one run lists everything a build would refuse in `content/`. */
+export function reportContentProblems(problems, sourceDirectory) {
+    for (const problem of problems) {
+        reportContentProblem(problem, sourceDirectory);
+    }
+}
+function reportContentProblem(problem, sourceDirectory) {
+    switch (problem.kind) {
+        case 'unreadableContent': {
+            log.error(`${contentPath(sourceDirectory)} could not be read. Check that it and every ` +
+                `directory beneath it can be listed.`);
+            return;
+        }
+        case 'groupNamedPages': {
+            const names = listedInProse(problem.pages.map((page) => relative(page, sourceDirectory)));
+            const one = problem.pages.length === 1;
+            log.error(`${names} ${one ? 'is' : 'are'} named like a ${f.var('(group)')} folder, which is left out of every ` +
+                `address, so the build cannot serve ${one ? 'it' : 'them'}. Rename ${one ? 'the file' : 'each file'}.`);
+            return;
+        }
+        case 'reservedAddresses': {
+            reportReservedAddresses(problem.pages, sourceDirectory);
+            return;
+        }
+        case 'sharedAddresses': {
+            reportSharedAddresses(problem.addresses, sourceDirectory);
+            return;
+        }
+        case 'invalidFrontMatter': {
+            log.error(`The front matter of pages in ${f.path(sourceDirectory)} would fail the build:`);
+            log.message(problem.errors.map((error) => `  • ${error}`).join('\n'));
+            log.message(`Start each page with front matter that gives its title, for example:\n${TITLE_EXAMPLE}`);
+            return;
+        }
+        case 'invalidNavigation': {
+            log.error(`The page order in ${f.path(sourceDirectory)} could not be applied:`);
+            log.message(problem.errors.map((error) => `  • ${error}`).join('\n'));
+            return;
+        }
+        case 'missingImages': {
+            reportMissingImages(problem.images, sourceDirectory);
+            return;
+        }
+    }
+}
+function reportMissingImages(images, sourceDirectory) {
+    const lines = images.map(({ page, line, url, missing }) => {
+        const where = `  • ${relative(page, sourceDirectory)}, line ${line}: ${f.var(url)}`;
+        if (missing === null) {
+            return `${where} points outside ${f.var(CONTENT_DIRECTORY_NAME)}, or into a folder the build skips`;
+        }
+        return missing.foundAs === null
+            ? `${where}, but there is no ${relative(missing.file, sourceDirectory)}`
+            : `${where}, but the file is ${spelt(missing.foundAs, sourceDirectory)}`;
+    });
+    log.error(images.length === 1
+        ? `A page in ${f.path(sourceDirectory)} shows an image the build cannot find:`
+        : `Pages in ${f.path(sourceDirectory)} show images the build cannot find:`);
+    log.message(lines.join('\n'));
+    log.message(`An image written as ${f.var('/images/logo.png')} is read from ${staticPath(sourceDirectory)}, and any ` +
+        `other from beside its page in ${contentPath(sourceDirectory)}.`);
+    reportSpellings(images.flatMap(({ missing }) => (missing === null ? [] : [missing])));
+}
+function reportReservedAddresses(pages, sourceDirectory) {
+    const one = pages.length === 1;
+    const lines = pages.map(({ file, address, section }) => {
+        const kept = `/${section.folder}`;
+        const within = address === kept ? '' : `, under ${f.var(kept)}`;
+        return `  • ${relative(file, sourceDirectory)}, at ${f.var(address)}${within}, which is kept for ${section.description}`;
+    });
+    log.error(one
+        ? `A page in ${f.path(sourceDirectory)} would be served where the portal puts the pages it generates:`
+        : `Pages in ${f.path(sourceDirectory)} would be served where the portal puts the pages it generates:`);
+    log.message(lines.join('\n'));
+    log.message(one ? 'Rename or move the page.' : 'Rename or move each page.');
+}
+function reportSharedAddresses(addresses, sourceDirectory) {
+    const one = addresses.length === 1;
+    const lines = addresses.map(({ address, pages }) => `  • ${f.var(address)}: ${listedInProse(pages.map((page) => relative(page, sourceDirectory)))}`);
+    log.error(`Pages in ${f.path(sourceDirectory)} would share ${one ? 'an address' : 'addresses'}, but only one page ` +
+        `can be served at each:`);
+    log.message(lines.join('\n'));
+    log.message(`Rename or move all but one ${one ? 'of them' : 'page at each address'}. A page in a ${f.var('(group)')} folder is served as if the folder were not there, and an ${f.var('index')} page at its folder's address.`);
+}
+export function reportShadowedFiles(shadowed) {
+    if (shadowed.length === 0) {
+        return;
+    }
+    const names = listedInProse(shadowed.map((fileName) => f.var(fileName.toString())));
+    const replaces = shadowed.length === 1 ? 'replaces the file' : 'replace the files';
+    log.warn(`${names} in ${f.var('static')} ${replaces} the portal would have generated.`);
+}
+export function reportIgnoredNavigationFiles(files, sourceDirectory) {
+    if (files.length === 0) {
+        return;
+    }
+    const names = listedInProse(files.map((file) => relative(file, sourceDirectory)));
+    const verb = files.length === 1 ? 'is' : 'are';
+    // Not "rename it": on a case-sensitive filesystem a correctly named file may already sit
+    // beside it, and the two would then need merging rather than renaming.
+    log.warn(`${names} ${verb} not read. Only a file named ${f.var(NAVIGATION_FILE_NAME)}, in lower case, orders the pages.`);
+}
+export function reportContentNotices(notices, sourceDirectory) {
+    reportHiddenPages(notices.hiddenPages, sourceDirectory);
+    reportIgnoredNavigationFiles(notices.ignoredNavigationFiles, sourceDirectory);
+    reportFolderTabs(notices.folderTabs);
+    reportSharedTabNames(notices.sharedTabNames, sourceDirectory);
+}
+export function reportFolderTabs(folders) {
+    if (folders.length === 0) {
+        return;
+    }
+    const names = listedInProse(folders.map((folder) => f.var(folder.leafName())));
+    log.info(`${f.var(ROOT_NAVIGATION_FILE)} makes a tab of each folder it lists: ${names}.`);
+}
+export function reportSharedTabNames(shared, sourceDirectory) {
+    if (shared.length === 0) {
+        return;
+    }
+    const describe = ({ owner, namedBy }) => {
+        const titledIn = namedBy === null ? '' : ` (titled in ${relative(namedBy, sourceDirectory)})`;
+        switch (owner.kind) {
+            case 'home':
+                return `the Home tab${titledIn}`;
+            case 'apiReference':
+                return `the API reference${titledIn}`;
+            case 'generated':
+                return `the tab of ${owner.section.description}`;
+            case 'folder': {
+                const folder = `the tab of the ${f.var(owner.directory.leafName())} folder`;
+                return namedBy === null ? `${folder} (named after the folder)` : `${folder}${titledIn}`;
+            }
+        }
+    };
+    const spellings = (tabs) => listedInProse([...new Set(tabs.map(({ name }) => name))].map((name) => f.var(name)));
+    log.warn('More than one tab has the same name, or one that differs only in case, so readers cannot tell them apart:');
+    log.message(shared.map(({ tabs }) => `  • ${spellings(tabs)}: ${listedInProse(tabs.map(describe))}`).join('\n'));
+    log.message(`Rename all but one tab of each name with a ${f.var('title')} in its folder's ` +
+        `${f.var(NAVIGATION_FILE_NAME)}, or in ${f.var(ROOT_NAVIGATION_FILE)} for the Home tab; the tabs of the ` +
+        `SDK pages and the context plugin keep their names.`);
+}
+export function reportHiddenPages(files, sourceDirectory) {
+    if (files.length === 0) {
+        return;
+    }
+    const names = listedInProse(files.map((file) => relative(file, sourceDirectory)));
+    const [verb, pronoun] = files.length === 1 ? ['sits', 'it'] : ['sit', 'them'];
+    log.warn(`${names} ${verb} inside a specification's section under ${f.var('content/api')}, which lists only ` +
+        `its own reference pages, so ${pronoun} will not appear in the sidebar. Move ${pronoun} elsewhere ` +
+        `in ${f.var('content')}.`);
+}
+//# sourceMappingURL=source.js.map

package/lib/prompts/portal/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/prompts/portal/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAU/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAIlF,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACnH,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1E,MAAM,oBAAoB,GAAG,GAAG,sBAAsB,IAAI,oBAAoB,EAAE,CAAC;AAEjF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,eAA8B,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAEtH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,eAA8B,EAAU,EAAE,CACpE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,eAA8B,EAAU,EAAE,CACnE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;AAEtD,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAE,eAA8B,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;AAErH,MAAM,KAAK,GAAG,CAAC,KAAe,EAAE,eAA8B,EAAU,EAAE,CACxE,SAAS,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC;AAEtD,iFAAiF;AACjF,SAAS,eAAe,CAAC,KAAoB;IAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,OAAO,CACT,2GAA2G;YACzG,gBAAgB,CACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,KAAe,EAAU,EAAE,CACnD,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEnG,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C,mBAAmB,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,sCAAsC;IAC1G,GAAG,CAAC,CAAC,GAAG,CAAC,8BAA8B,CAAC,UAAU,CAAC;AAErD,SAAS,oBAAoB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAkB,EAAE,eAA8B;IAC/G,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,KAAK,CACP,oCAAoC,QAAQ,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,MAAM,GAAG,CAAC,CACrH,CAAC;IACF,MAAM,OAAO,GAAG,gBAAgB,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;KACpD,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,kDAAkD,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,YAAY,CAAC;IACpE,GAAG,CAAC,OAAO,CACT,GAAG,OAAO,aAAa;QACrB,KAAK,OAAO,IAAI;QAChB,aAAa,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,QAAQ,CAAC,eAAe,CAAC,kCAAkC;QAC7G,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,sBAAsB,SAAS,gBAAgB,CAAC,CACxE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA4B,EAC5B,eAA8B,EAC9B,EAAE,eAAe,GAAG,IAAI,EAAE,GAAkC,EAAE;IAE9D,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,sBAAsB,CAAC;IACnF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,eAAe,EAAE,CAAC;YACrB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACzF,IAAI,eAAe,EAAE,CAAC;gBACpB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,eAAe,EAAE,CAAC;YACrB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;YACjG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,sFAAsF;YACtF,IAAI,OAAO,CAAC,aAAa,IAAI,eAAe,EAAE,CAAC;gBAC7C,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,gBAAgB,EAAE,CAAC;YACtB,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,KAAK,gBAAgB,EAAE,CAAC;YACtB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,qCAAqC,CAAC,CAAC;YACtF,OAAO;QACT,CAAC;QACD,KAAK,oBAAoB,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;YACvC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,GAAG,OAAO,aAAa,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC,IAAI,CAC9F,eAAe,CAChB,GAAG,CAAC;YACL,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAC7B,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAC7B,OAAO,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;gBACpE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC,CAC5E,CAAC;YACF,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9B,GAAG,CAAC,OAAO,CACT,GAAG;gBACD,CAAC,CAAC,0DAA0D;gBAC5D,CAAC,CAAC,2DAA2D,CAChE,CAAC;YACF,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,KAAK,oBAAoB,EAAE,CAAC;YAC1B,MAAM,OAAO,GACX,GAAG,QAAQ,CAAC,eAAe,CAAC,0DAA0D;gBACtF,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YACnE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnB,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;gBACzF,GAAG,CAAC,OAAO,CAAC,6CAA6C,OAAO,4BAA4B,CAAC,CAAC;YAChG,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,eAAe,EAAE,CAAC;YACrB,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,qBAAqB,CAAC,QAA0B,EAAE,eAA8B;IAC9F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAuB,EAAE,eAA8B;IACnF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,mBAAmB,EAAE,CAAC;YACzB,GAAG,CAAC,KAAK,CACP,GAAG,WAAW,CAAC,eAAe,CAAC,8CAA8C;gBAC3E,qCAAqC,CACxC,CAAC;YACF,OAAO;QACT,CAAC;QACD,KAAK,iBAAiB,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;YACvC,GAAG,CAAC,KAAK,CACP,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,sCAAsC;gBACnG,sCAAsC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,GAAG,CACzG,CAAC;YACF,OAAO;QACT,CAAC;QACD,KAAK,mBAAmB,EAAE,CAAC;YACzB,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QACD,KAAK,iBAAiB,EAAE,CAAC;YACvB,qBAAqB,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QACD,KAAK,oBAAoB,EAAE,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,yEAAyE,aAAa,EAAE,CAAC,CAAC;YACtG,OAAO;QACT,CAAC;QACD,KAAK,mBAAmB,EAAE,CAAC;YACzB,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC;YAChF,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QACD,KAAK,eAAe,EAAE,CAAC;YACrB,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAsB,EAAE,eAA8B;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QACxD,MAAM,KAAK,GAAG,OAAO,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpF,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,GAAG,KAAK,mBAAmB,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC,oCAAoC,CAAC;QACtG,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,KAAK,IAAI;YAC7B,CAAC,CAAC,GAAG,KAAK,qBAAqB,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE;YACxE,CAAC,CAAC,GAAG,KAAK,qBAAqB,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CACP,MAAM,CAAC,MAAM,KAAK,CAAC;QACjB,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,wCAAwC;QAC9E,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,qCAAqC,CAC7E,CAAC;IACF,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,GAAG,CAAC,OAAO,CACT,uBAAuB,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,iBAAiB,UAAU,CAAC,eAAe,CAAC,YAAY;QACtG,iCAAiC,WAAW,CAAC,eAAe,CAAC,GAAG,CACnE,CAAC;IACF,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,uBAAuB,CAAC,KAA4B,EAAE,eAA8B;IAC3F,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QACrD,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,OAAO,OAAO,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,MAAM,uBAC1E,OAAO,CAAC,WACV,EAAE,CAAC;IACL,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CACP,GAAG;QACD,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,gEAAgE;QACtG,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,gEAAgE,CACxG,CAAC;IACF,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,qBAAqB,CAAC,SAA0B,EAAE,eAA8B;IACvF,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CACzB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CACrB,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAClG,CAAC;IACF,GAAG,CAAC,KAAK,CACP,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,sBAAsB;QACvG,wBAAwB,CAC3B,CAAC;IACF,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,GAAG,CAAC,OAAO,CACT,8BAA8B,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,iBAAiB,CAAC,CAAC,GAAG,CAC1F,SAAS,CACV,6DAA6D,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gCAAgC,CAC7G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAoB;IACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACnF,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,mCAAmC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAiB,EAAE,eAA8B;IAC5F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/C,yFAAyF;IACzF,uEAAuE;IACvE,GAAG,CAAC,IAAI,CACN,GAAG,KAAK,IAAI,IAAI,gCAAgC,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,oCAAoC,CAChH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAuB,EAAE,eAA8B;IAC1F,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACxD,4BAA4B,CAAC,OAAO,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;IAC9E,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,oBAAoB,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,yCAAyC,KAAK,GAAG,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAuB,EAAE,eAA8B;IAC1F,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAa,EAAU,EAAE;QACzD,MAAM,QAAQ,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC;QAC9F,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,MAAM;gBACT,OAAO,eAAe,QAAQ,EAAE,CAAC;YACnC,KAAK,cAAc;gBACjB,OAAO,oBAAoB,QAAQ,EAAE,CAAC;YACxC,KAAK,WAAW;gBACd,OAAO,cAAc,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACnD,KAAK,QAAQ,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC;gBAC5E,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,2BAA2B,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,IAAiB,EAAE,EAAE,CACtC,aAAa,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvF,GAAG,CAAC,IAAI,CAAC,2GAA2G,CAAC,CAAC;IACtH,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjH,GAAG,CAAC,OAAO,CACT,8CAA8C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB;QAC7E,GAAG,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,qCAAqC;QACzG,oDAAoD,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAiB,EAAE,eAA8B;IACjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9E,GAAG,CAAC,IAAI,CACN,GAAG,KAAK,IAAI,IAAI,2CAA2C,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,qBAAqB;QAClG,+BAA+B,OAAO,yCAAyC,OAAO,aAAa;QACnG,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAC5B,CAAC;AACJ,CAAC"}

package/lib/prompts/prompt.d.ts

@@ -1,9 +1,17 @@
-import { Result } from "neverthrow";
-export declare function withSpinner<T, E>(intro: string, success: string, failure: string, fn: Promise<Result<T, E>>): Promise<Result<T, E>>;
+import { Result } from 'neverthrow';
+/** A fixed message, or one built from what the operation returned. */
+type SpinnerMessage<T> = string | ((value: T) => string);
+export interface SpinnerOptions {
+    /** `timer` shows elapsed time, for work measured in tens of seconds rather than a moment. */
+    indicator?: 'dots' | 'timer';
+}
+export declare function withSpinner<T, E>(intro: string, success: SpinnerMessage<T>, failure: SpinnerMessage<E>, fn: Promise<Result<T, E>>, options?: SpinnerOptions): Promise<Result<T, E>>;
 export declare const noteWrapped: (message: string, title: string) => void;
+type ColumnStyle = 'primary' | 'secondary' | 'item';
 export declare function buildTableWithHeading(groups: {
     heading: string;
     rows: string[][];
 }[], headers: string[], columnStyles?: ColumnStyle[]): string;
-type ColumnStyle = 'primary' | 'secondary' | 'item';
+/** The part of a child process's output worth putting in front of the user. */
+export declare function logTail(output: string): string;
 export {};

package/lib/prompts/prompt.js

@@ -1,31 +1,32 @@
-import pc from "picocolors";
-import { getColumns } from "@clack/core";
-import { log, note, S_BAR_H, S_CONNECT_LEFT, spinner } from "@clack/prompts";
-import { stripAnsi } from "../utils/string-utils.js";
-export async function withSpinner(intro, success, failure, fn) {
+import { stripVTControlCharacters } from 'node:util';
+import pc from 'picocolors';
+import { getColumns } from '@clack/core';
+import { log, note, S_BAR_H, S_CONNECT_LEFT, spinner } from '@clack/prompts';
+export async function withSpinner(intro, success, failure, fn, options = {}) {
     const s = spinner({
-        cancelMessage: "cancelled",
-        errorMessage: "failed",
-        frames: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
+        ...(options.indicator === 'timer' ? { indicator: 'timer' } : {}),
+        cancelMessage: 'cancelled',
+        errorMessage: 'failed',
+        frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
     });
     s.start(intro);
     const result = await fn;
-    result.match(() => s.stop(success, 0), () => s.stop(failure, 1));
+    result.match((value) => s.stop(typeof success === 'function' ? success(value) : success, 0), (error) => s.stop(typeof failure === 'function' ? failure(error) : failure, 1));
     return result;
 }
 export const noteWrapped = (message, title) => {
     const output = process.stdout;
     const columns = getColumns(output) || 80;
-    const messages = message.split("\n");
+    const messages = message.split('\n');
     const messageHasOverFlow = messages.some((msg) => {
-        const clean = stripAnsi(msg);
+        const clean = stripVTControlCharacters(msg);
         return clean.length + 6 > columns;
     });
     if (messageHasOverFlow) {
         const startLine = S_BAR_H.repeat(columns - title.length - 4);
         log.step(`${title} ${pc.gray(startLine)}`);
         log.message(message);
-        output.write(pc.gray(S_CONNECT_LEFT + S_BAR_H.repeat(columns - 1)) + "\n");
+        output.write(pc.gray(S_CONNECT_LEFT + S_BAR_H.repeat(columns - 1)) + '\n');
     }
     else {
         const opts = {
@@ -43,7 +44,7 @@ function buildTable(headers, rows, rowSeparators = false, columnStyles) {
     const COL_PAD = 2;
     const MIN_COL_WIDTH = 4;
     const coloredHeaders = headers.map((h) => pc.bold(pc.white(h)));
-    let widths = headers.map((h, i) => Math.max(stripAnsi(h).length, ...rows.map((r) => stripAnsi(r[i]).length)) + COL_PAD);
+    let widths = headers.map((h, i) => Math.max(stripVTControlCharacters(h).length, ...rows.map((r) => stripVTControlCharacters(r[i]).length)) + COL_PAD);
     const terminalColumns = getColumns(process.stdout) || 80;
     const totalWidth = 1 + 3 * headers.length + widths.reduce((a, b) => a + b, 0);
     if (totalWidth > terminalColumns) {
@@ -60,7 +61,7 @@ function buildTable(headers, rows, rowSeparators = false, columnStyles) {
     const renderRow = (cells, applyStyles = false) => pc.gray('│') +
         cells
             .map((cell, i) => {
-            const styled = applyStyles && (columnStyles === null || columnStyles === void 0 ? void 0 : columnStyles[i]) ? columnStyleMap[columnStyles[i]](cell) : cell;
+            const styled = applyStyles && columnStyles?.[i] ? columnStyleMap[columnStyles[i]](cell) : cell;
             return ` ${pad(styled, widths[i])} ` + pc.gray('│');
         })
             .join('');
@@ -77,6 +78,29 @@ function buildTable(headers, rows, rowSeparators = false, columnStyles) {
 }
 /** Pad `text` to `width` visible characters (ANSI-safe). */
 function pad(text, width) {
-    return text + ' '.repeat(Math.max(0, width - stripAnsi(text).length));
+    return text + ' '.repeat(Math.max(0, width - stripVTControlCharacters(text).length));
+}
+/** Last lines of a failed build, enough to show the cause without flooding the terminal. */
+const LOG_TAIL_LINES = 15;
+const STACK_FRAME = /^\s+at\s/;
+// A bundler puts the message and the offending file first and its own stack last, so a plain
+// tail of the log shows the least useful part of it. Frames inside installed packages are
+// dropped first; they also carry the store paths of the CLI's own dependencies.
+const INTERNAL_FRAME = new RegExp(STACK_FRAME.source + /.*(?:[\\/]node_modules[\\/]|\(node:)/.source);
+// Where Vite's report of a failed build, or of a dev server that failed to start, begins.
+const ERROR_HEADINGS = ['error during build:', 'error when starting dev server:'];
+/** The part of a child process's output worth putting in front of the user. */
+export function logTail(output) {
+    const lines = stripVTControlCharacters(output).trimEnd().split('\n');
+    const meaningful = lines.filter((line) => !INTERNAL_FRAME.test(line));
+    // Some failures are nothing but frames; showing them beats showing nothing.
+    const source = meaningful.some((line) => line.trim().length > 0) ? meaningful : lines;
+    const error = source.findIndex((line) => ERROR_HEADINGS.some((heading) => line.trimStart().startsWith(heading)));
+    if (error === -1) {
+        return source.slice(-LOG_TAIL_LINES).join('\n').trim();
+    }
+    // After the heading, the error alone: the CLI already says what failed, and the full log keeps the frames.
+    const [message = '', ...rest] = source.slice(error + 1).filter((line) => !STACK_FRAME.test(line));
+    return [message.replace(/^Error: /, ''), ...rest].slice(0, LOG_TAIL_LINES).join('\n').trim();
 }
 //# sourceMappingURL=prompt.js.map

package/lib/prompts/prompt.js.map

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

package/lib/prompts/quickstart.d.ts

@@ -1,6 +1,49 @@
-export type QuickstartFlow = "sdk" | "portal" | undefined;
+import { Result } from 'neverthrow';
+import { UrlPath } from '../types/file/urlPath.js';
+import { DirectoryPath } from '../types/file/directoryPath.js';
+import { FilePath } from '../types/file/filePath.js';
+import { ServiceError } from '../infrastructure/service-error.js';
+import { Directory } from '../types/file/directory.js';
+import { ResourceInput } from '../types/file/resource-input.js';
+import { FileDownloadResponse } from '../infrastructure/services/file-download-service.js';
+import { PortalAuthorizationFailure } from '../infrastructure/services/portal-authorization-service.js';
+import { PluginConfigWriteFailure } from '../types/plugin-config-context.js';
+import { PortalScaffoldProblem } from '../types/portal/portal-source.js';
+import { GitignoreFailure } from '../types/project-context.js';
+import { Language } from '../types/sdk/generate.js';
 export declare class QuickstartPrompts {
     welcomeMessage(): void;
-    selectQuickstartFlow(): Promise<QuickstartFlow>;
-    noQuickstartFlowSelected(): void;
+    importSpecStep(): void;
+    /** The project came with its own source directory, so there is nothing to import into it. */
+    importSpecStepAdopted(sourceDirectory: DirectoryPath): void;
+    /** `defaultSpecUrl` is null once the sample has failed to download; it is not offered again. */
+    specPathPrompt(defaultSpecUrl: UrlPath | null): Promise<ResourceInput | undefined>;
+    specFormatUnsupported(specPath: FilePath, format: string): void;
+    /** For a document that names no format at all: a Postman collection, a RAML file, arbitrary JSON. */
+    specNotRecognised(specPath: FilePath): void;
+    runtimeUnsupported(reason: string): void;
+    specFileDoesNotExist(): void;
+    noSpecSpecified(): void;
+    useDefaultSpecPrompt(): Promise<boolean>;
+    fixYourSpec(): void;
+    validateSpecStep(): void;
+    specValidationFailed(spec: ResourceInput): void;
+    createPortalStep(): void;
+    authorizationFailed(failure: PortalAuthorizationFailure): void;
+    projectDirectoryPrompt(): Promise<DirectoryPath | undefined>;
+    projectDirectoryDoesNotExist(projectDirectory: DirectoryPath): void;
+    projectDirectoryNotEmpty(projectDirectory: DirectoryPath): void;
+    noProjectDirectoryProvided(): void;
+    scaffoldFailed(problem: PortalScaffoldProblem, sourceDirectory: DirectoryPath): void;
+    downloadSpecFile(fn: Promise<Result<FileDownloadResponse, ServiceError>>): Promise<Result<FileDownloadResponse, ServiceError>>;
+    nextSteps(configFile: FilePath): void;
+    serviceError(serviceError: ServiceError): void;
+    /** Names the address that failed: without it the same message repeats for every retry. */
+    specDownloadFailed(url: UrlPath, serviceError: ServiceError): void;
+    printDirectoryStructure(projectDirectory: DirectoryPath, structure: Directory): void;
+    selectLanguages(): Promise<Language[] | undefined>;
+    noLanguagesSelected(): void;
+    configNotWritten(failure: PluginConfigWriteFailure, sourceDirectory: DirectoryPath): void;
+    /** A warning, not an error: the portal is already written, and Git tracking it does not stop a build. */
+    gitignoreNotUpdated(failure: GitignoreFailure, projectDirectory: DirectoryPath): void;
 }