@pixerate/editor 0.177.0 → 0.177.1

package/dist/effects/index.cjs

@@ -597,6 +597,11 @@ var EFFECT_USE_LABELS = {
 };
 var HEX2 = /^#[0-9a-f]{6}([0-9a-f]{2})?$/i;
 var typeOf = (s) => Array.isArray(s.type) ? s.type.find((t) => t !== "null") : s.type;
+function hexColour(value) {
+  if (typeof value === "string") return HEX2.test(value) ? value : void 0;
+  if (!Array.isArray(value) || value.length !== 3 && value.length !== 4 || !value.every((n) => typeof n === "number" && Number.isFinite(n))) return void 0;
+  return `#${value.map((n) => Math.round(Math.min(1, Math.max(0, n)) * 255).toString(16).padStart(2, "0")).join("")}`;
+}
 function isEffectFontControl(schema) {
   return typeOf(schema) === "string" && (schema.format === "font" || schema["x-pixerate-control"] === "font");
 }
@@ -649,7 +654,10 @@ function effectFontFamilies(description, values = {}) {
   }
   return out;
 }
-var effectFieldValue = (field, value) => value === void 0 || value === null || typeof value === "object" && !Array.isArray(value) ? field.default : value;
+var effectFieldValue = (field, value) => {
+  if (field.type === "color") return _nullishCoalesce(hexColour(value), () => ( field.default));
+  return value === void 0 || value === null || typeof value === "object" && !Array.isArray(value) ? field.default : value;
+};
 function effectSamplePicture(width, height, variant = 0) {
   const p = _chunkA3A5TI6Rcjs.createEffectPixels.call(void 0, width, height);
   for (let y = 0, i = 0; y < height; y++) {

package/dist/effects/index.js

@@ -597,6 +597,11 @@ var EFFECT_USE_LABELS = {
 };
 var HEX2 = /^#[0-9a-f]{6}([0-9a-f]{2})?$/i;
 var typeOf = (s) => Array.isArray(s.type) ? s.type.find((t) => t !== "null") : s.type;
+function hexColour(value) {
+  if (typeof value === "string") return HEX2.test(value) ? value : void 0;
+  if (!Array.isArray(value) || value.length !== 3 && value.length !== 4 || !value.every((n) => typeof n === "number" && Number.isFinite(n))) return void 0;
+  return `#${value.map((n) => Math.round(Math.min(1, Math.max(0, n)) * 255).toString(16).padStart(2, "0")).join("")}`;
+}
 function isEffectFontControl(schema) {
   return typeOf(schema) === "string" && (schema.format === "font" || schema["x-pixerate-control"] === "font");
 }
@@ -649,7 +654,10 @@ function effectFontFamilies(description, values = {}) {
   }
   return out;
 }
-var effectFieldValue = (field, value) => value === void 0 || value === null || typeof value === "object" && !Array.isArray(value) ? field.default : value;
+var effectFieldValue = (field, value) => {
+  if (field.type === "color") return hexColour(value) ?? field.default;
+  return value === void 0 || value === null || typeof value === "object" && !Array.isArray(value) ? field.default : value;
+};
 function effectSamplePicture(width, height, variant = 0) {
   const p = createEffectPixels(width, height);
   for (let y = 0, i = 0; y < height; y++) {

package/dist/effects/ui.d.cts

@@ -27,7 +27,10 @@ export declare function effectParameterFields(description: Pick<EffectDescriptio
  * to load with `ensureFontsLoaded` before rendering a title preview.
  */
 export declare function effectFontFamilies(description: Pick<EffectDescription, 'controls' | 'defaults'>, values?: Readonly<Record<string, unknown>>): string[];
-/** A saved value as a field shows it (`ParameterValue`), or the field's default. */
+/**
+ * A saved value as a field shows it (`ParameterValue`), or the field's default. Colour fields show
+ * channel arrays as hex, and the default for values they can't show (`"currentColor"`, `rgb(…)`).
+ */
 export declare const effectFieldValue: (field: ParameterField, value: unknown) => ParameterValue;
 /**
  * A colourful, deterministic picture for previews of filters and transitions (`variant` 0 and 1

package/dist/effects/ui.d.ts

@@ -27,7 +27,10 @@ export declare function effectParameterFields(description: Pick<EffectDescriptio
  * to load with `ensureFontsLoaded` before rendering a title preview.
  */
 export declare function effectFontFamilies(description: Pick<EffectDescription, 'controls' | 'defaults'>, values?: Readonly<Record<string, unknown>>): string[];
-/** A saved value as a field shows it (`ParameterValue`), or the field's default. */
+/**
+ * A saved value as a field shows it (`ParameterValue`), or the field's default. Colour fields show
+ * channel arrays as hex, and the default for values they can't show (`"currentColor"`, `rgb(…)`).
+ */
 export declare const effectFieldValue: (field: ParameterField, value: unknown) => ParameterValue;
 /**
  * A colourful, deterministic picture for previews of filters and transitions (`variant` 0 and 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.177.0",
+  "version": "0.177.1",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-effect-authoring/SKILL.md

@@ -49,6 +49,11 @@ For general error reporting and undo conventions, see `pixerate-agent-tools`.
 
 - **Batch parameter changes.** Set all related control values in a single `effect_authoring_set_values`
   call so they apply cleanly in a single undo step.
+- **Write colours as hex.** A control with `type: "color"` in `effect_authoring_describe` takes
+  `#rrggbb` (or `#rrggbbaa` when `alpha` is true), even when the provider's schema also accepts 0–1
+  channel arrays or CSS colour strings (Flair's colours do). Hex keyframes blend smoothly. A control
+  that is in `values` but has no entry in `controls` has a shape no field can edit. Set it only with a
+  value that matches the provider's schema.
 - **Check compile issues.** When editing source code via `effect_authoring_set_source`, always verify
   the returned `issues` array. Fix errors before attempting to preview or set controls.
 - **Keyframe animation tracks.** Controls with active keyframes calculate their values dynamically