pixelkiln 0.22.0 → 0.23.0

package/dist/index.d.cts

@@ -7616,6 +7616,10 @@ interface GalleryStyle {
     promptPrefix: string;
     promptSuffix: string;
     palette: string[];
+    /** Provider view name, when the style sets one. */
+    view: string | null;
+    /** Strip the generated background (sent for pixflux and non-PixelLab providers). */
+    noBackground: boolean;
     quality: boolean;
     tags: string[];
     /** Parent style id when this style `extends` one. */
@@ -7912,34 +7916,48 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix: z.ZodOptional<z.ZodString>;
         /** `#rrggbb` values; null or empty clears the style's own palette. */
         palette: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        /** Provider view name (PixelLab: low top-down, high top-down, side); empty clears. */
+        view: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** pixflux only; null clears the style's own value. */
+        noBackground: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     }, "strict", z.ZodTypeAny, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }>, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     styleId: string;
     patch: {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     };
     expectedSha256: string;
     action: "patch-style";
@@ -7949,8 +7967,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
     patch: {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     };
     expectedSha256: string;
     action: "patch-style";

package/dist/index.d.ts

@@ -7616,6 +7616,10 @@ interface GalleryStyle {
     promptPrefix: string;
     promptSuffix: string;
     palette: string[];
+    /** Provider view name, when the style sets one. */
+    view: string | null;
+    /** Strip the generated background (sent for pixflux and non-PixelLab providers). */
+    noBackground: boolean;
     quality: boolean;
     tags: string[];
     /** Parent style id when this style `extends` one. */
@@ -7912,34 +7916,48 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix: z.ZodOptional<z.ZodString>;
         /** `#rrggbb` values; null or empty clears the style's own palette. */
         palette: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        /** Provider view name (PixelLab: low top-down, high top-down, side); empty clears. */
+        view: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** pixflux only; null clears the style's own value. */
+        noBackground: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     }, "strict", z.ZodTypeAny, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }>, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     styleId: string;
     patch: {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     };
     expectedSha256: string;
     action: "patch-style";
@@ -7949,8 +7967,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
     patch: {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
+        view?: string | null | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
+        noBackground?: boolean | null | undefined;
     };
     expectedSha256: string;
     action: "patch-style";

package/dist/index.js

@@ -9173,7 +9173,11 @@ var ManifestEditSchema = z7.discriminatedUnion("action", [
       promptPrefix: z7.string().optional(),
       promptSuffix: z7.string().optional(),
       /** `#rrggbb` values; null or empty clears the style's own palette. */
-      palette: z7.array(z7.string().regex(/^#?[0-9a-f]{6}$/i, "expected a six-digit hex colour")).max(256).nullable().optional()
+      palette: z7.array(z7.string().regex(/^#?[0-9a-f]{6}$/i, "expected a six-digit hex colour")).max(256).nullable().optional(),
+      /** Provider view name (PixelLab: low top-down, high top-down, side); empty clears. */
+      view: z7.string().max(64).nullable().optional(),
+      /** pixflux only; null clears the style's own value. */
+      noBackground: z7.boolean().nullable().optional()
     }).strict().refine((patch) => Object.keys(patch).length > 0, { message: "nothing to change" })
   }).strict()
 ]);
@@ -9231,6 +9235,8 @@ function applyEdit(raw, edit) {
       const colors = (patch2.palette ?? []).map((color) => "#" + color.replace(/^#/, "").toLowerCase());
       setOrDelete(style, "palette", colors.length ? colors : null);
     }
+    if (patch2.view !== void 0) setOrDelete(style, "view", patch2.view?.trim() || null);
+    if (patch2.noBackground !== void 0) setOrDelete(style, "noBackground", patch2.noBackground);
     return;
   }
   if (edit.action === "add-asset") {
@@ -9610,6 +9616,8 @@ async function buildGallerySnapshot(opts) {
       promptPrefix: style?.promptPrefix ?? "",
       promptSuffix: style?.promptSuffix ?? "",
       palette: style?.palette ?? [],
+      view: style?.view ?? null,
+      noBackground: style?.noBackground ?? true,
       quality: Boolean(style?.quality),
       tags: style?.tags ?? [],
       extends: typeof rawStyle?.extends === "string" ? rawStyle.extends : null,
@@ -10084,6 +10092,7 @@ function renderGallery(snapshot, opts = {}) {
 </footer>
 <div id="drawer-host"></div>
 <div id="dialog-host"></div>
+<datalist id="view-options"><option value="low top-down"><option value="high top-down"><option value="side"><option value="sidescroller"></datalist>
 <script>
 const INITIAL = ${data};
 const SESSION = ${session};
@@ -10875,9 +10884,18 @@ function inheritorsOf(style, field) {
   }
   return out;
 }
+// noBackground reaches the request only for pixflux and non-PixelLab
+// providers; elsewhere a change is recorded but alters nothing.
+const fieldReaches = (field, style) =>
+  field !== 'noBackground' || style.generator === 'pixflux' || style.provider !== 'pixellab';
 function blastRadius(style, fields) {
-  const styleIds = new Set([style.id]);
-  for (const field of fields) for (const id of inheritorsOf(style, field)) styleIds.add(id);
+  const byId = new Map(snap.styles.filter((x) => x.project === style.project).map((x) => [x.id, x]));
+  const styleIds = new Set();
+  for (const field of fields) {
+    for (const id of [style.id, ...inheritorsOf(style, field)]) {
+      if (fieldReaches(field, byId.get(id) || style)) styleIds.add(id);
+    }
+  }
   const affected = snap.items.filter((i) => i.project === style.project && i.declared && styleIds.has(i.styleId));
   const units = new Map();
   for (const i of affected) if (i.estimatedCost !== null) units.set(i.costUnit, (units.get(i.costUnit) || 0) + i.estimatedCost);
@@ -10902,6 +10920,11 @@ function styleForm(style) {
   const prefix = el('input'); prefix.type = 'text'; prefix.value = style.promptPrefix; prefix.placeholder = 'none';
   const suffix = el('input'); suffix.type = 'text'; suffix.value = style.promptSuffix; suffix.placeholder = 'none';
   const palette = el('input'); palette.type = 'text'; palette.value = style.palette.join(', '); palette.placeholder = '#rrggbb, #rrggbb \u2014 leave empty for no forced palette';
+  const view = el('input'); view.type = 'text'; view.value = style.view || ''; view.placeholder = 'provider default';
+  view.setAttribute('list', 'view-options');
+  const noBg = el('select');
+  noBg.append(new Option(style.extends ? 'inherit from ' + style.extends : 'default (on)', 'default'), new Option('on \u2014 strip the generated background', 'on'), new Option('off \u2014 keep the background (scenes, banners)', 'off'));
+  noBg.value = own('noBackground') ? (style.noBackground ? 'on' : 'off') : 'default';
   const swatches = el('div', 'pal');
   const drawSwatches = () => {
     swatches.textContent = '';
@@ -10914,12 +10937,21 @@ function styleForm(style) {
     field('palette', palette, 'Forced colours where the provider supports them (pixflux). ' + provenance('palette')),
     swatches,
   );
+  const row = el('div', 'row');
+  row.append(
+    field('view', view, 'PixelLab accepts low top-down, high top-down, side; Retro Diffusion reads sidescroller. ' + provenance('view')),
+    field('background', noBg, (fieldReaches('noBackground', style) ? 'Sent for this style. ' : 'Not sent for ' + style.provider + ' ' + style.generator + '; recorded only. ') + provenance('noBackground')),
+  );
+  form.append(row);
   const blast = el('div', 'blast');
   const changed = () => {
     const out = [];
     if (prefix.value !== style.promptPrefix) out.push('promptPrefix');
     if (suffix.value !== style.promptSuffix) out.push('promptSuffix');
     if (parsePalette(palette.value).join(',') !== style.palette.map((c) => c.toLowerCase()).join(',')) out.push('palette');
+    if (view.value.trim() !== (style.view || '')) out.push('view');
+    const bgNow = own('noBackground') ? (style.noBackground ? 'on' : 'off') : 'default';
+    if (noBg.value !== bgNow) out.push('noBackground');
     return out;
   };
   const updateBlast = () => {
@@ -10927,6 +10959,11 @@ function styleForm(style) {
     drawSwatches();
     if (!fields.length) { blast.className = 'blast'; blast.textContent = 'No changes yet. A style change alters the request for every asset that uses it.'; return; }
     const r = blastRadius(style, fields);
+    if (!r.assets) {
+      blast.className = 'blast';
+      blast.textContent = 'Recorded in the manifest only: nothing in ' + style.id + ' sends this field, so no request changes.';
+      return;
+    }
     blast.className = 'blast hot';
     blast.textContent = '';
     const others = r.styles.filter((id) => id !== style.id);
@@ -10936,7 +10973,8 @@ function styleForm(style) {
       : ' in ' + style.id + '.'));
     blast.append(document.createTextNode(' Generated ones become stale; regenerating all of them is about ' + (r.cost || 'nothing') + '. Nothing is spent until you generate.'));
   };
-  for (const input of [prefix, suffix, palette]) input.addEventListener('input', updateBlast);
+  for (const input of [prefix, suffix, palette, view]) input.addEventListener('input', updateBlast);
+  noBg.addEventListener('change', updateBlast);
   updateBlast();
   form.append(blast);
   const actions = el('div', 'actions');
@@ -10955,6 +10993,8 @@ function styleForm(style) {
     if (fields.includes('promptPrefix')) patch.promptPrefix = prefix.value;
     if (fields.includes('promptSuffix')) patch.promptSuffix = suffix.value;
     if (fields.includes('palette')) patch.palette = colors;
+    if (fields.includes('view')) patch.view = view.value.trim();
+    if (fields.includes('noBackground')) patch.noBackground = noBg.value === 'default' ? null : noBg.value === 'on';
     save.disabled = true; msg.className = 'msg'; msg.textContent = 'saving\u2026';
     const r = blastRadius(style, fields);
     try {
@@ -10963,7 +11003,9 @@ function styleForm(style) {
       snap = await postEdit(body);
       ui.editing = null;
       ui.notice = { id: 'style:' + (style.project || '') + ':' + style.id,
-        text: 'Saved. The request for ' + r.assets + (r.assets === 1 ? ' asset' : ' assets') + ' changed' + (r.cost ? ' \u2014 about ' + r.cost + ' to regenerate.' : '.') + ' Nothing is spent until you generate.' };
+        text: r.assets
+          ? 'Saved. The request for ' + r.assets + (r.assets === 1 ? ' asset' : ' assets') + ' changed' + (r.cost ? ' \u2014 about ' + r.cost + ' to regenerate.' : '.') + ' Nothing is spent until you generate.'
+          : 'Saved. Recorded in the manifest; no request changed.' };
       render();
     } catch (err) {
       save.disabled = false;