@laplace.live/persona-sdk 1.2.0 → 1.4.0

package/dist/values/effect-schema.d.ts

@@ -6,6 +6,8 @@ export declare const EFFECT_SCOPES: {
     readonly colorWheels: readonly ["scene", "layer"];
     readonly colorShift: readonly ["scene", "layer"];
     readonly selectColors: readonly ["scene", "layer"];
+    readonly gradient: readonly ["scene", "layer"];
+    readonly flare: readonly ["scene"];
     readonly blur: readonly ["scene", "layer"];
     readonly bloom: readonly ["scene", "layer"];
     readonly diffusion: readonly ["scene", "layer"];
@@ -66,6 +68,8 @@ export declare const EFFECT_SPECS: Record<EffectKey, Readonly<Record<string, Eff
 export declare const EFFECT_COLOR_SPECS: Partial<Record<EffectKey, Readonly<Record<string, EffectColorSpec>>>>;
 /** Boolean defaults, validated alongside numeric and color parameters. */
 export declare const EFFECT_BOOLEAN_SPECS: Partial<Record<EffectKey, Readonly<Record<string, EffectBooleanSpec>>>>;
+/** Blend-mode order shared by effect editors and shader uniforms. */
+export declare const EFFECT_BLEND_MODES: readonly ["normal", "darken", "multiply", "colorBurn", "linearBurn", "add", "lighten", "screen", "colorDodge", "overlay", "softLight", "hardLight", "vividLight", "linearLight", "pinLight", "hardMix", "difference", "exclusion", "subtract", "divide", "hue", "saturation", "color", "luminosity"];
 /** Enum defaults and allowed values. */
 export declare const EFFECT_ENUM_SPECS: Partial<Record<EffectKey, Readonly<Record<string, EffectEnumSpec>>>>;
 /** Select the layer effects from any value set containing them. */

package/dist/values/effect-schema.js

@@ -8,6 +8,8 @@ export const EFFECT_SCOPES = {
     colorWheels: ['scene', 'layer'],
     colorShift: ['scene', 'layer'],
     selectColors: ['scene', 'layer'],
+    gradient: ['scene', 'layer'],
+    flare: ['scene'],
     blur: ['scene', 'layer'],
     bloom: ['scene', 'layer'],
     diffusion: ['scene', 'layer'],
@@ -122,6 +124,25 @@ export const EFFECT_SPECS = {
         saturation: { default: -1, min: -1, max: 1, step: 0.01 },
         blend: { default: 1, min: 0, max: 1, step: 0.01 },
     },
+    gradient: {
+        radius: { default: 1, min: 0, max: 3, step: 0.01 },
+        smoothness: { default: 1, min: 0, max: 5, step: 0.01 },
+        centerX: { default: 0, min: -1, max: 1, step: 0.01 },
+        centerY: { default: 0, min: -1, max: 1, step: 0.01 },
+        angle: { default: 0, min: -180, max: 180, step: 1, unit: '°' },
+        scaleX: { default: 1, min: 0, max: 2, step: 0.01 },
+        scaleY: { default: 0.5, min: 0, max: 2, step: 0.01 },
+        opacity: { default: 1, min: 0, max: 1, step: 0.01 },
+    },
+    flare: {
+        intensity: { default: 0, min: 0, max: 1, step: 0.01 },
+        size: { default: 0, min: 0, max: 2, step: 0.01 },
+        angle: { default: 0, min: -180, max: 180, step: 1, unit: '°' },
+        glowOpacity: { default: 1, min: 0, max: 1, step: 0.01 },
+        raysScale: { default: 0, min: 0, max: 1, step: 0.01 },
+        raysIntensity: { default: 0, min: 0, max: 1, step: 0.01 },
+        raysOpacity: { default: 1, min: 0, max: 1, step: 0.01 },
+    },
     blur: {
         radius: { default: 8, min: 0, max: 64, step: 0.5, unit: 'px' },
     },
@@ -240,6 +261,14 @@ export const EFFECT_SPECS = {
  * string param appear.
  */
 export const EFFECT_COLOR_SPECS = {
+    gradient: {
+        color: { default: '#ffffff' },
+        backgroundColor: { default: '#000000' },
+    },
+    flare: {
+        color: { default: '#ffffff' },
+        raysColor: { default: '#ffffff' },
+    },
     colorWheels: {
         liftColor: { default: '#ffffff' },
         gammaColor: { default: '#ffffff' },
@@ -280,6 +309,11 @@ export const EFFECT_COLOR_SPECS = {
 };
 /** Boolean defaults, validated alongside numeric and color parameters. */
 export const EFFECT_BOOLEAN_SPECS = {
+    flare: { rays: { default: false } },
+    gradient: {
+        invert: { default: false },
+        transparentBackground: { default: false },
+    },
     blur: { highQuality: { default: false } },
     bloom: {
         selectColors: { default: false },
@@ -306,40 +340,50 @@ export const EFFECT_BOOLEAN_SPECS = {
         color10Enabled: { default: false },
     },
 };
+/** Blend-mode order shared by effect editors and shader uniforms. */
+export const EFFECT_BLEND_MODES = [
+    'normal',
+    'darken',
+    'multiply',
+    'colorBurn',
+    'linearBurn',
+    'add',
+    'lighten',
+    'screen',
+    'colorDodge',
+    'overlay',
+    'softLight',
+    'hardLight',
+    'vividLight',
+    'linearLight',
+    'pinLight',
+    'hardMix',
+    'difference',
+    'exclusion',
+    'subtract',
+    'divide',
+    'hue',
+    'saturation',
+    'color',
+    'luminosity',
+];
 /** Enum defaults and allowed values. */
 export const EFFECT_ENUM_SPECS = {
+    flare: {
+        mode: { default: 'add', values: ['add', 'screen', 'colorDodge'] },
+        raysMode: { default: 'sun', values: ['sun', 'shine', 'god'] },
+    },
+    gradient: {
+        type: { default: 'circle', values: ['solid', 'linear', 'circle', 'ellipse'] },
+        blendMode: { default: 'normal', values: EFFECT_BLEND_MODES },
+    },
     blur: { mode: { default: 'gaussian', values: ['gaussian', 'bokeh'] } },
     bloom: { mode: { default: 'normal', values: ['normal', 'streak', 'star'] } },
     rim: {
         mode: { default: 'single', values: ['single', 'double', 'sharpenSingle', 'sharpenDouble'] },
         blendMode: {
             default: 'overlay',
-            values: [
-                'normal',
-                'darken',
-                'multiply',
-                'colorBurn',
-                'linearBurn',
-                'add',
-                'lighten',
-                'screen',
-                'colorDodge',
-                'overlay',
-                'softLight',
-                'hardLight',
-                'vividLight',
-                'linearLight',
-                'pinLight',
-                'hardMix',
-                'difference',
-                'exclusion',
-                'subtract',
-                'divide',
-                'hue',
-                'saturation',
-                'color',
-                'luminosity',
-            ],
+            values: EFFECT_BLEND_MODES,
         },
     },
     outline: { quality: { default: 'medium', values: ['low', 'medium', 'high'] } },
@@ -396,7 +440,9 @@ export const ALL_EFFECT_STACK_ORDER = [
     'colorWheels',
     'colorShift',
     'selectColors',
+    'gradient',
     'blur',
+    'flare',
     'pixelate',
     'glitch',
     'droplets',

package/dist/values/hotkeys.d.ts

@@ -1,3 +1,4 @@
+import type { Hotkey } from '../wire/types.ts';
 /** True when the combo carries a command modifier and so may be registered globally. */
 export declare function hasCommandModifier(accelerator: string | null): boolean;
 /**
@@ -6,3 +7,9 @@ export declare function hasCommandModifier(accelerator: string | null): boolean;
  * every writer canonicalizes; it does not validate one.
  */
 export declare function canRunInBackground(accelerator: string | null): boolean;
+/** True when a model hotkey is meant to fire while Persona sits in the background — what main registers on, and what the globe shows. */
+export declare function hotkeyRunsInBackground(h: Hotkey): boolean;
+/** Accelerators bound by more than one entry — the warning every shortcut list raises. */
+export declare function duplicateAccelerators(bindings: readonly {
+    accelerator: string | null;
+}[]): Set<string>;

package/dist/values/hotkeys.js

@@ -20,3 +20,20 @@ export function canRunInBackground(accelerator) {
         return false;
     return hasCommandModifier(accelerator) || accelerator.split('+').every(isControllerTriggerName);
 }
+/** True when a model hotkey is meant to fire while Persona sits in the background — what main registers on, and what the globe shows. */
+export function hotkeyRunsInBackground(h) {
+    return h.global && h.active && h.action !== null && canRunInBackground(h.accelerator);
+}
+/** Accelerators bound by more than one entry — the warning every shortcut list raises. */
+export function duplicateAccelerators(bindings) {
+    const seen = new Set();
+    const dupes = new Set();
+    for (const b of bindings) {
+        if (b.accelerator === null)
+            continue;
+        if (seen.has(b.accelerator))
+            dupes.add(b.accelerator);
+        seen.add(b.accelerator);
+    }
+    return dupes;
+}

package/dist/wire/types.d.ts

@@ -607,8 +607,50 @@ export interface SceneDroplets {
     /** Specular glint on drops where the frame is transparent, so rain reads over the desktop (0 to 1). */
     glints: number;
 }
-/** Blend modes shared with Shoost's rim light. */
+/** Blend modes shared by Shoost's rim light and gradient. */
 export type EffectBlendMode = 'normal' | 'darken' | 'multiply' | 'colorBurn' | 'linearBurn' | 'add' | 'lighten' | 'screen' | 'colorDodge' | 'overlay' | 'softLight' | 'hardLight' | 'vividLight' | 'linearLight' | 'pinLight' | 'hardMix' | 'difference' | 'exclusion' | 'subtract' | 'divide' | 'hue' | 'saturation' | 'color' | 'luminosity';
+/** Solid, linear, or radial color overlay in scene or source coordinates. */
+export interface EffectGradient {
+    enabled: boolean;
+    type: 'solid' | 'linear' | 'circle' | 'ellipse';
+    blendMode: EffectBlendMode;
+    /** Foreground color (hex). */
+    color: string;
+    /** Outer or background color (hex). */
+    backgroundColor: string;
+    invert: boolean;
+    transparentBackground: boolean;
+    radius: number;
+    smoothness: number;
+    /** Horizontal center offset in normalized coordinates, -1..1. */
+    centerX: number;
+    /** Vertical center offset in normalized coordinates, -1..1. */
+    centerY: number;
+    /** Gradient rotation in degrees, -180..180. */
+    angle: number;
+    scaleX: number;
+    scaleY: number;
+    opacity: number;
+}
+/** Directional screen-space light with an independent monitor glow. */
+export interface SceneFlare {
+    enabled: boolean;
+    mode: 'add' | 'screen' | 'colorDodge';
+    /** Light color (hex). */
+    color: string;
+    intensity: number;
+    size: number;
+    /** Light direction in degrees, -180..180. */
+    angle: number;
+    glowOpacity: number;
+    rays: boolean;
+    raysMode: 'sun' | 'shine' | 'god';
+    /** Particle-ray color (hex). */
+    raysColor: string;
+    raysScale: number;
+    raysIntensity: number;
+    raysOpacity: number;
+}
 /** Directional silhouette lighting, optionally sharpened or applied to both sides. */
 export interface SceneRim {
     enabled: boolean;
@@ -698,6 +740,8 @@ export interface EffectValues {
     colorWheels: EffectColorWheels;
     colorShift: EffectColorShift;
     selectColors: EffectSelectColors;
+    gradient: EffectGradient;
+    flare: SceneFlare;
     blur: EffectBlur;
     chromaticAberration: SceneChromaticAberration;
     grain: SceneFilmGrain;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/persona-sdk",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "TypeScript SDK and wire schema for the LAPLACE Persona plugin API",
   "license": "MIT",
   "type": "module",