pixelkiln 0.53.4 → 0.54.0

package/dist/cli.js

@@ -653,6 +653,8 @@ function specHash(spec, styleImageHashes, providerOptionIdentity = spec.provider
       tileView: spec.tileView,
       tileFeature: spec.tileFeature,
       outlineMode: spec.outlineMode,
+      isometricTileSize: spec.isometricTileSize,
+      isometricTileShape: spec.isometricTileShape,
       styleImages: styleImageHashes,
       // A character family: the engine and rotations of a base, the parent's
       // generated bytes for a state or animation (so a regenerated parent
@@ -707,7 +709,7 @@ import path2 from "path";
 // src/types.ts
 import { z } from "zod";
 var MediaTypeSchema = z.enum(["image/png", "image/gif"]);
-var GeneratorSchema = z.enum(["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro"]);
+var GeneratorSchema = z.enum(["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile"]);
 var GridConfidenceSchema = z.enum(["low", "medium", "high"]);
 var RevisionModeSchema = z.enum(["image-to-image", "inpaint", "outpaint"]);
 function tileVariationCount(descriptions) {
@@ -741,6 +743,9 @@ function tilesCost(tileSize, variations) {
   if (px <= 2048) return 25;
   return 40;
 }
+function isometricTileCost() {
+  return 1;
+}
 function terrainTileCount(transitionSize) {
   return transitionSize === 1 ? 25 : 16;
 }
@@ -1070,6 +1075,20 @@ var StyleObjectSchema = z.object({
   /** `terrain` generator only. Camera angle; the API default is `high
    *  top-down`. */
   terrainView: z.enum(["low top-down", "high top-down"]).optional(),
+  /**
+   * `isometricTile` generator only. `/create-isometric-tile`'s own tile
+   * grid size, distinct from `size` (the generation canvas, 16-64px — the
+   * API's own guidance is that sizes above 24px "often produce better
+   * quality results"). The API default is 16.
+   */
+  isometricTileSize: z.union([z.literal(16), z.literal(32)]).optional(),
+  /**
+   * `isometricTile` generator only. Vertical thickness, i.e. how much
+   * height/elevation variation the tile can represent on a map: `"thin
+   * tile"` (~15% of canvas height), `"thick tile"` (~25%), or `"block"`
+   * (~50%, the API default).
+   */
+  isometricTileShape: z.enum(["thin tile", "thick tile", "block"]).optional(),
   /**
    * `pixflux` only. Whether to strip the generated background.
    *
@@ -5249,6 +5268,15 @@ var TilesetGetSchema = z2.object({
   }).passthrough(),
   usage: UsageSchema
 }).passthrough();
+var IsometricTileSubmitSchema = z2.object({
+  tile_id: z2.string().min(1),
+  background_job_id: z2.string().min(1),
+  status: z2.literal("processing").default("processing")
+}).passthrough();
+var IsometricTileGetSchema = z2.object({
+  image: z2.object({ base64: z2.string().min(1), format: z2.string().default("png") }).passthrough(),
+  usage: UsageSchema
+}).passthrough();
 var RevisionJobSubmitSchema = z2.object({
   background_job_id: z2.string().min(1),
   status: z2.string().default("processing")
@@ -5534,6 +5562,33 @@ var PixelLabClient = class {
     );
     return { tileset: res.tileset, usage: res.usage ?? null };
   }
+  /** A single standalone isometric tile — no connectable set, no candidates. */
+  async createIsometricTile(args) {
+    const body = { description: args.description };
+    if (args.imageWidth != null && args.imageHeight != null) {
+      body.image_size = { width: args.imageWidth, height: args.imageHeight };
+    }
+    if (args.tileSize != null) body.isometric_tile_size = args.tileSize;
+    if (args.tileShape) body.isometric_tile_shape = args.tileShape;
+    if (args.outline) body.outline = args.outline;
+    if (args.shading) body.shading = args.shading;
+    if (args.detail) body.detail = args.detail;
+    if (args.seed != null) body.seed = args.seed;
+    return validateResponse(
+      IsometricTileSubmitSchema,
+      await this.request("/create-isometric-tile", { method: "POST", body: JSON.stringify(body) }),
+      "create isometric tile"
+    );
+  }
+  /** Throws PixelLabError(423) while the tile is still processing. */
+  async getIsometricTile(tileId) {
+    const res = await validateResponse(
+      IsometricTileGetSchema,
+      await this.request(`/isometric-tiles/${tileId}`),
+      "get isometric tile"
+    );
+    return { image: res.image, usage: res.usage ?? null };
+  }
   /**
    * Synchronous single-image generation. Returns the PNG inline rather than a
    * job id, and is the only endpoint that honours a forced palette;
@@ -6000,7 +6055,7 @@ var PixelLabProvider = class _PixelLabProvider {
     return new _PixelLabProvider(new PixelLabClient("download-only"));
   }
   supports(generator) {
-    return generator === "1dir" || generator === "map" || generator === "pixflux" || generator === "tiles" || generator === "terrain" || generator === "imagePro" || generator === "character";
+    return generator === "1dir" || generator === "map" || generator === "pixflux" || generator === "tiles" || generator === "terrain" || generator === "imagePro" || generator === "character" || generator === "isometricTile";
   }
   /**
    * `inpaint` (`/inpaint-v3`, a mask) and `image-to-image` (`/edit-images-v2`,
@@ -6036,7 +6091,7 @@ var PixelLabProvider = class _PixelLabProvider {
       const height = spec.revision.sourceHeight ?? spec.height;
       return { unit: "generations", amount: generationCost(width, height, "1dir"), candidates: 1 };
     }
-    if (spec.generator === "tiles" || spec.generator === "terrain") {
+    if (spec.generator === "tiles" || spec.generator === "terrain" || spec.generator === "isometricTile") {
       return { unit: "generations", amount: spec.cost, candidates: spec.candidates };
     }
     if (spec.generator === "character") {
@@ -6067,19 +6122,19 @@ var PixelLabProvider = class _PixelLabProvider {
       );
     }
     if (spec.generator === "map") {
-      requirePixelLabOption("view", spec.view, ["low top-down", "high top-down", "side"]);
-      requirePixelLabOption("outline", spec.outline, [
+      requirePixelLabOption("map", "view", spec.view, ["low top-down", "high top-down", "side"]);
+      requirePixelLabOption("map", "outline", spec.outline, [
         "single color outline",
         "selective outline",
         "lineless"
       ]);
-      requirePixelLabOption("shading", spec.shading, [
+      requirePixelLabOption("map", "shading", spec.shading, [
         "flat shading",
         "basic shading",
         "medium shading",
         "detailed shading"
       ]);
-      requirePixelLabOption("detail", spec.detail, [
+      requirePixelLabOption("map", "detail", spec.detail, [
         "low detail",
         "medium detail",
         "high detail"
@@ -6087,7 +6142,7 @@ var PixelLabProvider = class _PixelLabProvider {
     }
     if (spec.generator === "terrain") {
       if (spec.outline) {
-        requirePixelLabOption("outline", spec.outline, [
+        requirePixelLabOption("terrain", "outline", spec.outline, [
           "single color black outline",
           "single color outline",
           "selective outline",
@@ -6095,7 +6150,7 @@ var PixelLabProvider = class _PixelLabProvider {
         ]);
       }
       if (spec.shading) {
-        requirePixelLabOption("shading", spec.shading, [
+        requirePixelLabOption("terrain", "shading", spec.shading, [
           "flat shading",
           "basic shading",
           "medium shading",
@@ -6104,7 +6159,7 @@ var PixelLabProvider = class _PixelLabProvider {
         ]);
       }
       if (spec.detail) {
-        requirePixelLabOption("detail", spec.detail, ["low detail", "medium detail", "highly detailed"]);
+        requirePixelLabOption("terrain", "detail", spec.detail, ["low detail", "medium detail", "highly detailed"]);
       }
       if (spec.terrainShapeStyle && spec.terrainMode === "pro") {
         throw new Error(
@@ -6125,6 +6180,30 @@ var PixelLabProvider = class _PixelLabProvider {
         );
       }
     }
+    if (spec.generator === "isometricTile") {
+      if (spec.outline) {
+        requirePixelLabOption("isometricTile", "outline", spec.outline, [
+          "single color outline",
+          "selective outline",
+          "lineless"
+        ]);
+      }
+      if (spec.shading) {
+        requirePixelLabOption("isometricTile", "shading", spec.shading, [
+          "flat shading",
+          "basic shading",
+          "medium shading",
+          "detailed shading",
+          "highly detailed shading"
+        ]);
+      }
+      if (spec.detail) {
+        requirePixelLabOption("isometricTile", "detail", spec.detail, ["low detail", "medium detail", "highly detailed"]);
+      }
+      if (spec.width < 16 || spec.width > 64) {
+        throw new Error(`PixelLab isometricTile: size must be 16 to 64 pixels, got ${spec.width}`);
+      }
+    }
     if (spec.generator === "character") this.validateCharacter(spec, styleImages);
     if ((spec.generator === "map" || spec.generator === "pixflux") && styleImages.length) {
       throw new Error(`PixelLab ${spec.generator} does not support style images`);
@@ -6139,6 +6218,11 @@ var PixelLabProvider = class _PixelLabProvider {
         "PixelLab imagePro does not support style images yet; /generate-image-v2's own reference_images and style_image are not modeled here"
       );
     }
+    if (spec.generator === "isometricTile" && styleImages.length) {
+      throw new Error(
+        "PixelLab isometricTile does not support style images; /create-isometric-tile has no such field (its own init_image/color_image are not modeled here yet)"
+      );
+    }
     for (const image of styleImages) {
       if (image.width > 256 || image.height > 256) {
         throw new Error(
@@ -6521,6 +6605,20 @@ var PixelLabProvider = class _PixelLabProvider {
       });
       return { jobId: res2.tileset_id, metadata: { backgroundJobId: res2.background_job_id } };
     }
+    if (spec.generator === "isometricTile") {
+      const res2 = await this.client.createIsometricTile({
+        description: spec.prompt,
+        imageWidth: spec.width,
+        imageHeight: spec.height,
+        tileSize: spec.isometricTileSize,
+        tileShape: spec.isometricTileShape,
+        outline: spec.outline,
+        shading: spec.shading,
+        detail: spec.detail,
+        seed: spec.seed
+      });
+      return { jobId: res2.tile_id, metadata: { backgroundJobId: res2.background_job_id } };
+    }
     if (spec.generator === "imagePro") {
       const res2 = await this.client.createImagePro({
         description: spec.prompt,
@@ -6637,6 +6735,7 @@ var PixelLabProvider = class _PixelLabProvider {
     if (generator === "map") return this.pollMap(jobId, context);
     if (generator === "tiles") return this.pollTiles(jobId, Boolean(context?.tileFeature), context);
     if (generator === "terrain") return this.pollTerrain(jobId, context);
+    if (generator === "isometricTile") return this.pollIsometricTile(jobId, context);
     if (generator === "imagePro") return this.pollImagePro(jobId);
     if (generator === "character") return this.pollCharacter(jobId, context);
     const backgroundJobId = context?.metadata?.backgroundJobId;
@@ -6847,6 +6946,31 @@ var PixelLabProvider = class _PixelLabProvider {
       throw err;
     }
   }
+  /**
+   * `/create-isometric-tile` reports progress the same way `/create-tileset`
+   * does (423 while drawing, 200 once finished, no `status` field to poll),
+   * and its image also comes back embedded as base64 rather than a
+   * `storage_urls` link. One call is one tile with nothing to review, so
+   * this goes straight to "ready" like a connectable `tiles`/`terrain` set.
+   */
+  async pollIsometricTile(tileId, context) {
+    try {
+      const { image, usage } = await this.client.getIsometricTile(tileId);
+      const backgroundJobId = context?.metadata?.backgroundJobId;
+      const billed = billedFromUsage(usage) ?? await this.billedForJob(backgroundJobId);
+      const file = path12.join(_PixelLabProvider.cacheDir(), `${tileId}.png`);
+      writeFileSync(file, Buffer.from(image.base64, "base64"));
+      return {
+        status: "ready",
+        objectId: tileId,
+        sourceUrl: `file://${file}`,
+        billed
+      };
+    } catch (err) {
+      if (err instanceof PixelLabError && err.status === 423) return { status: "processing" };
+      throw err;
+    }
+  }
   async selectCandidate(jobId, index, commonTag, generator) {
     if (generator === "tiles") {
       const set = await this.client.getTilesPro(jobId);
@@ -6963,9 +7087,9 @@ function remoteCharacter(character) {
     animationCount: character.animation_count
   };
 }
-function requirePixelLabOption(name, value, allowed) {
+function requirePixelLabOption(generator, name, value, allowed) {
   if (value != null && !allowed.includes(value)) {
-    throw new Error(`PixelLab map ${name} must be one of: ${allowed.join(", ")}`);
+    throw new Error(`PixelLab ${generator} ${name} must be one of: ${allowed.join(", ")}`);
   }
 }
 function tilesInIndexOrder(urls) {
@@ -8206,6 +8330,10 @@ async function resolveSpecs(loaded, filter) {
         size = style.terrainTileSize ?? 16;
         width = size;
         height = size;
+      } else if (generator === "isometricTile") {
+        size = asset.size ?? style.size ?? 32;
+        width = size;
+        height = size;
       } else {
         width = asset.width ?? style.size ?? 64;
         height = asset.height ?? style.size ?? 64;
@@ -8299,8 +8427,10 @@ async function resolveSpecs(loaded, filter) {
         terrainRaggedness: generator === "terrain" ? style.terrainRaggedness : void 0,
         terrainTransitionSize: generator === "terrain" ? style.terrainTransitionSize : void 0,
         terrainView: generator === "terrain" ? style.terrainView : void 0,
+        isometricTileSize: generator === "isometricTile" ? style.isometricTileSize : void 0,
+        isometricTileShape: generator === "isometricTile" ? style.isometricTileShape : void 0,
         ...generator === "character" ? { character: await resolveCharacterShape(asset, style, characterKind, { root, load: loadStyleImage }) } : {},
-        cost: generator === "tiles" ? tilesCost(tileSize, tileVariations) : generator === "terrain" ? tilesCost(size, terrainTiles) : generationCost(width, height, generator),
+        cost: generator === "tiles" ? tilesCost(tileSize, tileVariations) : generator === "terrain" ? tilesCost(size, terrainTiles) : generator === "isometricTile" ? isometricTileCost() : generationCost(width, height, generator),
         costUnit: "generations",
         candidates: generator === "tiles" ? tileVariations : generator === "terrain" ? terrainTiles : generator === "1dir" || generator === "imagePro" ? candidateCount(size) : 1
       };