@loworbitstudio/visor-theme-engine 0.12.0 → 0.13.0

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { g as GeneratedPrimitives, m as SemanticTokens, R as ResolvedThemeConfig } from '../types-BKEkyelS.js';
+import { g as GeneratedPrimitives, m as SemanticTokens, R as ResolvedThemeConfig } from '../types-CSO2avFQ.js';
 
 /**
  * Adapter types for the Visor theme engine.

package/dist/adapters/index.js

@@ -18,7 +18,7 @@ import {
   resolveThemeBrand,
   resolveThemeFonts,
   sectionComment
-} from "../chunk-B56A5DE6.js";
+} from "../chunk-KFTTL3XP.js";
 
 // src/adapters/layers.ts
 var LAYER_ORDER = "@layer visor-primitives, visor-semantic, visor-brand, visor-adaptive, visor-bridge;";

package/dist/{chunk-B56A5DE6.js → chunk-KFTTL3XP.js}

@@ -802,7 +802,8 @@ var BRAND_VARIANTS = [
   "brandmark",
   "wordmark",
   "monochrome",
-  "favicon"
+  "favicon",
+  "animated"
 ];
 
 // src/brand/pipeline.ts

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, c as VisorBrand, B as BrandSlot, d as BrandSource, e as BrandResolution, f as ThemeBrandResult, R as ResolvedThemeConfig, g as GeneratedPrimitives, h as ThemeOutput, i as ThemeData, j as VisorThemeConfig, k as FullShadeScale, C as ColorRole, S as SelectiveShadeScale, l as RGB, P as ParsedColor, O as OKLCH, m as SemanticTokens, n as ShadeStep } from './types-BKEkyelS.js';
-export { o as BRAND_VARIANTS, p as BrandVariant, q as ColorFormat, r as FontSource, s as RGBA, t as SemanticTokenValue } from './types-BKEkyelS.js';
+import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, c as VisorBrand, B as BrandSlot, d as BrandSource, e as BrandResolution, f as ThemeBrandResult, R as ResolvedThemeConfig, g as GeneratedPrimitives, h as ThemeOutput, i as ThemeData, j as VisorThemeConfig, k as FullShadeScale, C as ColorRole, S as SelectiveShadeScale, l as RGB, P as ParsedColor, O as OKLCH, m as SemanticTokens, n as ShadeStep } from './types-CSO2avFQ.js';
+export { o as BRAND_VARIANTS, p as BrandVariant, q as ColorFormat, r as FontSource, s as RGBA, t as SemanticTokenValue } from './types-CSO2avFQ.js';
 
 /**
  * Font resolver — maps font family names to loadable font resources.
@@ -631,6 +631,9 @@ var properties = {
 			favicon: {
 				$ref: "#/$defs/brandSlot"
 			},
+			animated: {
+				$ref: "#/$defs/brandSlot"
+			},
 			custom: {
 				type: "object",
 				description: "Operator-defined slots, addressed by key.",

package/dist/index.js

@@ -42,7 +42,7 @@ import {
   rgbToHex,
   rgbToOklch,
   serializeColor
-} from "./chunk-B56A5DE6.js";
+} from "./chunk-KFTTL3XP.js";
 
 // src/fonts/validate-coverage.ts
 var FONT_VAR_RE = /--font-(heading|display|body|sans|mono)\s*:\s*([^;]+);/g;
@@ -457,6 +457,7 @@ var visor_theme_schema_default = {
         wordmark: { $ref: "#/$defs/brandSlot" },
         monochrome: { $ref: "#/$defs/brandSlot" },
         favicon: { $ref: "#/$defs/brandSlot" },
+        animated: { $ref: "#/$defs/brandSlot" },
         custom: {
           type: "object",
           description: "Operator-defined slots, addressed by key.",
@@ -705,9 +706,10 @@ var KNOWN_BRAND_KEYS = /* @__PURE__ */ new Set([
   "wordmark",
   "monochrome",
   "favicon",
+  "animated",
   "custom"
 ]);
-var KNOWN_BRAND_STANDARD_SLOTS = ["logo", "brandmark", "wordmark", "monochrome", "favicon"];
+var KNOWN_BRAND_STANDARD_SLOTS = ["logo", "brandmark", "wordmark", "monochrome", "favicon", "animated"];
 var KNOWN_BRAND_SLOT_KEYS = /* @__PURE__ */ new Set(["slug", "formats", "light", "dark", "clearSpace", "aspectRatio"]);
 var KNOWN_BRAND_SOURCES = /* @__PURE__ */ new Set(["visor-brands", "local"]);
 var KNOWN_BRAND_CDN_OVERRIDE_KEYS = /* @__PURE__ */ new Set(["visor-brands"]);
@@ -1039,6 +1041,20 @@ function validateConfig(config) {
           }
         }
       }
+      if (typeof brand.animated === "object" && brand.animated !== null) {
+        const animated = brand.animated;
+        if (Array.isArray(animated.formats) && !animated.formats.every(
+          (f) => typeof f === "string" && f.toLowerCase() === "svg"
+        )) {
+          errors.push("'brand.animated.formats' must be SVG-only (the animated slot accepts self-contained animated SVGs only)");
+        }
+        for (const mode of ["light", "dark"]) {
+          const p = animated[mode];
+          if (typeof p === "string" && !p.toLowerCase().endsWith(".svg")) {
+            errors.push(`'brand.animated.${mode}' must be an .svg path (the animated slot is SVG-only)`);
+          }
+        }
+      }
     }
   }
   if (obj.overrides !== void 0) {
@@ -1112,6 +1128,9 @@ function resolveBrand(brand) {
     wordmark: brand.wordmark ?? DEFAULT_VISOR_BRAND.wordmark,
     monochrome: brand.monochrome ?? DEFAULT_VISOR_BRAND.monochrome,
     favicon: brand.favicon ?? DEFAULT_VISOR_BRAND.favicon,
+    // animated is optional with no Visor default (D2): pass through only when a
+    // theme declares it, so undeclared themes emit no --brand-animated.
+    ...brand.animated && { animated: brand.animated },
     ...brand.custom && { custom: brand.custom }
   };
 }
@@ -1407,7 +1426,7 @@ var SEMANTIC_SURFACE_MAP = {
   // VI-478: status soft tints (BL-193) — alpha overlays, semantically distinct
   // from the OPAQUE `surface-{status}-subtle` above (do NOT alias them together).
   // Default to a color-mix of the status color so they track the theme; themes
-  // pin exact values via overrides (blacklight-underground: success @10%,
+  // pin exact values via overrides (blacklight-pro: success @10%,
   // warning/error @12%).
   "success-soft": {
     light: { constant: "color-mix(in srgb, var(--color-success-500) 10%, transparent)" },
@@ -1504,7 +1523,7 @@ var SEMANTIC_INTERACTIVE_MAP = {
   // VI-478: brand-derived alpha-overlay helpers (BL-193). `soft`/`glow` are
   // alpha overlays that track the theme's primary via color-mix (distinct from
   // any opaque surface); `strong` is a solid lightened-brand emphasis color.
-  // Themes pin exact values via overrides — e.g. blacklight-underground sets
+  // Themes pin exact values via overrides — e.g. blacklight-pro sets
   // soft @12% / glow @32% / strong #FFD050.
   "primary-soft": {
     light: { constant: "color-mix(in srgb, var(--color-primary-500) 12%, transparent)" },

package/dist/{types-BKEkyelS.d.ts → types-CSO2avFQ.d.ts}

@@ -138,7 +138,7 @@ type BrandSource = "visor-brands" | "local";
  * Standard brand variant slots. A fixed set covers the common lockups; custom
  * operator-defined slots are addressed by key through the `custom` map.
  */
-type BrandVariant = "logo" | "brandmark" | "wordmark" | "monochrome" | "favicon";
+type BrandVariant = "logo" | "brandmark" | "wordmark" | "monochrome" | "favicon" | "animated";
 /** Ordered list of the standard brand variant slots. */
 declare const BRAND_VARIANTS: readonly BrandVariant[];
 /**
@@ -185,6 +185,13 @@ interface VisorBrand {
     monochrome?: BrandSlot;
     /** Favicon source. */
     favicon?: BrandSlot;
+    /**
+     * Animated lockup. Optional and SVG-only (D2/D3): the asset must be a
+     * self-contained animated SVG (inlined `<style>`/@keyframes or SMIL) so it
+     * animates inside `<img>`. Stock themes omit this — absent → no
+     * `--brand-animated` emitted. Reduced-motion consumers fall back to `logo`.
+     */
+    animated?: BrandSlot;
     /** Operator-defined slots, addressed by key. */
     custom?: Record<string, BrandSlot>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loworbitstudio/visor-theme-engine",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Theme engine for the Visor design system — shade generation, token mapping, font resolution, and import/export for .visor.yaml themes.",
   "type": "module",
   "main": "./dist/index.js",

package/src/visor-theme.schema.json

@@ -253,6 +253,7 @@
         "wordmark": { "$ref": "#/$defs/brandSlot" },
         "monochrome": { "$ref": "#/$defs/brandSlot" },
         "favicon": { "$ref": "#/$defs/brandSlot" },
+        "animated": { "$ref": "#/$defs/brandSlot" },
         "custom": {
           "type": "object",
           "description": "Operator-defined slots, addressed by key.",