@gamecrate/cli 2.0.0 → 2.2.0

package/dist/lib.js

@@ -334,6 +334,7 @@ var game = obj({
     updates: obj({ check: bool.optional(), everyHours: num.optional() }).optional()
   }).check(requiredWhen("context", (v) => v["acquire"] === "build")),
   executable: str,
+  managed: strArray.optional(),
   steamAppId: num,
   workshopRoot: z.union([z.string(), z.null()], { error: "expected a string or null" }),
   scanRoots: z.array(obj({ path: str, maxDepth: num, exclude: strArray.optional() }), {

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

@@ -1,7 +1,7 @@
 export type BaseKind = 'xvfb' | 'proton' | 'none';
 /**
- * Pinned by digest, never by tag: a rebuilt base would otherwise change under released code.
- * These are the linux/amd64 manifests, not the index a push reports. See landmines.md.
+ * A major tag, so an apt fix in a base reaches a released cli without a new release. Each built
+ * image records the digest this resolved to, which is what makes that safe. See landmines.md.
  */
 export declare const RUNTIME_BASE: Readonly<Record<'xvfb' | 'proton', string>>;
 /**

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

@@ -23,5 +23,10 @@ export declare function cranePush(tar: string, ref: string): Promise<void>;
 /** Runs after the push, never before. A moving tag only moves once the real tag is there. */
 export declare function craneTag(ref: string, tag: string): Promise<void>;
 export declare function craneMutateLabels(ref: string, labels: Record<string, string>): Promise<void>;
+/**
+ * The platform manifest a tag resolves to, so an image records the base it was built on rather
+ * than the moving tag. Never the index digest: that is not what a runtime pulls.
+ */
+export declare function craneDigest(ref: string, platform: string): Promise<string | null>;
 /** null when the image or its config cannot be read. An empty record means no labels. */
 export declare function craneLabels(ref: string): Promise<Record<string, string> | null>;

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

@@ -0,0 +1,23 @@
+import type { GameConfig } from '../types';
+export interface ManagedRefs {
+    /** Holds the .dll files. Reproducible for one image id. */
+    dir: string;
+    /** Stays pointed at the newest extraction for this game, so a csproj can hardcode it. */
+    link: string;
+    /** The image id the assemblies came out of. */
+    digest: string;
+    /** Container path they were found at. */
+    source: string;
+    count: number;
+}
+export declare function refsLink(game: string): string;
+/**
+ * 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.
+ */
+export declare function extractScript(candidates: string[], container: string): string;
+/**
+ * The managed assemblies for a game's image, extracted once per image id. Handing back a
+ * directory keeps <Private>False</Private> the consumer's choice.
+ */
+export declare function extractRefs(game: string, config: GameConfig): Promise<ManagedRefs>;

package/dist/types/mods/modindex.d.ts

@@ -1,5 +1,7 @@
 import type { GamePlugin } from '../plugin';
 import type { GameConfig, ModIndex, ModRecord, Problem, WorktreeRequest } from '../types';
+/** Cache lives outside the profile tree so `clean --all` can never invalidate it. */
+export declare function cacheDir(): string;
 /**
  * `**` spans separators, `*` and `?` do not; everything else is literal. Mod folders are
  * routinely named `[KV] Mod Manager`, so brackets and braces must not be glob syntax.

package/dist/types/types.d.ts

@@ -201,6 +201,7 @@ export interface GameConfig {
     logFile: LogFileSpec;
     image: ImageSpec;
     executable: string;
+    managed?: string[];
     steamAppId: number;
     workshopRoot: string | null;
     scanRoots: ScanRoot[];

package/package.json

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