pixelkiln 0.86.3 → 0.87.0

package/dist/index.js

@@ -35,17 +35,24 @@ function candidateCount(size) {
 }
 function generationCost(width, height, generator = "map") {
   if (generator === "map" || generator === "pixflux") return 1;
-  if (generator === "imagePro") return 40;
+  if (generator === "imagePro") return proTierCost(width, height);
   const px = width * height;
-  if (px <= 1024) return 20;
-  if (px <= 2048) return 25;
-  return 40;
+  if (px <= 1024) return PRO_TIER_PRICES[0];
+  if (px <= 2048) return PRO_TIER_PRICES[1];
+  return PRO_TIER_PRICES[2];
+}
+var PRO_TIER_PRICES = [10, 15, 25];
+function proTierCost(width, height) {
+  const px = width * height;
+  if (px <= 65536) return PRO_TIER_PRICES[0];
+  if (px <= 102400) return PRO_TIER_PRICES[1];
+  return PRO_TIER_PRICES[2];
 }
 function tilesCost(tileSize, variations) {
   const px = tileSize * tileSize * Math.max(1, variations);
-  if (px <= 1024) return 20;
-  if (px <= 2048) return 25;
-  return 40;
+  if (px <= 1024) return PRO_TIER_PRICES[0];
+  if (px <= 2048) return PRO_TIER_PRICES[1];
+  return PRO_TIER_PRICES[2];
 }
 function isometricTileCost() {
   return 1;
@@ -561,7 +568,7 @@ var MEMBER_SET_REVISION_MODES = ["reduce-colors", "correct-pixelart", "edit-anim
 var StyleObjectSchema = z.object({
   /** Generation backend for this style. Omit to inherit the manifest default. */
   provider: z.string().min(1).optional(),
-  // `map` is the default because it is 20-40x cheaper and correct for any
+  // `map` is the default because it is 10-25x cheaper and correct for any
   // asset that is not going to be rotated or animated.
   generator: GeneratorSchema.default("map"),
   /** Square edge length. The active provider owns its exact limit. */
@@ -2384,7 +2391,8 @@ var PixelLabClient = class {
    * A full-body sprite in, a bust portrait out (or the reverse, unused
    * today). Job-based like a state or `1dir`, not the couple-generations
    * "conversion" the name suggests: the smallest `resultSize` (16px) billed
-   * 20 generations live (docs/ENDPOINTS.md, "Characters, measured").
+   * 20 generations live (docs/ENDPOINTS.md, "Characters, measured"), the
+   * Pro floor before PixelLab's October 2026 cut put it at 10.
    */
   async createPortraitCharacterPro(args) {
     const raw = await this.request("/portrait-character-pro", {
@@ -2423,7 +2431,8 @@ var PixelLabClient = class {
    * everything else here, but the completed job returns the result frames
    * inline as base64 (`last_response.quantized_images`), not as storage
    * URLs — the one PixelLab character tool that works this way. A live
-   * 2-frame, 92x92 job billed 20 generations (docs/ENDPOINTS.md).
+   * 2-frame, 92x92 job billed 20 generations (docs/ENDPOINTS.md), before
+   * PixelLab's October 2026 Pro cut halved that floor to 10.
    */
   async transferOutfitV2(args) {
     const image = (img) => ({
@@ -2473,7 +2482,9 @@ var PixelLabClient = class {
    * far higher than this tiering assumes; 352x352 (123904px²), 384x384
    * (147456px²), and 512x512 (262144px², the tiering ceiling) all billed
    * 40. Both breakpoints are now tightly bracketed: 20->25 in
-   * (65536px², 82944px²], 25->40 in (102400px², 123904px²].
+   * (65536px², 82944px²], 25->40 in (102400px², 123904px²]. Those prices
+   * predate PixelLab's October 2026 Pro cut to 10/15/25; `proTierCost`
+   * keeps the breakpoints with the new prices.
    * `editImagesV2` below returns the same fields under `images`, plural
    * and array-wrapped, not `image` — do not assume the two endpoints share
    * one response shape. See docs/ENDPOINTS.md and docs/REVISIONS.md for
@@ -2526,8 +2537,9 @@ var PixelLabClient = class {
     );
   }
   /**
-   * PixelLab's Pro image tier, `/generate-image-v2`: a flat 40 generations
-   * (docs/ENDPOINTS.md, "Single-image generators, measured") for real style
+   * PixelLab's Pro image tier, `/generate-image-v2`: 10 to 25 generations by
+   * canvas since PixelLab's October 2026 Pro cut, a flat 40 before
+   * (docs/ENDPOINTS.md, "Single-image generators, measured"), for real style
    * transfer and non-square canvases up to 792x688, where `pixflux` is
    * limited to 400x400 and no style reference. Like a revision, this hands
    * back a plain background job with no resource of its own; unlike a
@@ -2613,6 +2625,24 @@ var PixelLabClient = class {
       "inpaint-image-pro-flash"
     );
   }
+  /**
+   * `/image-to-pixelart-pro-flash`: a photo, painting, or render in, pixel
+   * art out, with no size to pass: PixelLab detects the native pixel scale
+   * and picks the output size (a 256x256 render came back 108x109, on a
+   * transparent background). A flat 6 generations, billed exactly that live
+   * in October 2026. Sources over 2048px on the longer side are scaled down
+   * upstream. The finished job carries the image at `last_response.images[0]`.
+   */
+  async imageToPixelartProFlash(args) {
+    const body = { image: args.image };
+    if (args.description) body.description = args.description;
+    if (args.seed != null) body.seed = args.seed;
+    return validateResponse(
+      ProFlashImageSubmitSchema,
+      await this.request("/image-to-pixelart-pro-flash", { method: "POST", body: JSON.stringify(body) }),
+      "image-to-pixelart-pro-flash"
+    );
+  }
   /**
    * `/generate-ui-v2` ("Generate UI (Pro)"): one UI element (a button, a
    * health bar, an inventory slot, a dialogue box) from a description,
@@ -3709,7 +3739,7 @@ function characterCost(spec) {
   }
   if (character.kind === "state" || character.kind === "portrait") return generationCost(spec.width, spec.height, "1dir");
   if (character.kind === "outfit") {
-    return 20;
+    return PRO_TIER_PRICES[0];
   }
   if (character.mode === "standard") return 1;
   if (character.mode === "v3") {
@@ -3902,7 +3932,7 @@ var PixelLabProvider = class _PixelLabProvider {
     if (spec.revision) {
       const width = spec.revision.sourceWidth ?? spec.width;
       const height = spec.revision.sourceHeight ?? spec.height;
-      return { unit: "generations", amount: generationCost(width, height, "1dir"), candidates: 1 };
+      return { unit: "generations", amount: proTierCost(width, height), candidates: 1 };
     }
     if (spec.generator === "tiles" || spec.generator === "terrain" || spec.generator === "isometricTile") {
       return { unit: "generations", amount: spec.cost, candidates: spec.candidates };
@@ -11945,7 +11975,7 @@ async function unzoomFile(client2, input, opts = {}) {
 }
 var FONT_WEIGHTS = ["Bold", "Regular"];
 var FONT_GLYPH_SIZES = [8, 16, 32, 64];
-var FONT_COST_GENERATIONS = 25;
+var FONT_COST_GENERATIONS = 15;
 function fontOutputPaths(out) {
   const base = path17.resolve(out.replace(/\.(ttf|png)$/i, ""));
   return { ttf: `${base}.ttf`, atlas: `${base}.png` };
@@ -11994,6 +12024,61 @@ async function generateFont(client2, opts) {
     await sleep3(interval);
   }
 }
+var PIXELATE_COST_GENERATIONS = 6;
+var PIXELATE_MAX_SIDE = 2048;
+function defaultPixelateOut(input) {
+  const ext = path17.extname(input);
+  return `${ext ? input.slice(0, -ext.length) : input}.pixel.png`;
+}
+async function pixelateFile(client2, input, opts = {}) {
+  const out = path17.resolve(opts.out ?? defaultPixelateOut(input));
+  if (path17.resolve(input) === out) throw new Error("pixelate will not overwrite its own input; pass a different --out");
+  if (existsSync11(out) && !opts.force) throw new Error(`${out} already exists; pass --force to replace it`);
+  const bytes = await readFile9(input);
+  const metadata = imageMetadata(bytes);
+  if (!metadata) throw new Error(`${input} is not a readable PNG or JPEG`);
+  const { width, height, format } = metadata;
+  const sleep3 = opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const interval = opts.intervalMs ?? 5e3;
+  const timeout = opts.timeoutMs ?? 10 * 6e4;
+  const submitted = await client2.imageToPixelartProFlash({
+    image: { base64: bytes.toString("base64"), format },
+    description: opts.description,
+    seed: opts.seed
+  });
+  const jobId = submitted.background_job_id;
+  const started = Date.now();
+  for (; ; ) {
+    const job = await client2.getBackgroundJob(jobId);
+    opts.onProgress?.(job.status);
+    if (job.status === "failed") throw new Error(`PixelLab pixelate job ${jobId} failed upstream`);
+    if (job.status === "completed") {
+      const images = job.last_response?.images;
+      const first = Array.isArray(images) ? images[0] : void 0;
+      if (!first || typeof first.base64 !== "string" || !first.base64) {
+        throw new Error(`PixelLab pixelate job ${jobId} completed without an image at last_response.images[0]`);
+      }
+      const png = Buffer.from(first.base64, "base64");
+      const size = imageMetadata(png);
+      await mkdir4(path17.dirname(out), { recursive: true });
+      await writeFile4(out, png);
+      return {
+        jobId,
+        out,
+        original: { width, height },
+        pixelated: { width: size?.width ?? Number(first.width), height: size?.height ?? Number(first.height) },
+        imageId: submitted.image_id,
+        usage: job.usage ?? null
+      };
+    }
+    if (Date.now() - started > timeout) {
+      throw new Error(
+        `PixelLab pixelate job ${jobId} is still ${job.status} after ${Math.round(timeout / 1e3)} s; it keeps running upstream, but this command has stopped waiting`
+      );
+    }
+    await sleep3(interval);
+  }
+}
 
 // src/pipeline/quality-regression.ts
 import path18 from "path";
@@ -18969,8 +19054,11 @@ export {
   MapSceneSchema,
   MediaType,
   OverwriteRefusedError,
+  PIXELATE_COST_GENERATIONS,
+  PIXELATE_MAX_SIDE,
   PIXEL_ART_FIXER_REVISION,
   PIXEL_ART_FIXER_URL,
+  PRO_TIER_PRICES,
   PixelKilnError,
   PixelLabClient,
   PixelLabError,
@@ -19026,6 +19114,7 @@ export {
   currentEntryOutputPath,
   currentOutputPath,
   defaultOpenCommand,
+  defaultPixelateOut,
   defaultUnzoomOut,
   detachHandEdit,
   detectMediaType,
@@ -19108,11 +19197,13 @@ export {
   parseTerrainDescriptions,
   parseWorkspace,
   pickHistory,
+  pixelateFile,
   pngSize,
   poll,
   portableOutputPath,
   prepareReview,
   primaryOutput,
+  proTierCost,
   proportionsPayload,
   providerCredentialEnvs,
   providerFactory,