@gamecrate/cli 2.3.0 → 2.4.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()
@@ -242,7 +244,10 @@ function repeats(entries, key) {
   });
   return found;
 }
-var TAG_COMPONENT = /^[A-Za-z0-9_][A-Za-z0-9._-]*$/;
+function describe(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+var TAG_COMPONENT = /^\w[\w.-]*$/;
 function steamBuildRules(ctx) {
   const push = (message, path, suggestion) => {
     ctx.issues.push({
@@ -297,7 +302,7 @@ function steamBuildRules(ctx) {
     const wants = depot === "windows" ? "proton" : "xvfb";
     if (base === wants)
       return;
-    push(`a ${String(depot)} depot cannot run on the "${base}" base`, ["variants", index, "base"], depot === "windows" ? 'set base to "proton"; it is the only base with wine' : 'set base to "xvfb", or set depot to "windows" if the image should run under wine');
+    push(`a ${describe(depot)} depot cannot run on the "${base}" base`, ["variants", index, "base"], depot === "windows" ? 'set base to "proton"; it is the only base with wine' : 'set base to "xvfb", or set depot to "windows" if the image should run under wine');
   });
 }
 var steamBuildSchema = obj({

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

@@ -11,6 +11,9 @@ export interface ManagedRefs {
     count: number;
 }
 export declare function refsLink(game: string): string;
+/** 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/image.d.ts

@@ -1,6 +1,5 @@
 import type { ImageLaunch } from '../docker/spec';
-import type { ModeName, Problem } from '../types';
-import type { GameConfig } from '../types';
+import type { GameConfig, ModeName, Problem } from '../types';
 /** What an image says about itself. Every field is null for an image gamecrate did not build. */
 export interface ImageFacts {
     present: boolean;

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/launch/updates.d.ts

@@ -1,6 +1,5 @@
 import type { ImageFacts } from './image';
-import type { ParsedArgs, RootConfig } from '../types';
-import type { UpdateCheckSpec } from '../types';
+import type { ParsedArgs, RootConfig, UpdateCheckSpec } from '../types';
 export interface CheckInput {
     facts: ImageFacts;
     spec: UpdateCheckSpec | undefined;

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.0",
+  "version": "2.4.0",
   "description": "Run a modded game in a container, with mods resolved from your local checkouts.",
   "license": "MIT",
   "type": "module",