@lakutata/builder 3.1.1 → 3.1.5

package/dist/types/lib/nwjs/Stage.d.ts

@@ -0,0 +1,104 @@
+import { type BundleResult } from '../Bundle.js';
+import { type NwjsRelease } from './Runtime.js';
+import { type NwjsAddons } from './Addons.js';
+/**
+ * The NW.js of an application: the "lakutata.nwjs" of its package.json
+ */
+export type NwjsConfig = {
+    /**
+     * The version of NW.js: a version (0.119.2), latest, or win7 (0.72.0, the last one running on Windows 7, 8 and 8.1)
+     */
+    version: string;
+    /**
+     * The name of the application in NW.js, which names the directory of its data: the appId of its installer, else the
+     * name of its package (in lower case)
+     */
+    name?: string;
+    /**
+     * The arguments given to Chromium (the "chromium-args" of the manifest of NW.js)
+     */
+    chromiumArgs?: string;
+};
+/**
+ * The options of {@link stageNwjsApp}
+ */
+export type NwjsStageOptions = {
+    /**
+     * The directory of the application (its package.json), the current one by default
+     */
+    project?: string;
+    /**
+     * The directory of the application of NW.js made
+     */
+    outdir: string;
+    /**
+     * The version of NW.js, the one of lakutata.nwjs by default
+     */
+    version?: string;
+    /**
+     * The compiled entry of the application (the "main" of the package.json by default)
+     */
+    entry?: string;
+    /**
+     * Minify the bundle (false by default)
+     */
+    minify?: boolean;
+    /**
+     * The modules left out of the bundle
+     */
+    external?: string[];
+    /**
+     * The system of the runtime (process.platform), the one of the machine by default
+     */
+    platform?: NodeJS.Platform;
+    /**
+     * The architecture of the runtime (process.arch), the one of the machine by default (x64 on a Mac with Apple silicon
+     * for the releases without osx-arm64)
+     */
+    arch?: string;
+};
+/**
+ * The application of NW.js made by {@link stageNwjsApp}
+ */
+export type NwjsStage = {
+    /**
+     * Its directory: its manifest (package.json), its background script (main.js), the bundle of the application (app.cjs),
+     * its native tree (app.native) and its resources (resources)
+     */
+    directory: string;
+    /**
+     * The release of NW.js it is made for
+     */
+    release: NwjsRelease;
+    /**
+     * Its name in NW.js (the directory of its data)
+     */
+    name: string;
+    /**
+     * The build of NW.js it is made for (win-x64, osx-arm64…)
+     */
+    platform: string;
+    bundle: BundleResult;
+    /**
+     * What was done to its native addons to load them in NW.js
+     */
+    addons: NwjsAddons;
+};
+/**
+ * The NW.js of an application, from the "lakutata.nwjs" of its package.json
+ * @param manifest
+ */
+export declare function nwjsConfig(manifest: Record<string, any>): NwjsConfig;
+/**
+ * Make the application of NW.js of a project: its bundle (CommonJS, for the Node.js of the release), its native tree
+ * and its resources (lakutata.resources), the manifest of NW.js (its name, its background script, the partition of the
+ * webviews holding its user interface) and the background script running the bundle
+ * @param options
+ * @example
+ * import {stageNwjsApp} from '@lakutata/builder'
+ *
+ * //The application of the development, run by: nw .nwjs/app
+ * const stage = await stageNwjsApp({outdir: '.nwjs/app'})
+ * console.log(stage.directory, stage.release.version, stage.name)
+ */
+export declare function stageNwjsApp(options: NwjsStageOptions): Promise<NwjsStage>;

package/dist/types/lib/win/Windows.d.ts

@@ -1,10 +1,38 @@
 import type { InstallerPlan } from '../Installer.js';
+import type { InstallerHook } from '../Scripts.js';
 /**
  * The installers of Windows: the installer of NSIS (.exe), the package of Windows Installer (.msi), the zip archive of
  * the directory of the executable
  */
 export declare const WINDOWS_TARGETS: readonly ["nsis", "msi", "zip"];
 export type WindowsTarget = typeof WINDOWS_TARGETS[number];
+/**
+ * The script of NSIS of the installer: its files in Program Files, its uninstaller registered, its script run (the
+ * service of the version it replaces stopped first, its files being replaced); the scripts of the application run from
+ * its temporary directory (the preinstall one before its files are installed, the postinstall one before the service
+ * starts, the preremove one once it is stopped, the postremove one once the files are removed), the macros of the file
+ * of NSIS it includes inserted
+ * @param plan
+ * @param stage the files it installs
+ * @param file
+ * @param scripts the scripts of the application (written with the mark of UTF-8, which Windows PowerShell reads them by)
+ * @internal
+ */
+export declare function nsisScript(plan: InstallerPlan, stage: string, file: string, scripts: {
+    hooks: Partial<Record<InstallerHook, string>>;
+    include?: string;
+}): string;
+/**
+ * The source of WiX of the package: its files (a component each, their directories), its service (WinSW) installed,
+ * started, stopped and removed by Windows Installer, its PATH, its data in ProgramData (its environment file kept by
+ * the upgrades and the removals), the versions replaced by the upgrades
+ * @param plan
+ * @param stage the files it installs
+ * @param serviceDirectory the files of its service (WinSW and its configuration)
+ * @param environment the environment file
+ * @internal
+ */
+export declare function wixSource(plan: InstallerPlan, stage: string, serviceDirectory: string, environment: string | undefined): string;
 /**
  * Make the installers of Windows of an application: the installer of NSIS, the package of Windows Installer (WiX), the
  * zip archive of the directory of the executable; its service run by WinSW

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lakutata/builder",
-  "version": "3.1.1",
+  "version": "3.1.5",
   "description": "The builder of the applications of the lakutata framework: their bundles, their executables (Node.js, Bun) with their native addons and their resources.",
   "keywords": [
     "lakutata",
@@ -60,7 +60,7 @@
     }
   },
   "engines": {
-    "node": "^22.13.0 || >=24.11.0"
+    "node": ">=18.10.0"
   },
   "license": "MIT",
   "files": [