@qilin-agent/client-ui-theme-brand 3.1.5 → 3.1.7

package/lib/types/client/index.d.ts

@@ -1,10 +1,12 @@
-/** QiLin brand color layer for the Web client theme. */
+/** Color packs for the Web client theme: every shipped pack registers as one selectable skin. */
 import type { Context as ClientContext } from '@qilin-agent/kylin';
-/** Required service: the theme registry and override stack. */
+/** Required service: the theme registry and its skin registry. */
 export declare const inject: string[];
 /**
- * Stack the QiLin brand layer over whatever palette the user selected. The
- * layer is an effect, so unloading the plugin restores the covered tokens.
+ * Register every shipped color pack as a selectable skin. Light/dark selection
+ * stays the user's; a skin only replaces the alias tokens it names. Registration
+ * is an effect, so unloading the plugin removes every skin and restores the
+ * platform palette while the durable selection survives for a later load.
  * @param ctx - Client root context.
  */
 export declare function apply(ctx: ClientContext): void;

package/lib/types/index.d.ts

@@ -1,7 +1,14 @@
 /**
- * QiLin brand color plugin, node half. The empty apply gives Loader a host-side
- * row while the browser half ships through `exports["./client"]`.
+ * Color packs, node half: contributes each pack's canvas colors so the
+ * pre-plugin index render paints the user's palette before any browser plugin
+ * runs. The browser half ships through `exports["./client"]`.
  */
-/** Host plugin body — this package contributes browser presentation only. */
-export declare function apply(): void;
+import type { Context } from '@qilin-agent/kylin';
+/** Required Host services: the boot registry the index render reads. */
+export declare const inject: string[];
+/**
+ * Register every shipped pack's canvas colors for the pre-plugin interval.
+ * @param ctx - Host plugin context.
+ */
+export declare function apply(ctx: Context): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/packs/mono.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The monochrome color pack: one neutral ramp from pure white to pure black,
+ * with no hue. Accent, canvas, and ink are all greys; the light scheme uses a
+ * near-black accent so white on-accent text and focus rings clear AA, and the
+ * dark scheme mirrors it with an off-white accent on black.
+ *
+ * State colors, masks, and the ongoing blue stay with the base palettes, the
+ * same omission rule as every pack. Hover darkens the light accent and
+ * brightens the dark one, matching each platform's convention.
+ */
+import type { ThemeTokenOverrides } from '@qilin-agent/client-ui-theme/client';
+import type { SkinPack } from '../skin.ts';
+/** Monochrome tokens over the platform palettes. Every value states both schemes. */
+export declare const MONO_TOKENS: ThemeTokenOverrides;
+/** The monochrome pack as one selectable skin. */
+export declare const MONO_PACK: SkinPack;
+//# sourceMappingURL=mono.d.ts.map

package/lib/types/{client/tokens.d.ts → packs/qilin.d.ts}

@@ -1,9 +1,8 @@
 /**
- * QiLin alias-token overrides, applied as one layer over the active palette.
+ * The dark-gold color pack: the "玄金" landing VI extended to both schemes.
  *
- * The palette is the "玄金麒麟" (dark-gold) landing VI extended to both
- * schemes: the dark values transplant the landing page's tokens verbatim
- * (apps/web/src/landing/landing.css), the light values derive the matching
+ * The dark values transplant the landing page's tokens verbatim
+ * (apps/web/src/landing/landing.css); the light values derive the matching
  * warm-paper variant because the landing VI ships no light mode. Accent
  * contrast is WCAG AA verified: the deep link gold #7d6126 clears 5.3:1 on
  * paper #f8f5ee where the VI's gold-700 #8f6f2e reaches only 4.3:1, and
@@ -16,14 +15,9 @@
  * light schemes darken (gold-700 -> #7d6126).
  */
 import type { ThemeTokenOverrides } from '@qilin-agent/client-ui-theme/client';
-/**
- * The layer source id. One layer per source, so this names the origin in
- * `ctx.theme` inspection and makes re-application replace rather than stack.
- */
-export declare const QILIN_THEME_SOURCE = "@qilin-agent/client-ui-theme-brand";
-/**
- * QiLin's brand tokens over the platform palettes. Every value states both
- * schemes (the ThemeTokenModes contract), grouped by surface family.
- */
+import type { SkinPack } from '../skin.ts';
+/** Dark-gold tokens over the platform palettes. Every value states both schemes. */
 export declare const QILIN_TOKENS: ThemeTokenOverrides;
-//# sourceMappingURL=tokens.d.ts.map
+/** The dark-gold pack as one selectable skin. */
+export declare const QILIN_PACK: SkinPack;
+//# sourceMappingURL=qilin.d.ts.map

package/lib/types/packs/verdant.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The green color pack: light-green paper with a deep green accent in the
+ * light scheme, and a deep ink-green canvas with a light green accent in the
+ * dark scheme. Accent contrast is WCAG AA verified: white on #2f6b4b clears
+ * 6.4:1, the light link #2a5a40 clears 6.5:1 on #f1f6f2, and the dark accent
+ * #8fd0a8 clears 11:1 on the #0a120e canvas.
+ *
+ * State colors, masks, and the ongoing blue stay with the base palettes, the
+ * same omission rule as every pack. Hover darkens the light accent and
+ * brightens the dark one, matching each platform's convention.
+ */
+import type { ThemeTokenOverrides } from '@qilin-agent/client-ui-theme/client';
+import type { SkinPack } from '../skin.ts';
+/** Green tokens over the platform palettes. Every value states both schemes. */
+export declare const VERDANT_TOKENS: ThemeTokenOverrides;
+/** The green pack as one selectable skin. */
+export declare const VERDANT_PACK: SkinPack;
+//# sourceMappingURL=verdant.d.ts.map

package/lib/types/skin.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The shipped color packs, shared by the node and browser halves.
+ *
+ * A pack is one selectable skin: an id, a provider-owned label, the canvas
+ * colors the pre-plugin index render paints, and the alias-token overrides for
+ * both base palettes. Packs are identified by their palette, never by a
+ * product name, so a composition can pick any of them without exposing who
+ * uses it.
+ */
+import type { ThemeTokenOverrides } from '@qilin-agent/client-ui-theme/client';
+import { QILIN_PACK, QILIN_TOKENS } from './packs/qilin.ts';
+/** One selectable color pack as both halves consume it. */
+export interface SkinPack {
+    /** Stable id persisted by the appearance row. */
+    readonly id: string;
+    /** Provider-owned display name, resolved through the language chain. */
+    readonly label: Readonly<{
+        en: string;
+        readonly [locale: string]: string;
+    }>;
+    /** Canvas colors for the pre-plugin interval, matching the pack's base background. */
+    readonly boot: Readonly<{
+        light: string;
+        dark: string;
+    }>;
+    /** Alias-token overrides; every token states both palettes. */
+    readonly tokens: ThemeTokenOverrides;
+}
+/** Every shipped pack, in appearance-row order. */
+export declare const SKIN_PACKS: readonly SkinPack[];
+/** The dark-gold pack's id, persisted as the product default. */
+export declare const QILIN_SKIN_ID: string;
+/** The dark-gold pack's display name. */
+export declare const QILIN_SKIN_LABEL: Readonly<{
+    readonly [locale: string]: string;
+    en: string;
+}>;
+/** The dark-gold pack's canvas colors. */
+export declare const QILIN_SKIN_BOOT: Readonly<{
+    light: string;
+    dark: string;
+}>;
+export { QILIN_PACK, QILIN_TOKENS };
+//# sourceMappingURL=skin.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-theme-brand",
   "description": "QiLin brand color layer for the Web client theme: alias-token overrides stacked over the user's active palette",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -38,12 +38,12 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/client-test-runtime": "3.1.5",
-    "@qilin-agent/client-ui-theme": "3.1.5"
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/client-ui-theme": "3.1.7",
+    "@qilin-agent/client-test-runtime": "3.1.7"
   },
   "files": [
     "lib/index.js",