@codenotch/codenotch.cli 1.0.39 → 1.0.41

package/dist/utils/OsUtils.d.ts

@@ -5,4 +5,10 @@ export declare class OsUtils {
      * @param url The URL to open.
      */
     static openInBrowser(url: string): void;
+    /**
+     * Opens a folder in the file explorer of the system (Explorer, Finder, the desktop file manager).
+     * Supports Windows, macOS and Linux.
+     * @param folderPath The folder to open.
+     */
+    static openInFileExplorer(folderPath: string): void;
 }

package/dist/utils/OsUtils.js

@@ -28,6 +28,32 @@ class OsUtils {
             }
         });
     }
+    /**
+     * Opens a folder in the file explorer of the system (Explorer, Finder, the desktop file manager).
+     * Supports Windows, macOS and Linux.
+     * @param folderPath The folder to open.
+     */
+    static openInFileExplorer(folderPath) {
+        let command;
+        switch (process.platform) {
+            case 'win32':
+                command = `explorer "${folderPath}"`;
+                break;
+            case 'darwin':
+                command = `open "${folderPath}"`;
+                break;
+            default:
+                // Linux and other Unix-like systems
+                command = `xdg-open "${folderPath}"`;
+                break;
+        }
+        (0, child_process_1.exec)(command, (error) => {
+            // explorer.exe leaves a non-zero exit code even when the window did open: only report elsewhere
+            if (error && process.platform !== 'win32') {
+                console.error(`Failed to open the file explorer: ${error.message}`);
+            }
+        });
+    }
 }
 exports.OsUtils = OsUtils;
 //# sourceMappingURL=OsUtils.js.map

package/dist/utils/OsUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"OsUtils.js","sourceRoot":"","sources":["../../src/utils/OsUtils.ts"],"names":[],"mappings":";;;AAAA,iDAAqC;AAErC,MAAa,OAAO;IAEhB;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,GAAW;QAC5B,IAAI,OAAe,CAAC;QAEpB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvB,KAAK,OAAO;gBACR,OAAO,GAAG,aAAa,GAAG,GAAG,CAAC;gBAC9B,MAAM;YACV,KAAK,QAAQ;gBACT,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC;gBAC1B,MAAM;YACV;gBACI,oCAAoC;gBACpC,OAAO,GAAG,aAAa,GAAG,GAAG,CAAC;gBAC9B,MAAM;QACd,CAAC;QAED,IAAA,oBAAI,EAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,KAAK,EAAE,CAAC;gBACR,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AA7BD,0BA6BC"}
+{"version":3,"file":"OsUtils.js","sourceRoot":"","sources":["../../src/utils/OsUtils.ts"],"names":[],"mappings":";;;AAAA,iDAAqC;AAErC,MAAa,OAAO;IAEhB;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,GAAW;QAC5B,IAAI,OAAe,CAAC;QAEpB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvB,KAAK,OAAO;gBACR,OAAO,GAAG,aAAa,GAAG,GAAG,CAAC;gBAC9B,MAAM;YACV,KAAK,QAAQ;gBACT,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC;gBAC1B,MAAM;YACV;gBACI,oCAAoC;gBACpC,OAAO,GAAG,aAAa,GAAG,GAAG,CAAC;gBAC9B,MAAM;QACd,CAAC;QAED,IAAA,oBAAI,EAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,KAAK,EAAE,CAAC;gBACR,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAkB;QACxC,IAAI,OAAe,CAAC;QAEpB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvB,KAAK,OAAO;gBACR,OAAO,GAAG,aAAa,UAAU,GAAG,CAAC;gBACrC,MAAM;YACV,KAAK,QAAQ;gBACT,OAAO,GAAG,SAAS,UAAU,GAAG,CAAC;gBACjC,MAAM;YACV;gBACI,oCAAoC;gBACpC,OAAO,GAAG,aAAa,UAAU,GAAG,CAAC;gBACrC,MAAM;QACd,CAAC;QAED,IAAA,oBAAI,EAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,gGAAgG;YAChG,IAAI,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACxC,OAAO,CAAC,KAAK,CAAC,qCAAqC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AA1DD,0BA0DC"}

package/dist/utils/PackageUtils.d.ts

@@ -0,0 +1,101 @@
+/** Desktop OSes 'cn react package' can produce an installer for — always the one it runs on */
+export type IPackageTarget = 'windows' | 'linux' | 'macos';
+/**
+ * Desktop installers for the React apps, through Tauri: the static bundle of the app (see
+ * 'cn react build --static') is wrapped into a native window using the webview of the system,
+ * and bundled as an installer — NSIS .exe on Windows, .deb/.AppImage on Linux, .app/.dmg on
+ * macOS. Behind the command: cn react package <app>
+ *
+ * Installers do not cross-compile: each one is built on its own OS (a CI matrix covers the
+ * others). The machine needs the Rust toolchain — installed on demand through rustup when
+ * missing, see {@link PackageUtils.ensureCargo}; everything else (@tauri-apps/cli, the Tauri
+ * crates) is fetched into the staging by npm and cargo.
+ */
+export default abstract class PackageUtils {
+    /**
+     * Packages one React app of a Codenotch project as a desktop installer.
+     *
+     * The flow: check the target and the Rust toolchain (fail fast, the build is long), run the
+     * static build (environment baked in: a native window has no /api/env to fetch), then stage
+     * a generated Tauri project under `.codenotch/<appName>-package`:
+     * - package.json — only @tauri-apps/cli, installed on the first run
+     * - src-tauri/ — Cargo.toml, build.rs, src/main.rs (a bare webview window), tauri.conf.json
+     *   pointing `frontendDist` at the `-dist` folder of the static build
+     * - src-tauri/icons/ — generated by 'tauri icon' from the biggest icon of the `pwa` section
+     *   of the app manifest, or from a placeholder when there is none
+     *
+     * Unlike the build staging, this folder is NOT wiped between runs: cargo caches the compiled
+     * Tauri runtime under src-tauri/target, and only the first build pays the full compilation.
+     * 'cn react clean' deletes it like the other stagings.
+     *
+     * Returns the folder holding the installers on success, undefined otherwise (the reason is
+     * already printed).
+     */
+    static packageReactApp(appFilePath: string, options?: {
+        target?: string;
+        clusterUrl?: string;
+    }): Promise<string | undefined>;
+    /** The OS this process runs on, as a packaging target */
+    static hostTarget(): IPackageTarget;
+    /**
+     * The target actually buildable here: the host OS. An explicit different target is refused
+     * with the CI suggestion — installers do not cross-compile.
+     */
+    private static checkTarget;
+    private static hasCargo;
+    /**
+     * Checks the Rust toolchain, and proposes to install it through rustup when missing (in an
+     * interactive terminal only — elsewhere the manual instructions are printed instead). After
+     * a successful install, ~/.cargo/bin is adopted into the PATH of this process, so the
+     * packaging goes on without a new terminal.
+     */
+    private static ensureCargo;
+    /** Prepends ~/.cargo/bin to the PATH of this process when cargo lives there; true when it does */
+    private static adoptCargoHome;
+    /**
+     * Downloads rustup-init.exe and runs it INTERACTIVELY: when the MSVC build tools are missing,
+     * rustup-init proposes their quick install — the silent '-y' mode would skip that and leave
+     * a toolchain unable to link.
+     */
+    private static installRustWindows;
+    /** The documented one-liner, in its non-interactive form: stable toolchain, default profile */
+    private static installRustUnix;
+    private static printRustHelp;
+    /** The usual causes of a failed 'tauri build', per OS, printed after its own output */
+    private static printBuildHelp;
+    /** 'version' of the project manifest when it looks like x.y.z, or 0.1.0 (installers want numbers) */
+    private static projectVersion;
+    private static serviceName;
+    /** appName as a cargo crate name: lowercase, alphanumerics and underscores, no leading digit */
+    private static crateName;
+    /** A name as a segment of the bundle identifier: lowercase alphanumerics only */
+    private static identifierSegment;
+    private static createStagingPackageJson;
+    private static createCargoToml;
+    private static createBuildRs;
+    /** A bare Tauri app: one window on the static bundle, no API surface at all */
+    private static createMainRs;
+    private static createTauriConf;
+    /**
+     * The best source for the installer icons: the biggest icon of the `pwa` section of the app
+     * manifest, looked up next to the app manifest then from the workspace root, like the PWA
+     * build does. Undefined when the app declares none (or only URLs).
+     */
+    private static findAppIcon;
+    /**
+     * Generates the full icon set (icon.ico, icon.icns, sized pngs) in src-tauri/icons with
+     * 'tauri icon'. Falls back to a generated placeholder when the app has no usable icon, or
+     * when the source is rejected (not square, no alpha channel...). Returns false only when
+     * even the placeholder fails, the reason printed by the tauri CLI itself.
+     */
+    private static generateIcons;
+    /**
+     * A solid-color square PNG (RGBA), built by hand: enough for 'tauri icon', which wants a
+     * square image with an alpha channel, without pulling an image library into the CLI.
+     */
+    private static createPlaceholderIcon;
+    private static pngChunk;
+    private static crc32;
+    /** The installer files tauri bundled, with their size — the raw binary is not one of them */
+    private static listInstallers;
+}