@qilin-agent/client-ui-theme 3.1.4 → 3.1.6

package/lib/types/index.d.ts

@@ -1,11 +1,53 @@
-/** Host registration for the browser theme preference and pre-plugin palette. */
+import type { Volatile } from '@qilin-agent/kylin';
+import type { ThemePreference } from './theme-settings.ts';
+import z from '@qilin-agent/schemastery';
 import type { Context } from '@qilin-agent/kylin';
-export { DEFAULT_FONT_SIZE, DEFAULT_PREFERENCE, FONT_SIZE_FIELD, FONT_SIZE_MAX, FONT_SIZE_MIN, THEME_PREFERENCE_FIELD, THEME_PREFERENCES, THEME_SETTINGS_NAMESPACE, type ThemePreference, type ThemeSettings, } from './theme-settings.ts';
+import { type FontFamilies } from './theme-settings.ts';
+export { DEFAULT_FONT_SIZE, DEFAULT_PREFERENCE, FONT_FAMILY_FIELDS, FONT_SIZE_FIELD, FONT_SIZE_MAX, FONT_SIZE_MIN, FONT_ROLES, FONT_SIZE_SPECS, THEME_PREFERENCE_FIELD, THEME_PREFERENCES, THEME_SETTINGS_NAMESPACE, type FontFamilies, type FontRole, type FontSizes, type ThemePreference, type ThemeSettings, } from './theme-settings.ts';
 /**
- * Register the durable theme section when the optional settings service is
- * composed, and answer every index injection collection with the current
- * theme bootstrap row.
- * @param ctx - Host context that may acquire the settings service.
+ * Font-family lists read from the live config, keyed by role.
+ * @param families - the detached per-role lists.
+ * @returns the frozen per-role font-family lists.
  */
-export declare function apply(ctx: Context): void;
+export declare function sectionFontFamilies(families: FontFamilies): FontFamilies;
+/** Runtime preferences projected to the browser. */
+export interface Config {
+    /** Browser palette preference. */
+    preference: Volatile<ThemePreference>;
+    /** Browser font size in pixels. */
+    fontSize: Volatile<number>;
+    /** Code-block font size in pixels. */
+    codeFontSize: Volatile<number>;
+    /** Sidebar terminal font size in pixels. */
+    terminalFontSize: Volatile<number>;
+    /** Interface and body text font list; `''` keeps the built-in stack. */
+    textFontFamily: Volatile<string>;
+    /** Code font list; `''` keeps the built-in stack. */
+    codeFontFamily: Volatile<string>;
+    /** Sidebar terminal font list; `''` keeps the built-in stack. */
+    terminalFontFamily: Volatile<string>;
+}
+/** Live theme and typography preferences. */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    preference: z<"light" | "dark" | "system", "light" | "dark" | "system", "volatile-defined">;
+    fontSize: z<number, number, "volatile">;
+    codeFontSize: z<number, number, "volatile">;
+    terminalFontSize: z<number, number, "volatile">;
+    textFontFamily: z<string, string, "volatile-defined">;
+    codeFontFamily: z<string, string, "volatile-defined">;
+    terminalFontFamily: z<string, string, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    preference: z<"light" | "dark" | "system", "light" | "dark" | "system", "volatile-defined">;
+    fontSize: z<number, number, "volatile">;
+    codeFontSize: z<number, number, "volatile">;
+    terminalFontSize: z<number, number, "volatile">;
+    textFontFamily: z<string, string, "volatile-defined">;
+    codeFontFamily: z<string, string, "volatile-defined">;
+    terminalFontFamily: z<string, string, "volatile-defined">;
+}>>, "plain">;
+/** Supply the current palette before browser plugins start.
+ * @param ctx Host plugin context.
+ * @param config Validated live theme preferences.
+ */
+export declare function apply(ctx: Context, config: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/theme-settings.d.ts

@@ -18,15 +18,117 @@ export declare const FONT_SIZE_MIN = 10;
 export declare const FONT_SIZE_MAX = 22;
 /** Content font size when the user-settings document has no override (px). */
 export declare const DEFAULT_FONT_SIZE = 14;
+/** Independently configurable font roles. */
+export declare const FONT_ROLES: readonly ["text", "code", "terminal"];
+/** One configurable font role: interface text, code, or the sidebar terminal. */
+export type FontRole = typeof FONT_ROLES[number];
+/** Settings field, body variable, and accepted integer px range of one role's font size. */
+export interface FontSizeSpec {
+    /** Settings field carrying the size. */
+    field: string;
+    /** Body variable carrying the size in px. */
+    variable: string;
+    /** Smallest accepted size. */
+    min: number;
+    /** Largest accepted size. */
+    max: number;
+    /** Size when the user-settings document has no override. */
+    default: number;
+}
+/**
+ * Font sizes by role. `text` is the conversation content size; `code` is the
+ * code-block size (inline code stays 1px larger); `terminal` is the sidebar
+ * terminal cell font size.
+ */
+export declare const FONT_SIZE_SPECS: {
+    readonly text: {
+        readonly field: "fontSize";
+        readonly variable: "--qilin-content-font-size";
+        readonly min: 10;
+        readonly max: 22;
+        readonly default: 14;
+    };
+    readonly code: {
+        readonly field: "codeFontSize";
+        readonly variable: "--qilin-code-font-size";
+        readonly min: 10;
+        readonly max: 16;
+        readonly default: 11;
+    };
+    readonly terminal: {
+        readonly field: "terminalFontSize";
+        readonly variable: "--qilin-terminal-font-size";
+        readonly min: 10;
+        readonly max: 20;
+        readonly default: 13;
+    };
+};
+/** Integer px font sizes by role. */
+export type FontSizes = Readonly<Record<FontRole, number>>;
+/** Default font sizes by role. */
+export declare const DEFAULT_FONT_SIZES: FontSizes;
+/** Settings field carrying each role's font-family list. */
+export declare const FONT_FAMILY_FIELDS: {
+    readonly text: "textFontFamily";
+    readonly code: "codeFontFamily";
+    readonly terminal: "terminalFontFamily";
+};
+/**
+ * Body variable carrying one role's normalized font list; the token sheet
+ * places it ahead of that role's built-in stack.
+ * @param kind - font role.
+ * @returns the CSS custom property name.
+ */
+export declare function fontFamilyVariable(kind: FontRole): string;
+/** Normalized CSS font-family lists by role; `''` selects the built-in stack. */
+export type FontFamilies = Readonly<Record<FontRole, string>>;
 /** Durable theme section shared by the Host schema and the browser scope. */
 export interface ThemeSettings {
     /** Selected built-in preference. */
     preference: ThemePreference;
     /** Conversation content font size in px (integer within {@link FONT_SIZE_MIN}..{@link FONT_SIZE_MAX}). */
     fontSize: number;
+    /** Code-block font size in px (integer within the {@link FONT_SIZE_SPECS} `code` range). */
+    codeFontSize: number;
+    /** Sidebar terminal font size in px (integer within the {@link FONT_SIZE_SPECS} `terminal` range). */
+    terminalFontSize: number;
+    /** Interface and body text fonts placed before the built-in stack; `''` keeps the built-in stack. */
+    textFontFamily: string;
+    /** Code fonts placed before the built-in code stack; `''` keeps the built-in stack. */
+    codeFontFamily: string;
+    /** Sidebar terminal fonts placed before the built-in terminal stack; `''` keeps the built-in stack. */
+    terminalFontFamily: string;
 }
+/**
+ * Integer px schema for one role's font size.
+ * @param spec - the role's range and default.
+ * @returns the validated number schema.
+ */
+export declare function fontSizeSchema(spec: FontSizeSpec): z<number>;
+/**
+ * Collect every role's size from a settings section.
+ * @param section - accepted theme settings.
+ * @returns integer px sizes by role.
+ */
+export declare function sectionFontSizes(section: ThemeSettings): FontSizes;
+/**
+ * Whether one value is an accepted size for a role.
+ * @param role - font role.
+ * @param px - candidate size.
+ * @returns true for an integer within the role's range.
+ */
+export declare function isFontSize(role: FontRole, px: number): boolean;
 /** Durable theme schema; also the wire envelope the browser scope validates against. */
 export declare const ThemeSettingsSchema: z<ThemeSettings>;
+/**
+ * Normalize user input into a CSS font-family list. Names are comma separated;
+ * quotes, backslashes, angle brackets, and control characters are dropped, and
+ * every non-generic name is double-quoted, so the result is always a valid list
+ * safe to embed in inline CSS and boot scripts. Normalizing a result returns it unchanged.
+ * @param value - user-entered or stored font list.
+ * @returns the normalized list, or `''` when no family name remains.
+ */
+export declare function normalizeFontFamily(value: string): string;
 /**
  * Narrow one wire or registry value to a persistable preference.
  * @param value - value crossing the settings or registry boundary.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-theme",
   "description": "Theme plugin: Host bootstrap for the pre-plugin palette; DOM-free ThemeRuntime for light/dark/system state; --qilin-* token styles and Appearance settings row",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -35,6 +35,7 @@
         "@qilin-agent/client-locale",
         "@qilin-agent/client-ui-renderer",
         "@qilin-agent/client-ui-settings",
+        "@qilin-agent/client-shortcuts",
         "@qilin-agent/api-remotes"
       ],
       "platform": "web",
@@ -43,24 +44,25 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "clsx": "^2.0.0",
-    "@qilin-agent/api-remotes": "3.1.4",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/client-connection": "3.1.4",
-    "@qilin-agent/client-locale": "3.1.4",
-    "@qilin-agent/client-store": "3.1.4",
-    "@qilin-agent/client-test-runtime": "3.1.4",
-    "@qilin-agent/client-ui-settings": "3.1.4",
-    "@qilin-agent/client-ui-renderer": "3.1.4",
-    "@qilin-agent/client-ui-slots": "3.1.4",
-    "@qilin-agent/settings": "3.1.4",
-    "@qilin-agent/host-webserver": "3.1.4",
-    "@qilin-agent/client-ui-primitives": "3.1.4"
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/api-remotes": "3.1.6",
+    "@qilin-agent/client-locale": "3.1.6",
+    "@qilin-agent/client-store": "3.1.6",
+    "@qilin-agent/client-shortcuts": "3.1.6",
+    "@qilin-agent/client-connection": "3.1.6",
+    "@qilin-agent/client-test-runtime": "3.1.6",
+    "@qilin-agent/client-ui-primitives": "3.1.6",
+    "@qilin-agent/client-ui-settings": "3.1.6",
+    "@qilin-agent/client-ui-slots": "3.1.6",
+    "@qilin-agent/settings": "3.1.6",
+    "@qilin-agent/client-ui-renderer": "3.1.6",
+    "@qilin-agent/host-webserver": "3.1.6"
   },
   "files": [
     "lib/index.js",
@@ -69,7 +71,7 @@
     "lib/types/**/*.d.ts"
   ],
   "dependencies": {
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5"
   },
   "scripts": {
     "bundle": "tsdown",