basalt-core 0.0.0-rc5

package/dist/cli/packageApp.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Turning a host binary into the thing each desktop calls an application.
+ *
+ * `--build` produces an executable, and an executable is not an application on
+ * any of these three. What it costs to stay a bare binary is not cosmetic:
+ *
+ *   macOS    `UNUserNotificationCenter` does not merely fail for a process with
+ *            no bundle identifier -- it raises `bundleProxyForCurrentProcess is
+ *            nil` and terminates. So notifications are unreachable, and so are
+ *            the Dock icon, the menu bar name, file associations and a
+ *            registered URL scheme, all of which live in the same `Info.plist`.
+ *
+ *   Linux    Notifications work without one, because the D-Bus service takes
+ *            the name in the call. What a `.desktop` file adds is identity: the
+ *            app's icon beside its notifications, its name in the switcher, and
+ *            `x-scheme-handler/` so a link opens it.
+ *
+ *   Windows  A toast needs an AppUserModelID and a Start Menu shortcut carrying
+ *            it. Both are done by the host itself rather than from here -- a
+ *            `.lnk` with that property set means `IPropertyStore`, which is
+ *            COM, and doing it in C++ at startup is simpler than doing it in
+ *            PowerShell from Node. See win32/Win32Packaging.h.
+ *
+ * So this file is macOS and Linux, and Windows is a no-op that says why.
+ *
+ * ## The macOS bundle is not only for release
+ *
+ * `NSBundle.mainBundle` comes from where the executable *is*, not from how it
+ * was launched. An executable at `Foo.app/Contents/MacOS/Foo` is bundled even
+ * when run straight from a shell -- so packaging on every run, including a
+ * development one, is what makes `Notification` behave the same in both. The
+ * copy is skipped when the binary has not changed, which is what keeps that
+ * from costing forty megabytes a run.
+ */
+/** The three desktops this can package for. */
+export type PackagePlatform = 'linux' | 'macos' | 'windows';
+/**
+ * What an app calls itself, gathered from whatever it already declares --
+ * `app.json`, `package.json`, or an Expo config. Never invented beyond the
+ * documented fallbacks.
+ */
+export type AppConfig = {
+    name: string;
+    slug: string;
+    /** Reverse-DNS, which is what macOS and notifications need. */
+    identifier: string;
+    /** Custom URL schemes the app registers. */
+    schemes: string[];
+    version: string;
+};
+export type PackageRequest = {
+    platform: PackagePlatform;
+    hostBinary: string;
+    outputDir: string;
+    projectRoot: string;
+    bundlePath?: string;
+};
+/**
+ * What was produced.
+ *
+ * `launchPath` is the thing to run, which is not always the host binary: on
+ * macOS it is the executable *inside* the bundle, because that is what makes
+ * `NSBundle.mainBundle` the bundle.
+ */
+export type PackageResult = {
+    launchPath: string;
+    config: AppConfig;
+    /** Where the identity file went, or null when there was no bundle to sit beside. */
+    identityPath: string | null;
+    /** macOS only: the `.app` that was built. */
+    appPath?: string;
+    /** Linux only: the `.desktop` entry that was written. */
+    desktopPath?: string;
+};
+/**
+ * What an app calls itself, from whichever of the three places says so.
+ *
+ * Expo's config wins where there is one, because an Expo app's `app.json` is
+ * read through `expo/config` and may be a function; `app.json` is the plain
+ * React Native answer; `package.json` is the last resort so that this never
+ * fails outright.
+ */
+export declare function readAppConfig(projectRoot: string): AppConfig;
+export declare function infoPlist(config: AppConfig, executableName: string): string;
+/**
+ * Packages `hostBinary` for `platform`, into `outputDir`.
+ *
+ * Returns `{launchPath, ...}`: what to run. On Linux and Windows that is the
+ * binary it was given, because neither makes the application out of where the
+ * executable sits; on macOS it is the copy inside the bundle.
+ */
+/**
+ * Writes what the app calls itself beside the bundle, for the host to read.
+ *
+ * Beside the bundle rather than beside the executable, because the executable
+ * is shared by every app on the machine; and written rather than passed as an
+ * argument, because a Start Menu shortcut clicked in a month carries no
+ * environment. See native/core/AppIdentity.h.
+ */
+export declare function writeIdentity(bundlePath: string | undefined, config: AppConfig): string | null;
+export declare function packageApp({ platform, hostBinary, outputDir, projectRoot, bundlePath, }: PackageRequest): PackageResult;
+//# sourceMappingURL=packageApp.d.ts.map

package/dist/cli/packageApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageApp.d.ts","sourceRoot":"","sources":["../../cli/packageApp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAQH,+CAA+C;AAC/C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,oFAAoF;IACpF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAgCF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAsD5D;AAUD,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAgD3E;AAwGD;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,SAAS,GAChB,MAAM,GAAG,IAAI,CAoBf;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,GACX,EAAE,cAAc,GAAG,aAAa,CAehC"}

package/dist/cli/packageApp.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * Turning a host binary into the thing each desktop calls an application.
+ *
+ * `--build` produces an executable, and an executable is not an application on
+ * any of these three. What it costs to stay a bare binary is not cosmetic:
+ *
+ *   macOS    `UNUserNotificationCenter` does not merely fail for a process with
+ *            no bundle identifier -- it raises `bundleProxyForCurrentProcess is
+ *            nil` and terminates. So notifications are unreachable, and so are
+ *            the Dock icon, the menu bar name, file associations and a
+ *            registered URL scheme, all of which live in the same `Info.plist`.
+ *
+ *   Linux    Notifications work without one, because the D-Bus service takes
+ *            the name in the call. What a `.desktop` file adds is identity: the
+ *            app's icon beside its notifications, its name in the switcher, and
+ *            `x-scheme-handler/` so a link opens it.
+ *
+ *   Windows  A toast needs an AppUserModelID and a Start Menu shortcut carrying
+ *            it. Both are done by the host itself rather than from here -- a
+ *            `.lnk` with that property set means `IPropertyStore`, which is
+ *            COM, and doing it in C++ at startup is simpler than doing it in
+ *            PowerShell from Node. See win32/Win32Packaging.h.
+ *
+ * So this file is macOS and Linux, and Windows is a no-op that says why.
+ *
+ * ## The macOS bundle is not only for release
+ *
+ * `NSBundle.mainBundle` comes from where the executable *is*, not from how it
+ * was launched. An executable at `Foo.app/Contents/MacOS/Foo` is bundled even
+ * when run straight from a shell -- so packaging on every run, including a
+ * development one, is what makes `Notification` behave the same in both. The
+ * copy is skipped when the binary has not changed, which is what keeps that
+ * from costing forty megabytes a run.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readAppConfig = readAppConfig;
+exports.infoPlist = infoPlist;
+exports.writeIdentity = writeIdentity;
+exports.packageApp = packageApp;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const node_module_1 = require("node:module");
+/**
+ * What an app calls itself, from whichever of the three places says so.
+ *
+ * Expo's config wins where there is one, because an Expo app's `app.json` is
+ * read through `expo/config` and may be a function; `app.json` is the plain
+ * React Native answer; `package.json` is the last resort so that this never
+ * fails outright.
+ */
+function readAppConfig(projectRoot) {
+    let exp = null;
+    try {
+        const { getConfig } = (0, node_module_1.createRequire)(path.join(projectRoot, 'package.json'))('expo/config');
+        exp = getConfig(projectRoot, {
+            skipSDKVersionRequirement: true,
+            isPublicConfig: true,
+        }).exp;
+    }
+    catch {
+        // Not an Expo app. Not a failure: the two files below say the same things.
+    }
+    const readJson = (file) => {
+        try {
+            return JSON.parse(fs.readFileSync(path.join(projectRoot, file), 'utf8'));
+        }
+        catch {
+            return {};
+        }
+    };
+    const appJson = readJson('app.json');
+    const packageJson = readJson('package.json');
+    const name = exp?.name ?? appJson.displayName ?? appJson.name ?? packageJson.name ?? 'App';
+    const slug = exp?.slug ?? appJson.name ?? packageJson.name ?? 'app';
+    // A reverse-DNS identifier, from whatever the app already declares for a
+    // phone. Inventing one is the last resort and is deliberately visible in the
+    // string, because an app that ships with `com.basalt.<slug>` should be able
+    // to tell that nobody chose it.
+    const identifier = appJson.basalt?.identifier ??
+        exp?.ios?.bundleIdentifier ??
+        exp?.android?.package ??
+        `com.basalt.${String(slug).replace(/[^A-Za-z0-9-]/g, '-').toLowerCase()}`;
+    // `expo.scheme` is a string or a list of them. Everything downstream wants a
+    // list, so it becomes one here.
+    const scheme = exp?.scheme ?? appJson.basalt?.scheme ?? null;
+    const schemes = scheme == null ? [] : Array.isArray(scheme) ? scheme : [scheme];
+    return {
+        name,
+        slug,
+        identifier,
+        schemes,
+        version: exp?.version ?? appJson.version ?? packageJson.version ?? '1.0.0',
+    };
+}
+/** XML text, escaped. A plist is XML and an app called `Ben & Co` is legal. */
+function xml(text) {
+    return String(text)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+function infoPlist(config, executableName) {
+    const urlTypes = config.schemes.length === 0
+        ? ''
+        : `
+	<key>CFBundleURLTypes</key>
+	<array>
+		<dict>
+			<key>CFBundleURLName</key>
+			<string>${xml(config.identifier)}</string>
+			<key>CFBundleURLSchemes</key>
+			<array>
+${config.schemes.map(s => `				<string>${xml(s)}</string>`).join('\n')}
+			</array>
+		</dict>
+	</array>`;
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>${xml(executableName)}</string>
+	<key>CFBundleIdentifier</key>
+	<string>${xml(config.identifier)}</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>${xml(config.name)}</string>
+	<key>CFBundleDisplayName</key>
+	<string>${xml(config.name)}</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>${xml(config.version)}</string>
+	<key>CFBundleVersion</key>
+	<string>${xml(config.version)}</string>
+	<key>LSMinimumSystemVersion</key>
+	<string>11.0</string>
+	<key>NSHighResolutionCapable</key>
+	<true/>
+	<key>NSSupportsAutomaticGraphicsSwitching</key>
+	<true/>${urlTypes}
+</dict>
+</plist>
+`;
+}
+/** Whether `source` is newer than `destination`, or the destination is absent. */
+function isStale(source, destination) {
+    try {
+        return fs.statSync(source).mtimeMs > fs.statSync(destination).mtimeMs;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Builds `<name>.app` around the host binary and returns the executable inside
+ * it -- which is what should be launched, because that is what makes
+ * `NSBundle.mainBundle` the bundle.
+ */
+function packageMacos(hostBinary, outputDir, config) {
+    const appDir = path.join(outputDir, `${config.name}.app`);
+    const macosDir = path.join(appDir, 'Contents', 'MacOS');
+    const resourcesDir = path.join(appDir, 'Contents', 'Resources');
+    fs.mkdirSync(macosDir, { recursive: true });
+    fs.mkdirSync(resourcesDir, { recursive: true });
+    // The executable keeps the host's name rather than the app's. It is what
+    // shows in `ps` and in a crash report, and "basalt_appkit" there is more
+    // useful than the app's name, which is already on the bundle.
+    const executableName = path.basename(hostBinary);
+    const executable = path.join(macosDir, executableName);
+    const signed = isStale(hostBinary, executable);
+    if (signed) {
+        fs.copyFileSync(hostBinary, executable);
+        fs.chmodSync(executable, 0o755);
+    }
+    const plistPath = path.join(appDir, 'Contents', 'Info.plist');
+    const plist = infoPlist(config, executableName);
+    const plistChanged = !fs.existsSync(plistPath) || fs.readFileSync(plistPath, 'utf8') !== plist;
+    if (plistChanged) {
+        fs.writeFileSync(plistPath, plist);
+    }
+    // Launch Services caches a bundle's plist aggressively, and an app whose
+    // identifier changed under it keeps the old one until something touches the
+    // directory. Touching it is cheap and the alternative is a stale identity
+    // that looks like a bug in the plist.
+    fs.utimesSync(appDir, new Date(), new Date());
+    // Signed ad hoc, and this is not optional.
+    //
+    // An unsigned bundle has an identifier and still cannot notify: macOS
+    // answers `requestAuthorization` with UNErrorDomain error 1, "notifications
+    // are not allowed", because the identity it would attach the permission to
+    // is not stable. `--sign -` is the ad-hoc identity, needs no developer
+    // account and no keychain, and is enough -- found by the notification
+    // arriving the moment it was applied and not before.
+    //
+    // Only when something changed, because signing walks the whole binary and
+    // the host is tens of megabytes.
+    if (signed || plistChanged) {
+        const result = (0, node_child_process_1.spawnSync)('codesign', ['--force', '--sign', '-', appDir], { encoding: 'utf8' });
+        if (result.status !== 0) {
+            // Not fatal. Everything except notifications works unsigned, and a build
+            // that stopped here would be worse than one that says what is missing.
+            console.warn('==> could not sign the app bundle; notifications will be refused by macOS\n' +
+                `    ${(result.stderr ?? result.error?.message ?? '').trim()}`);
+        }
+    }
+    return { launchPath: executable, appPath: appDir };
+}
+/**
+ * Writes a `.desktop` file for the app and returns where it went.
+ *
+ * Not installed, only written. Putting a file into
+ * `~/.local/share/applications` is a change to the user's session that a build
+ * command should not make on its own; the caller prints the one-line copy that
+ * does it.
+ */
+function packageLinux(hostBinary, outputDir, config) {
+    const fileName = `${config.identifier}.desktop`;
+    const destination = path.join(outputDir, fileName);
+    const mime = config.schemes.map(s => `x-scheme-handler/${s};`).join('');
+    const entry = `[Desktop Entry]\n` +
+        `Type=Application\n` +
+        `Name=${config.name}\n` +
+        `Exec=${hostBinary} %U\n` +
+        `Icon=${config.identifier}\n` +
+        `Terminal=false\n` +
+        `Categories=Utility;\n` +
+        `StartupNotify=true\n` +
+        // The window's own application id, which is what lets the desktop match a
+        // running window to this file -- and so what puts the right name and icon
+        // on its notifications.
+        `StartupWMClass=${config.identifier}\n` +
+        (mime === '' ? '' : `MimeType=${mime}\n`);
+    fs.writeFileSync(destination, entry);
+    return { launchPath: hostBinary, desktopPath: destination };
+}
+/**
+ * Packages `hostBinary` for `platform`, into `outputDir`.
+ *
+ * Returns `{launchPath, ...}`: what to run. On Linux and Windows that is the
+ * binary it was given, because neither makes the application out of where the
+ * executable sits; on macOS it is the copy inside the bundle.
+ */
+/**
+ * Writes what the app calls itself beside the bundle, for the host to read.
+ *
+ * Beside the bundle rather than beside the executable, because the executable
+ * is shared by every app on the machine; and written rather than passed as an
+ * argument, because a Start Menu shortcut clicked in a month carries no
+ * environment. See native/core/AppIdentity.h.
+ */
+function writeIdentity(bundlePath, config) {
+    if (bundlePath == null) {
+        return null;
+    }
+    const destination = path.join(path.dirname(bundlePath), 'app.identity.json');
+    fs.mkdirSync(path.dirname(destination), { recursive: true });
+    fs.writeFileSync(destination, JSON.stringify({
+        name: config.name,
+        identifier: config.identifier,
+        schemes: config.schemes,
+        version: config.version,
+    }, null, 2));
+    return destination;
+}
+function packageApp({ platform, hostBinary, outputDir, projectRoot, bundlePath, }) {
+    const config = readAppConfig(projectRoot);
+    fs.mkdirSync(outputDir, { recursive: true });
+    const identityPath = writeIdentity(bundlePath, config);
+    if (platform === 'macos') {
+        return { config, identityPath, ...packageMacos(hostBinary, outputDir, config) };
+    }
+    if (platform === 'linux') {
+        return { config, identityPath, ...packageLinux(hostBinary, outputDir, config) };
+    }
+    // Windows does its own, in the host: a Start Menu shortcut carrying an
+    // AppUserModelID needs IPropertyStore, and doing that in C++ at startup beats
+    // doing it in PowerShell from here. See win32/Win32Packaging.h.
+    return { config, identityPath, launchPath: hostBinary };
+}
+//# sourceMappingURL=packageApp.js.map

package/dist/cli/packageApp.js.map

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

package/dist/cli/steps.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Already right, changed by this run, needs a person, or could not be asked.
+ *
+ * `unchecked` is the one that earns its place. Whether GTK's headers are
+ * installed is not a question a Mac can answer, and reporting it as passing
+ * would make the command worse than not running it -- while reporting it as
+ * needing a person would send somebody to install GTK on a Mac. It is neither
+ * a failure nor a success, so it is counted as neither.
+ */
+export type StepState = 'done' | 'changed' | 'blocked' | 'unchecked';
+export type Step = {
+    state: StepState;
+    message: string;
+};
+export declare const DONE: StepState;
+export declare const CHANGED: StepState;
+export declare const BLOCKED: StepState;
+export declare const UNCHECKED: StepState;
+export declare function step(state: StepState, message: string): Step;
+/** A step and the name it is reported under. */
+export type NamedStep = [string, Step];
+/**
+ * Prints the steps and answers with the exit code.
+ *
+ * `=` already right, `+` this run changed it, `!` somebody has to, `?` could
+ * not be asked from here. One character rather than a word so that a column of
+ * them reads at a glance, which is the whole reason for reporting steps
+ * instead of just failing.
+ */
+export declare function report(steps: readonly NamedStep[], out: (line: string) => void): {
+    changed: number;
+    blocked: number;
+};
+//# sourceMappingURL=steps.d.ts.map

package/dist/cli/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../cli/steps.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAErE,MAAM,MAAM,IAAI,GAAG;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,SAAkB,CAAC;AACtC,eAAO,MAAM,OAAO,EAAE,SAAqB,CAAC;AAC5C,eAAO,MAAM,OAAO,EAAE,SAAqB,CAAC;AAC5C,eAAO,MAAM,SAAS,EAAE,SAAuB,CAAC;AAEhD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAmBpC"}

package/dist/cli/steps.js

@@ -0,0 +1,53 @@
+"use strict";
+// What a command checked, and how it says so.
+//
+// `init` and `doctor` are the same checks with writing on and off, so they
+// report the same way: a list of named steps, each already right, changed, or
+// needing a person. The summary is written once at the end rather than printed
+// as it goes, because a run that refuses halfway should not have narrated four
+// successes first.
+//
+// This is shared rather than duplicated for the reason the two commands exist
+// separately at all: `doctor` is `init` with its hands behind its back, plus
+// the checks that have no fix. If they drifted into reporting differently, the
+// second would stop being a straight answer about the first.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNCHECKED = exports.BLOCKED = exports.CHANGED = exports.DONE = void 0;
+exports.step = step;
+exports.report = report;
+exports.DONE = 'done';
+exports.CHANGED = 'changed';
+exports.BLOCKED = 'blocked';
+exports.UNCHECKED = 'unchecked';
+function step(state, message) {
+    return { state, message };
+}
+/**
+ * Prints the steps and answers with the exit code.
+ *
+ * `=` already right, `+` this run changed it, `!` somebody has to, `?` could
+ * not be asked from here. One character rather than a word so that a column of
+ * them reads at a glance, which is the whole reason for reporting steps
+ * instead of just failing.
+ */
+function report(steps, out) {
+    let changed = 0;
+    let blocked = 0;
+    const width = steps.reduce((longest, [name]) => Math.max(longest, name.length), 0);
+    for (const [name, outcome] of steps) {
+        const mark = outcome.state === exports.DONE
+            ? '='
+            : outcome.state === exports.CHANGED
+                ? '+'
+                : outcome.state === exports.UNCHECKED
+                    ? '?'
+                    : '!';
+        out(`  ${mark} ${name.padEnd(width)}  ${outcome.message}`);
+        if (outcome.state === exports.CHANGED)
+            changed++;
+        if (outcome.state === exports.BLOCKED)
+            blocked++;
+    }
+    return { changed, blocked };
+}
+//# sourceMappingURL=steps.js.map

package/dist/cli/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../cli/steps.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,mBAAmB;AACnB,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,6DAA6D;;;AAuB7D,oBAEC;AAaD,wBAsBC;AA1CY,QAAA,IAAI,GAAc,MAAM,CAAC;AACzB,QAAA,OAAO,GAAc,SAAS,CAAC;AAC/B,QAAA,OAAO,GAAc,SAAS,CAAC;AAC/B,QAAA,SAAS,GAAc,WAAW,CAAC;AAEhD,SAAgB,IAAI,CAAC,KAAgB,EAAE,OAAe;IACpD,OAAO,EAAC,KAAK,EAAE,OAAO,EAAC,CAAC;AAC1B,CAAC;AAKD;;;;;;;GAOG;AACH,SAAgB,MAAM,CACpB,KAA2B,EAC3B,GAA2B;IAE3B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAEnF,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;QACpC,MAAM,IAAI,GACR,OAAO,CAAC,KAAK,KAAK,YAAI;YACpB,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,eAAO;gBACzB,CAAC,CAAC,GAAG;gBACL,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,iBAAS;oBAC3B,CAAC,CAAC,GAAG;oBACL,CAAC,CAAC,GAAG,CAAC;QACd,GAAG,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,IAAI,OAAO,CAAC,KAAK,KAAK,eAAO;YAAE,OAAO,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,KAAK,KAAK,eAAO;YAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,EAAC,OAAO,EAAE,OAAO,EAAC,CAAC;AAC5B,CAAC"}