reset-framework-cli 1.2.1 → 1.2.4

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Jan Kordoš
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to do so, subject to the
-following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026 Jan Kordoš
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -1,21 +1,21 @@
-# reset-framework-cli
-
-`reset-framework-cli` is the developer-facing command-line interface for Reset Framework.
-
-## Install
-
-```bash
-npm install -g reset-framework-cli
-```
-
-## Commands
-
-- `reset-framework-cli create-app my-app`
-- `reset-framework-cli dev`
-- `reset-framework-cli build`
-- `reset-framework-cli package`
-- `reset-framework-cli doctor`
-
+# reset-framework-cli
+
+`reset-framework-cli` is the developer-facing command-line interface for Reset Framework.
+
+## Install
+
+```bash
+npm install -g reset-framework-cli
+```
+
+## Commands
+
+- `reset-framework-cli create-app my-app`
+- `reset-framework-cli dev`
+- `reset-framework-cli build`
+- `reset-framework-cli package`
+- `reset-framework-cli doctor`
+
 ## Package boundary
 
 - `reset-framework-cli` orchestrates the framework.
@@ -23,7 +23,7 @@ npm install -g reset-framework-cli
 - `@reset-framework/native` provides the CMake-based runtime source package.
 - `@reset-framework/sdk` provides the frontend bridge package.
 - `@reset-framework/schema` provides the config schema package.
-
+
 ## How it works
 
 - `reset-framework-cli dev` and `reset-framework-cli build` use the bundled runtime package for the current platform by default.
@@ -47,11 +47,11 @@ Source build requirements:
 
 ## Publish model
 
-`reset-framework-cli` should be published only after:
+`reset-framework-cli` belongs to the `core` release target and should be published only after:
 
 1. `@reset-framework/schema`
-2. `@reset-framework/sdk`
-3. `@reset-framework/runtime-darwin-arm64`
-4. `@reset-framework/runtime-darwin-x64`
-5. `@reset-framework/runtime-win32-x64`
-6. `@reset-framework/native`
+2. `@reset-framework/backend`
+3. `@reset-framework/sdk`
+4. `reset-framework-cli`
+
+Runtime packages and `@reset-framework/native` can be published independently when only a single binary target changes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reset-framework-cli",
-  "version": "1.2.1",
+  "version": "1.2.4",
   "type": "module",
   "description": "Command-line tooling for Reset Framework.",
   "license": "MIT",
@@ -11,13 +11,15 @@
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@reset-framework/schema": "1.2.1",
-    "@reset-framework/sdk": "1.2.1"
+    "@reset-framework/backend": "1.2.4",
+    "@reset-framework/schema": "1.2.4",
+    "@reset-framework/sdk": "1.2.4",
+    "esbuild": "^0.25.10"
   },
   "optionalDependencies": {
-    "@reset-framework/runtime-darwin-arm64": "1.2.1",
-    "@reset-framework/runtime-darwin-x64": "1.2.1",
-    "@reset-framework/runtime-win32-x64": "1.2.1"
+    "@reset-framework/runtime-darwin-arm64": ">=1.0.0 <2.0.0",
+    "@reset-framework/runtime-darwin-x64": ">=1.0.0 <2.0.0",
+    "@reset-framework/runtime-win32-x64": ">=1.0.0 <2.0.0"
   },
   "bin": {
     "reset-framework-cli": "src/index.js"

package/src/commands/build.js

@@ -1,131 +1,149 @@
-import { prepareFrameworkRuntime } from "../lib/framework.js"
-import { stageMacOSAppBundle, stageWindowsAppBundle } from "../lib/output.js"
-import { resolvePackageManagerCommand, runCommand } from "../lib/process.js"
-import {
-  assertAppProject,
-  assertFrameworkInstall,
-  loadResetConfig,
-  resolveAppOutputPaths,
-  resolveAppPaths,
-  resolveAppPackageManager,
-  resolveConfigPath,
-  resolveFrontendDir,
-  resolveFrameworkBuildPaths,
-  resolveFrameworkRuntimeStrategy,
-  resolveFrameworkPaths
-} from "../lib/project.js"
-import {
-  createProgress,
-  printBanner,
-  printKeyValueTable,
-  printSection,
-  printStatusTable
-} from "../lib/ui.js"
-
-export const description = "Build the frontend, runtime, and final desktop app bundle"
-
-export async function run(context) {
-  const dryRun = Boolean(context.flags["dry-run"])
-  const skipFrontend = Boolean(context.flags["skip-frontend"])
-  const skipRuntime = Boolean(context.flags["skip-runtime"])
-  const skipStage = Boolean(context.flags["skip-stage"])
+import { prepareFrameworkRuntime } from "../lib/framework.js"
+import { prepareAppBackend } from "../lib/backend.js"
+import { stageMacOSAppBundle, stageWindowsAppBundle } from "../lib/output.js"
+import { resolvePackageManagerCommand, runCommand } from "../lib/process.js"
+import {
+  assertAppProject,
+  assertFrameworkInstall,
+  loadResetConfig,
+  resolveAppOutputPaths,
+  resolveAppPaths,
+  resolveAppPackageManager,
+  resolveConfigPath,
+  resolveFrontendDir,
+  resolveFrameworkBuildPaths,
+  resolveFrameworkRuntimeStrategy,
+  resolveFrameworkPaths,
+  resolveOptionalBackendEntry
+} from "../lib/project.js"
+import {
+  createProgress,
+  printBanner,
+  printKeyValueTable,
+  printSection,
+  printStatusTable
+} from "../lib/ui.js"
+
+export const description = "Build the frontend, runtime, and final desktop app bundle"
+
+export async function run(context) {
+  const dryRun = Boolean(context.flags["dry-run"])
+  const skipFrontend = Boolean(context.flags["skip-frontend"])
+  const skipRuntime = Boolean(context.flags["skip-runtime"])
+  const skipStage = Boolean(context.flags["skip-stage"])
   const preferSource = Boolean(context.flags["runtime-source"])
 
   const appPaths = resolveAppPaths(context.projectRoot)
-  const frameworkPaths = resolveFrameworkPaths()
+  const frameworkPaths = resolveFrameworkPaths({ appRoot: context.projectRoot })
   assertAppProject(appPaths)
   assertFrameworkInstall(frameworkPaths)
-  const config = loadResetConfig(appPaths)
-  assertAppProject(appPaths, config)
-  const packageManager = resolveAppPackageManager(appPaths, config)
-  const outputPaths = resolveAppOutputPaths(appPaths, config)
-  const configPath = resolveConfigPath(appPaths)
-  const frontendDir = resolveFrontendDir(appPaths, config)
-  const frameworkBuildPaths = resolveFrameworkBuildPaths(appPaths)
-  const runtimeStrategy = resolveFrameworkRuntimeStrategy(frameworkPaths, { preferSource })
-  const steps = [
-    !skipFrontend ? "Build frontend" : null,
-    !skipRuntime ? "Prepare runtime" : null,
-    !skipStage ? "Stage desktop bundle" : null
-  ].filter(Boolean)
-
-  printBanner("reset-framework-cli build", description)
-  printSection("Project")
-  printKeyValueTable([
-    ["Config", configPath],
-    ["Frontend", frontendDir],
-    ["Package manager", packageManager],
-    ["Output", outputPaths.appBundlePath],
-    ["Runtime", `${runtimeStrategy.kind === "prebuilt" ? "bundled" : "source"} (${runtimeStrategy.label})`]
-  ])
-  console.log("")
-
-  printSection("Plan")
-  printStatusTable([
-    [skipFrontend ? "skip" : "ready", "Frontend", skipFrontend ? "Skipping frontend build" : "Build static frontend assets"],
-    [
-      skipRuntime ? "skip" : "ready",
-      "Runtime",
-      skipRuntime
-        ? (runtimeStrategy.kind === "prebuilt" ? "Reuse the bundled runtime package" : "Skip the source runtime build")
-        : (runtimeStrategy.kind === "prebuilt" ? "Use the bundled runtime package" : "Configure and build the runtime from source")
-    ],
-    [skipStage ? "skip" : "ready", "Bundle", skipStage ? "Skipping app bundle staging" : "Assemble the final desktop app bundle"]
-  ])
-
-  if (dryRun) {
-    console.log("")
-    printSection("Dry run")
-    printStatusTable(
-      steps.length > 0
-        ? steps.map((step) => ["plan", step, "No changes will be written"])
-        : [["warn", "Nothing to do", "All build phases were skipped"]]
-    )
-    return
-  }
-
-  if (steps.length === 0) {
-    console.log("")
-    printSection("Result")
-    printStatusTable([["warn", "Nothing to do", "All build phases were skipped"]])
-    return
-  }
-
-  console.log("")
-  const progress = createProgress(steps.length, "Build")
-
-  if (!skipFrontend) {
-    await runCommand(resolvePackageManagerCommand(packageManager), ["run", "build"], {
-      cwd: frontendDir,
-      dryRun
-    })
-    progress.tick("Frontend assets built")
-  }
-
-  if (!skipRuntime) {
-    const preparedRuntime = await prepareFrameworkRuntime(frameworkPaths, frameworkBuildPaths, "release", {
-      cwd: appPaths.appRoot,
-      dryRun,
-      preferSource
-    })
-    progress.tick(preparedRuntime.kind === "prebuilt" ? "Bundled runtime ready" : "Native runtime built")
-  }
-
-  if (!skipStage) {
-    const stageBundle = process.platform === "win32" ? stageWindowsAppBundle : stageMacOSAppBundle
-    await stageBundle(frameworkPaths, frameworkBuildPaths, config, {
-      dryRun,
-      outputPaths,
-      configPath,
-      preferSource
-    })
-    progress.tick("Desktop app bundle staged")
-  }
-
-  console.log("")
-  printSection("Result")
-  printStatusTable([
-    ["done", "Build output", outputPaths.outputRoot],
-    ["done", "Desktop app", outputPaths.appBundlePath]
-  ])
-}
+  const config = loadResetConfig(appPaths)
+  assertAppProject(appPaths, config)
+  const packageManager = resolveAppPackageManager(appPaths, config)
+  const outputPaths = resolveAppOutputPaths(appPaths, config)
+  const configPath = resolveConfigPath(appPaths)
+  const frontendDir = resolveFrontendDir(appPaths, config)
+  const backendEntry = resolveOptionalBackendEntry(appPaths)
+  const frameworkBuildPaths = resolveFrameworkBuildPaths(appPaths)
+  const runtimeStrategy = resolveFrameworkRuntimeStrategy(frameworkPaths, { preferSource })
+  const steps = [
+    !skipFrontend ? "Build frontend" : null,
+    !skipRuntime ? "Prepare runtime" : null,
+    !skipStage && backendEntry ? "Bundle backend sidecar" : null,
+    !skipStage ? "Stage desktop bundle" : null
+  ].filter(Boolean)
+
+  printBanner("reset-framework-cli build", description)
+  printSection("Project")
+  printKeyValueTable([
+    ["Config", configPath],
+    ["Frontend", frontendDir],
+    ["Backend", backendEntry ?? "not configured"],
+    ["Package manager", packageManager],
+    ["Output", outputPaths.appBundlePath],
+    ["Runtime", `${runtimeStrategy.kind === "prebuilt" ? "bundled" : "source"} (${runtimeStrategy.label})`]
+  ])
+  console.log("")
+
+  printSection("Plan")
+  printStatusTable([
+    [skipFrontend ? "skip" : "ready", "Frontend", skipFrontend ? "Skipping frontend build" : "Build static frontend assets"],
+    [
+      skipRuntime ? "skip" : "ready",
+      "Runtime",
+      skipRuntime
+        ? (runtimeStrategy.kind === "prebuilt" ? "Reuse the bundled runtime package" : "Skip the source runtime build")
+        : (runtimeStrategy.kind === "prebuilt" ? "Use the bundled runtime package" : "Configure and build the runtime from source")
+    ],
+    [
+      backendEntry && !skipStage ? "ready" : "skip",
+      "Backend",
+      backendEntry && !skipStage ? "Bundle the optional TypeScript sidecar backend" : "No backend staging is required"
+    ],
+    [skipStage ? "skip" : "ready", "Bundle", skipStage ? "Skipping app bundle staging" : "Assemble the final desktop app bundle"]
+  ])
+
+  if (dryRun) {
+    console.log("")
+    printSection("Dry run")
+    printStatusTable(
+      steps.length > 0
+        ? steps.map((step) => ["plan", step, "No changes will be written"])
+        : [["warn", "Nothing to do", "All build phases were skipped"]]
+    )
+    return
+  }
+
+  if (steps.length === 0) {
+    console.log("")
+    printSection("Result")
+    printStatusTable([["warn", "Nothing to do", "All build phases were skipped"]])
+    return
+  }
+
+  console.log("")
+  const progress = createProgress(steps.length, "Build")
+
+  let backendArtifact = null
+
+  if (!skipFrontend) {
+    await runCommand(resolvePackageManagerCommand(packageManager), ["run", "build"], {
+      cwd: frontendDir,
+      dryRun
+    })
+    progress.tick("Frontend assets built")
+  }
+
+  if (!skipRuntime) {
+    const preparedRuntime = await prepareFrameworkRuntime(frameworkPaths, frameworkBuildPaths, "release", {
+      cwd: appPaths.appRoot,
+      dryRun,
+      preferSource
+    })
+    progress.tick(preparedRuntime.kind === "prebuilt" ? "Bundled runtime ready" : "Native runtime built")
+  }
+
+  if (!skipStage && backendEntry) {
+    backendArtifact = await prepareAppBackend(frameworkPaths, appPaths, "release")
+    progress.tick("Backend sidecar bundled")
+  }
+
+  if (!skipStage) {
+    const stageBundle = process.platform === "win32" ? stageWindowsAppBundle : stageMacOSAppBundle
+    await stageBundle(frameworkPaths, frameworkBuildPaths, config, {
+      dryRun,
+      outputPaths,
+      configPath,
+      preferSource,
+      backendArtifact
+    })
+    progress.tick("Desktop app bundle staged")
+  }
+
+  console.log("")
+  printSection("Result")
+  printStatusTable([
+    ["done", "Build output", outputPaths.outputRoot],
+    ["done", "Desktop app", outputPaths.appBundlePath]
+  ])
+}