lumiverse-spindle-types 0.4.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -623,6 +623,48 @@ export interface ThemeInfoDTO {
   characterAware: boolean;
 }
 
+/**
+ * Input config for `spindle.theme.generateVariables()`.
+ *
+ * Mirrors the inputs that Lumiverse's theme engine uses to produce the full
+ * set of ~80+ CSS variables. Extensions can use the result as a complete,
+ * coherent override set for `spindle.theme.apply()`.
+ */
+export interface ThemeVariablesConfigDTO {
+  /** Primary accent color in HSL. */
+  accent: { h: number; s: number; l: number };
+  /** Resolved color mode. */
+  mode: "dark" | "light";
+  /** Enable glassmorphic backdrop-filter tokens (default: `true`). */
+  enableGlass?: boolean;
+  /** Border radius multiplier (default: `1`). */
+  radiusScale?: number;
+  /** Font size multiplier (default: `1`). */
+  fontScale?: number;
+  /** Full UI zoom multiplier (default: `1`). */
+  uiScale?: number;
+  /** Optional base color overrides. Each value is a CSS color string. */
+  baseColors?: {
+    primary?: string;
+    secondary?: string;
+    background?: string;
+    text?: string;
+    danger?: string;
+    success?: string;
+    warning?: string;
+    /** Dialogue / speech color override. */
+    speech?: string;
+    /** Italic / thoughts color override. */
+    thoughts?: string;
+  };
+  /** Status color overrides (danger, success, warning). */
+  statusColors?: {
+    danger?: string;
+    success?: string;
+    warning?: string;
+  };
+}
+
 // ─── Modal content items (used by backend-initiated modals) ─────────────
 
 /**
@@ -933,6 +975,8 @@ export type WorkerToHost =
   | { type: "theme_get_current"; requestId: string; userId?: string }
   // ─── Color Extraction (gated: "app_manipulation") ─────────────────────
   | { type: "color_extract"; requestId: string; imageId: string; userId?: string }
+  // ─── Theme Variable Generation (gated: "app_manipulation") ────────────
+  | { type: "theme_generate_variables"; requestId: string; config: ThemeVariablesConfigDTO }
   // ─── Commands (free tier) ──────────────────────────────────────────────
   | { type: "commands_register"; commands: SpindleCommandDTO[] }
   | { type: "commands_unregister"; commandIds: string[] };

package/src/index.ts

@@ -53,6 +53,7 @@ export type {
   ImageGenResultDTO,
   ThemeOverrideDTO,
   ThemeInfoDTO,
+  ThemeVariablesConfigDTO,
   ColorExtractionResult,
   ColorRGB,
   ColorHSL,

package/src/spindle-api.ts

@@ -32,6 +32,7 @@ import type {
   ImageGenProviderDTO,
   ThemeOverrideDTO,
   ThemeInfoDTO,
+  ThemeVariablesConfigDTO,
   ColorExtractionResult,
   SpindleModalItemDTO,
   SpindleCommandDTO,
@@ -635,6 +636,27 @@ export interface SpindleAPI {
      * @param imageId - ID of an image in the images table
      */
     extractColors(imageId: string, userId?: string): Promise<ColorExtractionResult>;
+    /**
+     * Generate the full set of Lumiverse CSS variables from a theme config.
+     *
+     * Returns a `Record<string, string>` containing every CSS variable the
+     * theme engine would produce — primary accent variants, backgrounds,
+     * borders, text, glass tokens, shadows, radii, prose tokens, and more
+     * (~80+ variables). The result can be passed directly to `apply()` for a
+     * complete, coherent theme override.
+     *
+     * @example
+     * ```ts
+     * // Extract palette from an image, then generate + apply a full theme
+     * const palette = await spindle.theme.extractColors(imageId)
+     * const vars = await spindle.theme.generateVariables({
+     *   accent: palette.dominantHsl,
+     *   mode: 'dark',
+     * })
+     * await spindle.theme.apply({ variables: vars })
+     * ```
+     */
+    generateVariables(config: ThemeVariablesConfigDTO): Promise<Record<string, string>>;
   };
 
   /**