pixelkiln 0.45.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

@@ -101,14 +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. |
@@ -573,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
@@ -629,11 +634,15 @@ 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-only 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).
-`standard` and `v3` have no such slot and refuse them; a pro base with a
-`reference` refuses them too.
+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.45.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": [
                       {
@@ -437,7 +456,8 @@
                     "enum": [
                       "standard",
                       "v3",
-                      "pro"
+                      "pro",
+                      "pro-flash"
                     ]
                   },
                   "directions": {
@@ -451,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": [
                       {

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": [
                 {

package/skills/pixelkiln/references/pixellab.md

@@ -22,7 +22,7 @@ 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