@gamecrate/cli 2.3.1 → 2.5.0

package/dist/lib.js

@@ -184,6 +184,8 @@ var profile = obj({
   description: str.optional(),
   gameVersion: str.optional(),
   image: str.optional(),
+  windowTitle: str.optional(),
+  windowIcon: str.optional(),
   detach: bool.optional(),
   replace: bool.optional(),
   build: oneOf(["auto", "always", "never"]).optional()

package/dist/types/docker/icon.d.ts

@@ -0,0 +1,7 @@
+/** width, height, then one ARGB cardinal per pixel, which is the shape the spec asks for. */
+export declare function iconProperty(rgba: Buffer, size: number): Buffer;
+/**
+ * The caption is wmctrl's job; an icon is nobody's. xprop truncates a property at 64 elements
+ * and one icon is thousands, so the property goes over the wire here instead.
+ */
+export declare function setWindowIcon(windowId: string, iconPath: string): Promise<void>;

package/dist/types/docker/spec.d.ts

@@ -17,6 +17,8 @@ export declare function buildRunSpec(plan: LaunchPlan, modMounts: Mount[], ident
 /** Instances of one profile run side by side, so the name has to carry which one this is. */
 export declare function containerName(plan: LaunchPlan): string;
 /** What the window is renamed to, so a taskbar full of worktrees is readable. */
+/** The icon a profile names, made absolute against the config that named it. */
+export declare function windowIcon(plan: LaunchPlan, configDir: string): string | undefined;
 export declare function windowTitle(plan: LaunchPlan): string;
 export declare function toDockerArgs(spec: DockerRunSpec): string[];
 /**

package/dist/types/docker/window.d.ts

@@ -32,6 +32,8 @@ export declare function isPeerClaim(pid: number, self: number): boolean;
 export interface AdoptOptions {
     executable: string;
     title: string;
+    /** An image the adopted window takes as its icon. Absolute, already resolved. */
+    icon?: string;
     /** Set for an engine that claims WM_DELETE_WINDOW and ignores it, RimWorld being the one. */
     stripDelete: boolean;
     /** Called once the window a stripDelete run adopted is gone. */

package/dist/types/image/refs.d.ts

@@ -8,9 +8,16 @@ export interface ManagedRefs {
     digest: string;
     /** Container path they were found at. */
     source: string;
+    /** `1.6` from the game's own Version.txt, absent when the image does not ship one. */
+    version?: string;
     count: number;
 }
-export declare function refsLink(game: string): string;
+export declare function refsLink(game: string, version?: string): string;
+/** `1.6.4633 rev1254` in the file, `1.6` as the folder a mod builds into. */
+export declare function readVersion(dir: string): Promise<string | undefined>;
+/** What `current` points at, for a failure message. A build that broke on the wrong game
+ * generation says nothing about refs on its own. */
+export declare function currentRefs(game: string): string | undefined;
 /**
  * First declared directory holding a .dll wins. A bind mount carries the bytes because a cat
  * through stdout corrupts one and busybox tar has no --transform; see landmines.md.

package/dist/types/launch/prepare.d.ts

@@ -1,6 +1,11 @@
 import type { BuildPolicy, GameConfig, LaunchPlan, PullPolicy } from '../types';
 /** Resolved image id, so `launches.jsonl` records what actually ran, not a floating tag. */
 export declare function imageDigest(ref: string): Promise<string | null>;
+/**
+ * The registry digest a local image was pulled at. `.Id` is the config digest and is a different
+ * number, so comparing it against a recorded manifest digest never matches.
+ */
+export declare function repoDigest(ref: string): Promise<string | null>;
 /** One file out of an image, for a fact the host copy would answer wrongly. */
 export declare function readFromImage(ref: string, path: string): Promise<string | null>;
 /** One label off an image, or null when the image or the label is missing. */
@@ -15,7 +20,7 @@ export declare function acquireImage(game: string, config: GameConfig, pull: Pul
  * ones resolution flagged stale; `never` skips. A build failure stops the launch, shipping
  * the previous DLL after a failed compile is how you debug code that is not running.
  */
-export declare function buildLocalMods(plan: LaunchPlan, policy: BuildPolicy): Promise<void>;
+export declare function buildLocalMods(plan: LaunchPlan, policy: BuildPolicy, refsNote?: string): Promise<void>;
 /**
  * Per-instance launch lock. Two concurrent runs would both `rm -rf` the same stage tree, so
  * the second is refused rather than allowed to race. Separate instances never meet here.

package/dist/types/types.d.ts

@@ -167,6 +167,10 @@ export interface ProfileConfig {
     gameVersion?: string;
     /** A whole image ref, used verbatim. Beaten only by --image. */
     image?: string;
+    /** The caption the window takes, instead of "<game> <profile>". */
+    windowTitle?: string;
+    /** A path to an image the window takes as its icon. Relative to the config file. */
+    windowIcon?: string;
     /** Launch defaults for this profile. The matching --no-* flag overrides each one. */
     detach?: boolean;
     replace?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamecrate/cli",
-  "version": "2.3.1",
+  "version": "2.5.0",
   "description": "Run a modded game in a container, with mods resolved from your local checkouts.",
   "license": "MIT",
   "type": "module",