pixelkiln 0.86.2 → 0.87.0

package/dist/client/gallery.js

@@ -5014,7 +5014,7 @@
   var ENGINES = [
     { id: "v3", label: "v3: PixelLab's recommended base engine (2 to 9 by size; 1 from a sprite)", min: 32, max: 256, directions: [8] },
     { id: "pro-flash", label: "pro-flash: the newest image model draws the south sprite (6 to 17 by size)", min: 16, max: 256, directions: [8] },
-    { id: "pro", label: "pro: reference-based, 20 to 40 by size", min: 32, max: 168, directions: [8] },
+    { id: "pro", label: "pro: reference-based, 10 to 25 by size", min: 32, max: 168, directions: [8] },
     { id: "standard", label: "standard: skeleton template, 1 generation", min: 16, max: 256, directions: [8, 4] }
   ];
   var BODIES = ["mannequin", "bear", "cat", "dog", "horse", "lion"];
@@ -5026,7 +5026,7 @@
     { id: "skeleton-v3", label: "skeleton-v3: a template, posed by the skeleton model (steadiest; 2-4 per direction)" },
     { id: "template", label: "template: a template, redrawn (1 per direction)" },
     { id: "v3", label: "v3: described in words" },
-    { id: "pro", label: "pro: described in words, sequential (20-40 per direction)" }
+    { id: "pro", label: "pro: described in words, sequential (10-25 per direction)" }
   ];
   var templated = (mode) => mode === "skeleton-v3" || mode === "template";
   var KNOWN_TEMPLATES = [
@@ -5172,7 +5172,7 @@
     portraitSize.value = "64";
     const portraitSection = el("section", "studio-part");
     const portraitCheck = el("label", "field check");
-    portraitCheck.append(portrait, el("span", null, "add a bust portrait (20 to 40 generations)"));
+    portraitCheck.append(portrait, el("span", null, "add a bust portrait (10 to 25 generations)"));
     portraitSection.append(el("h3", null, "Portrait"), portraitCheck, field("portrait size", portraitSize));
     const priceBox = el("section", "studio-part studio-price");
     const actions = el("div", "actions");

package/dist/index.cjs

@@ -86,8 +86,11 @@ __export(index_exports, {
   MapSceneSchema: () => MapSceneSchema,
   MediaType: () => MediaType,
   OverwriteRefusedError: () => OverwriteRefusedError,
+  PIXELATE_COST_GENERATIONS: () => PIXELATE_COST_GENERATIONS,
+  PIXELATE_MAX_SIDE: () => PIXELATE_MAX_SIDE,
   PIXEL_ART_FIXER_REVISION: () => PIXEL_ART_FIXER_REVISION,
   PIXEL_ART_FIXER_URL: () => PIXEL_ART_FIXER_URL,
+  PRO_TIER_PRICES: () => PRO_TIER_PRICES,
   PixelKilnError: () => PixelKilnError,
   PixelLabClient: () => PixelLabClient,
   PixelLabError: () => PixelLabError,
@@ -143,6 +146,7 @@ __export(index_exports, {
   currentEntryOutputPath: () => currentEntryOutputPath,
   currentOutputPath: () => currentOutputPath,
   defaultOpenCommand: () => defaultOpenCommand,
+  defaultPixelateOut: () => defaultPixelateOut,
   defaultUnzoomOut: () => defaultUnzoomOut,
   detachHandEdit: () => detachHandEdit,
   detectMediaType: () => detectMediaType,
@@ -225,11 +229,13 @@ __export(index_exports, {
   parseTerrainDescriptions: () => parseTerrainDescriptions,
   parseWorkspace: () => parseWorkspace,
   pickHistory: () => pickHistory,
+  pixelateFile: () => pixelateFile,
   pngSize: () => pngSize,
   poll: () => poll,
   portableOutputPath: () => portableOutputPath,
   prepareReview: () => prepareReview,
   primaryOutput: () => primaryOutput,
+  proTierCost: () => proTierCost,
   proportionsPayload: () => proportionsPayload,
   providerCredentialEnvs: () => providerCredentialEnvs,
   providerFactory: () => providerFactory,
@@ -360,17 +366,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;
@@ -886,7 +899,7 @@ var MEMBER_SET_REVISION_MODES = ["reduce-colors", "correct-pixelart", "edit-anim
 var StyleObjectSchema = import_zod.z.object({
   /** Generation backend for this style. Omit to inherit the manifest default. */
   provider: import_zod.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. */
@@ -2709,7 +2722,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", {
@@ -2748,7 +2762,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) => ({
@@ -2798,7 +2813,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
@@ -2851,8 +2868,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
@@ -2938,6 +2956,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,
@@ -4034,7 +4070,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") {
@@ -4227,7 +4263,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 };
@@ -12270,7 +12306,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 = import_node_path17.default.resolve(out.replace(/\.(ttf|png)$/i, ""));
   return { ttf: `${base}.ttf`, atlas: `${base}.png` };
@@ -12319,6 +12355,61 @@ async function generateFont(client2, opts) {
     await sleep3(interval);
   }
 }
+var PIXELATE_COST_GENERATIONS = 6;
+var PIXELATE_MAX_SIDE = 2048;
+function defaultPixelateOut(input) {
+  const ext = import_node_path17.default.extname(input);
+  return `${ext ? input.slice(0, -ext.length) : input}.pixel.png`;
+}
+async function pixelateFile(client2, input, opts = {}) {
+  const out = import_node_path17.default.resolve(opts.out ?? defaultPixelateOut(input));
+  if (import_node_path17.default.resolve(input) === out) throw new Error("pixelate will not overwrite its own input; pass a different --out");
+  if ((0, import_node_fs13.existsSync)(out) && !opts.force) throw new Error(`${out} already exists; pass --force to replace it`);
+  const bytes = await (0, import_promises9.readFile)(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 (0, import_promises9.mkdir)(import_node_path17.default.dirname(out), { recursive: true });
+      await (0, import_promises9.writeFile)(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
 var import_node_path18 = __toESM(require("path"), 1);
@@ -15398,6 +15489,12 @@ async function currentArt(entry, spec) {
   }
   return { path: file, contentType, width, height };
 }
+async function cachedFrame(url) {
+  if (!url.startsWith("file://")) return null;
+  const file = url.slice("file://".length);
+  const contentType = mediaTypeFromExtension(file) ?? detectMediaType(await (0, import_promises18.readFile)(file).catch(() => Buffer.alloc(0))) ?? "application/octet-stream";
+  return { path: file, contentType };
+}
 async function prepareReview(provider, lock, opts = {}) {
   const log = opts.onProgress ?? (() => {
   });
@@ -15407,6 +15504,7 @@ async function prepareReview(provider, lock, opts = {}) {
   );
   const reviewAssets = /* @__PURE__ */ new Map();
   const prefix = opts.routePrefix ?? "";
+  const providerUrls = /* @__PURE__ */ new Map();
   const groups = [];
   for (const [key, entry] of Object.entries(lock.entries)) {
     if (entry.provider !== provider.id || selectedKeys && !selectedKeys.has(key)) continue;
@@ -15415,7 +15513,19 @@ async function prepareReview(provider, lock, opts = {}) {
       const spec = specByKey.get(key);
       const state = await provider.poll(entry.reviewObjectId, entry.generator, { spec, metadata: entry.providerMetadata?.[provider.id] });
       if (state.status !== "review" && state.status !== "review-set" || (state.status === "review" ? !state.candidateUrls.length : !state.frameUrls.length)) continue;
-      const frameUrls = state.status === "review" ? state.candidateUrls : state.frameUrls;
+      const urls = state.status === "review" ? state.candidateUrls : state.frameUrls;
+      const frameUrls = [];
+      const frameAssets = [];
+      for (const [index, url] of urls.entries()) {
+        const cached = await cachedFrame(url);
+        if (!cached) {
+          frameUrls.push(url);
+          continue;
+        }
+        const route = `${prefix}/review-frame/${encodeURIComponent(String(groups.length))}/${index}`;
+        frameAssets.push([route, cached]);
+        frameUrls.push(route);
+      }
       const sourceRoute = spec?.revision ? `${prefix}/revision-source/${encodeURIComponent(String(groups.length))}` : null;
       if (sourceRoute && spec?.revision) {
         reviewAssets.set(sourceRoute, {
@@ -15428,6 +15538,8 @@ async function prepareReview(provider, lock, opts = {}) {
       if (current && currentRoute) {
         reviewAssets.set(currentRoute, { path: current.path, contentType: current.contentType });
       }
+      for (const [route, asset] of frameAssets) reviewAssets.set(route, asset);
+      providerUrls.set(key, urls);
       groups.push({
         key,
         assetId: entry.assetId,
@@ -15510,7 +15622,7 @@ async function prepareReview(provider, lock, opts = {}) {
           status: "selected",
           objectId,
           candidateIndex: index,
-          sourceUrl: sourceUrl ?? group.frameUrls[index] ?? null,
+          sourceUrl: sourceUrl ?? providerUrls.get(key)?.[index] ?? null,
           sourceUrls: [],
           provider: provider.id,
           providerMetadata: metadata ? {
@@ -19274,8 +19386,11 @@ async function workspaceStatus(ws, dir) {
   MapSceneSchema,
   MediaType,
   OverwriteRefusedError,
+  PIXELATE_COST_GENERATIONS,
+  PIXELATE_MAX_SIDE,
   PIXEL_ART_FIXER_REVISION,
   PIXEL_ART_FIXER_URL,
+  PRO_TIER_PRICES,
   PixelKilnError,
   PixelLabClient,
   PixelLabError,
@@ -19331,6 +19446,7 @@ async function workspaceStatus(ws, dir) {
   currentEntryOutputPath,
   currentOutputPath,
   defaultOpenCommand,
+  defaultPixelateOut,
   defaultUnzoomOut,
   detachHandEdit,
   detectMediaType,
@@ -19413,11 +19529,13 @@ async function workspaceStatus(ws, dir) {
   parseTerrainDescriptions,
   parseWorkspace,
   pickHistory,
+  pixelateFile,
   pngSize,
   poll,
   portableOutputPath,
   prepareReview,
   primaryOutput,
+  proTierCost,
   proportionsPayload,
   providerCredentialEnvs,
   providerFactory,