pixelkiln 0.44.0 → 0.46.0

package/docs/GENERATORS.md

@@ -172,6 +172,7 @@ regenerating the parent makes the child stale.
 | base, `mode: standard` | create-character-with-4/8-directions | 1 |
 | base, `mode: v3` | create-character-v3 | 1 + ceil(size² × 8 / 65536): 2 at 64px, 3 at 128px |
 | base, `mode: pro` | create-character-pro | 20–40 by canvas |
+| base, `mode: pro-flash` | create-character-pro-flash | image tier (5 to 96px, 6 to 208px, 9 above) + ceil(size² × 8 / 65536): 6 at 64px, 8 at 128px, 17 at 256px; rotations only from a `reference` |
 | state | create-character-state | 20–40 by canvas |
 | animation with a `template` | animate-character | 1 |
 | animation from text (v3) | animate-character | ceil(size² × frames / 65536): 1 at 64px, 2 at 128px |

package/docs/MANIFEST.md

@@ -59,6 +59,8 @@ not merely a label edit.
 | `mirror` | string | Another asset of the same style flipped left to right, made locally at no cost. See [Mirrors](#mirrors). |
 | `proportions` | preset or object | `character` styles: this base's proportions, over the style's. |
 | `reference` | string or object | `character` styles, bases: the character's own south-facing sprite (or `{ "south": ..., "east": ... }`), which PixelLab rotates instead of drawing from the prompt. See [Characters](#characters). |
+| `concept` | string | `character` styles, `pro` bases: a manifest-relative concept image (up to 1024px) the design is seeded from. |
+| `styleCharacter` | string | `character` styles, `pro` bases: this base's style anchor, over the style's. |
 | `providerInputs` | JSON scalar/sequence map, `{}` | Named per-asset inputs consumed by the active provider. ComfyUI accepts scalars and, for `frames`, one ordered 2–64 value sequence. Image bindings upload PNG/JPEG inputs. |
 | `styles` | string array, `[]` | Restrict the asset to named styles; empty means every style. |
 | `promptByStyle` | string map, `{}` | Replace only the asset prompt for a named style. |
@@ -99,13 +101,15 @@ constant across the set.
 | `tileView` | enum | `top-down`, `high top-down`, `low top-down`, or `side`. |
 | `tileFeature` | enum | Connectable `roads`, `tileset`, or `building` structural set. |
 | `outlineMode` | enum | `outline` or `segmentation`; segmentation avoids quilted ground seams. |
-| `mode` | `standard` | `character` only. `standard`, `v3`, or `pro`; see [Characters](#characters). |
-| `directions` | `8` | `character` only. `4` or `8`; `v3` and `pro` always draw 8. |
-| `template` | `mannequin` | `character` only. Body template: `mannequin`, or `bear`, `cat`, `dog`, `horse`, `lion`. |
+| `mode` | `standard` | `character` only. `standard`, `v3`, `pro`, or `pro-flash`; see [Characters](#characters). |
+| `directions` | `8` | `character` only. `4` or `8`; every engine but `standard` draws 8. |
+| `template` | `mannequin` | `character` only. Body template: `mannequin`, or `bear`, `cat`, `dog`, `horse`, `lion`; `custom` for `pro-flash`. |
 | `proportions` | | `character` only, `standard` humanoid bases. A preset (`default`, `chibi`, `cartoon`, `stylized`, `realistic_male`, `realistic_female`, `heroic`) or multipliers `{ headSize, armsLength, legsLength, shoulderWidth, hipWidth }`, each 0.5 to 2. An asset may override it. |
 | `textGuidanceScale` | `8` | `character` only. How closely a `standard` base and a template loop follow their text, 1 to 20. |
 | `isometric` | `false` | `character` only. Draw `standard` bases and every loop in isometric view. |
 | `enhancePrompt` | `false` | `character` only, `v3` bases. Let PixelLab expand the prompt into a fuller one before drawing. |
+| `styleCharacter` | | `character` only, `pro` bases. The asset id of a generated 8-direction character in this style whose look bases drawn from text or a concept follow. An asset may override it. |
+| `styleTraits` | all true | `character` only, `pro-flash` bases with a style image. `{ palette, outline, detail, shading }` booleans: which traits the style image lends. |
 | `mount` | object | Stable-cell sheet placement; documented below. |
 | `quality` | object | Optional native-grid, final-palette, and human-approval contract; documented below. |
 | `tags` | string array, `[]` | Tags inherited by every generated provider object in the style. |
@@ -525,6 +529,8 @@ credentials, cost semantics, recovery, and the paid live-test boundary.
 | `mirror` | string | Another asset of this style, flipped left to right. No prompt, no provider, no cost. See [Mirrors](#mirrors). |
 | `proportions` | preset or object | This base's body proportions, over the style's. `standard` humanoid bases only. |
 | `reference` | string or object | The character's own sprite(s) for PixelLab to rotate. Bases only. |
+| `concept` | string | A concept image a `pro` base is designed from. Bases only. |
+| `styleCharacter` | string | The character in this style a `pro` base takes its look from, over the style's. |
 
 ## Characters
 
@@ -568,10 +574,14 @@ A base is a prompt, wrapped in the style's prefix and suffix like any other
 asset, that PixelLab draws facing 4 or 8 directions. `mode` picks the
 engine: `standard` (1 generation, the skeleton template, `outline`,
 `shading`, and `detail` as soft guidance, and `palette` sent as a colour
-reference), `v3` (2 to 9 by size, the highest quality, up to 256px), or
-`pro` (20 to 40 by size). `size` is the character's size; `view` is `low
-top-down` (the default), `high top-down`, or `side`; `template` picks the
-body. Each direction lands as `<asset>-<direction>.png`, south first.
+reference), `v3` (2 to 9 by size, the highest quality, up to 256px),
+`pro` (20 to 40 by size), or `pro-flash` (6 to 17 by size: PixelLab's
+newest image model draws the south sprite and v3 rotates it; sizes are
+multiples of 4 up to 256, `template` may be `custom`, and a `reference`
+pays for the rotations only, 1 at 64px). `size` is the character's size;
+`view` is `low top-down` (the default), `high top-down`, or `side`;
+`template` picks the body. Each direction lands as
+`<asset>-<direction>.png`, south first.
 Standard mode draws on a canvas 28px larger than `size`, 14px of room on
 each side for animation (a 64px character comes back as 92px files, a
 104px one as 132px); the lock records the size asked for, and the files
@@ -608,11 +618,31 @@ is read again at submit time and refused if it changed since `plan`.
 States, animations, and mirrors take their look from their parent and
 cannot carry a reference.
 
-Style images on a `character` style are a pro-only input: one image of up
-to 168px that anchors the look of a `pro` base drawn from text (PixelLab's
-`create_with_style`). `standard` and `v3` have no such slot and refuse
-them; a pro base with a `reference` refuses them too, since the rotate
-method has one image slot and it is the character.
+The pro engine has two more ways in. `concept` on a base names a concept
+image (a painting, a photo, a sketch, up to 1024px) that seeds the design
+in place of the prompt alone (PixelLab's `create_from_concept`); the
+prompt still guides it. `styleCharacter`, on the style or a base, names a
+generated 8-direction character in the same style whose look the base
+follows (`style_character_id`); its south sprite becomes the style image
+unless a style image is also given. The anchor is a dependency like a
+loop's character: the base is `blocked` until the anchor is downloaded and
+current, `gen` runs it in the wave after the anchor lands, and a
+regenerated anchor makes every base drawn in its style `stale`. The anchor
+itself ignores the setting, so a style can name its own first character.
+PixelLab wants the base at least as large as the anchor's visible sprite
+and fails the job fast otherwise. A base rotating its own `reference`
+takes neither: the rotate method has one image slot and it is the
+character.
+
+Style images on a `character` style are a pro input: one image of up to
+168px that anchors the look of a `pro` base drawn from text or a concept
+(`create_with_style` and `create_from_concept` both take it), or one of
+up to 256px that a `pro-flash` base copies its look from, no larger than
+the character's `size` on either side (crop it to its subject), with
+`styleTraits` (`palette`, `outline`, `detail`, `shading`, each on by
+default) choosing which traits it lends. `standard` and `v3` have no such
+slot and refuse them; a base with a `reference` refuses them too, in
+either engine.
 
 A state is a text edit of an existing character, `state.of`, applied to
 every direction at once: a pose, an outfit, a held object. The prompt is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixelkiln",
-  "version": "0.44.0",
+  "version": "0.46.0",
   "description": "Manifest-driven pixel-art generation, review, recovery, and packaging with deterministic provenance.",
   "type": "module",
   "sideEffects": false,

package/schema/manifest.schema.json

@@ -137,7 +137,8 @@
                     "enum": [
                       "standard",
                       "v3",
-                      "pro"
+                      "pro",
+                      "pro-flash"
                     ]
                   },
                   "directions": {
@@ -151,6 +152,24 @@
                     "type": "string",
                     "minLength": 1
                   },
+                  "styleTraits": {
+                    "type": "object",
+                    "properties": {
+                      "palette": {
+                        "type": "boolean"
+                      },
+                      "outline": {
+                        "type": "boolean"
+                      },
+                      "detail": {
+                        "type": "boolean"
+                      },
+                      "shading": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false
+                  },
                   "proportions": {
                     "anyOf": [
                       {
@@ -209,6 +228,10 @@
                   "enhancePrompt": {
                     "type": "boolean"
                   },
+                  "styleCharacter": {
+                    "type": "string",
+                    "minLength": 1
+                  },
                   "seed": {
                     "type": "integer"
                   },
@@ -433,7 +456,8 @@
                     "enum": [
                       "standard",
                       "v3",
-                      "pro"
+                      "pro",
+                      "pro-flash"
                     ]
                   },
                   "directions": {
@@ -447,6 +471,24 @@
                     "type": "string",
                     "minLength": 1
                   },
+                  "styleTraits": {
+                    "type": "object",
+                    "properties": {
+                      "palette": {
+                        "type": "boolean"
+                      },
+                      "outline": {
+                        "type": "boolean"
+                      },
+                      "detail": {
+                        "type": "boolean"
+                      },
+                      "shading": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false
+                  },
                   "proportions": {
                     "anyOf": [
                       {
@@ -505,6 +547,10 @@
                   "enhancePrompt": {
                     "type": "boolean"
                   },
+                  "styleCharacter": {
+                    "type": "string",
+                    "minLength": 1
+                  },
                   "seed": {
                     "type": "integer"
                   },
@@ -902,6 +948,14 @@
                   }
                 ]
               },
+              "concept": {
+                "type": "string",
+                "minLength": 1
+              },
+              "styleCharacter": {
+                "type": "string",
+                "minLength": 1
+              },
               "mirror": {
                 "type": "string",
                 "minLength": 1

package/schema/recipe.schema.json

@@ -212,7 +212,8 @@
               "enum": [
                 "standard",
                 "v3",
-                "pro"
+                "pro",
+                "pro-flash"
               ]
             },
             "directions": {
@@ -226,6 +227,24 @@
               "type": "string",
               "minLength": 1
             },
+            "styleTraits": {
+              "type": "object",
+              "properties": {
+                "palette": {
+                  "type": "boolean"
+                },
+                "outline": {
+                  "type": "boolean"
+                },
+                "detail": {
+                  "type": "boolean"
+                },
+                "shading": {
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": false
+            },
             "proportions": {
               "anyOf": [
                 {
@@ -284,6 +303,10 @@
             "enhancePrompt": {
               "type": "boolean"
             },
+            "styleCharacter": {
+              "type": "string",
+              "minLength": 1
+            },
             "seed": {
               "type": "integer"
             },

package/skills/pixelkiln/references/pixellab.md

@@ -22,12 +22,15 @@ providers, or before any PixelLab account operation.
 | `pixflux` | Closed palettes or full-bleed backgrounds | 1 generation |
 | `1dir` | Reference-guided work or several candidates | 20–40 generations |
 | `tiles` | Ground variations or connected structures | 20–40 generations |
-| `character` | A character in 4 or 8 directions, its poses (`state`), and its loops (`animation`) | 1 per base, 20–40 per pose, 1 per template loop per direction |
+| `character` | A character in 4 or 8 directions, its poses (`state`), and its loops (`animation`) | 1 per standard base, 6 per pro-flash base at 64px (1 from a `reference`), 20–40 per pose, 1 per template loop per direction |
 
 A base can start from the author's own south-facing sprite (`reference` on
 the asset; standard wants it at the style's size, v3 up to 256px, pro up
 to 168px), and a standard humanoid base takes `proportions` (`chibi`,
-`heroic`, or multipliers) on the style or the asset.
+`heroic`, or multipliers) on the style or the asset. A pro base can be
+designed from a `concept` image (up to 1024px) and follow the look of
+another generated character in the style (`styleCharacter`), which makes
+that character a dependency the way a loop's parent is.
 
 A v3 loop can start from a pose image (`startFrame`) or interpolate to one
 (`endFrame`), take a `subject` when the character's own description would