@quidgest/ui 0.16.30 → 0.16.32

package/esm/utils/theme.d.ts

@@ -1,4 +1,4 @@
-import { DeepReadonly, MaybeRefOrGetter } from 'vue';
+import { DeepReadonly, Ref } from 'vue';
 import { ThemeDefinition, ThemeInstance } from '../composables/theme';
 export declare const THEME_NODE_ID = "q-theme";
 /**
@@ -33,24 +33,24 @@ export declare function generateRootStyle(themes: ThemeDefinition[]): void;
  */
 export declare function toProperty(color: string): string;
 /**
- * Creates a reactive theme instance for a given theme name.
+ * Creates a reactive theme instance bound to a given theme name and list of theme definitions.
  *
- * This provides reactive access to the currently active theme and
- * computed properties for applying its CSS class and CSS variables.
+ * This function ensures the active theme is always kept in sync with the provided `name` ref,
+ * and exposes reactive/computed properties for convenient use in templates and styling.
  *
- * @param name - The name of the theme to activate, or a getter/ref returning a string.
- * @param themes - A readonly array of available theme definitions.
+ * @param name - A reactive `Ref<string>` representing the active theme name.
+ * @param themes - A reactive `Ref<ThemeDefinition[]>` containing all available themes.
  *
- * @returns A `ThemeInstance` object containing:
- *   - `name`: a reactive `Ref<string>` of the active theme name.
- *   - `current`: a computed `Ref<ThemeDefinition>` of the active theme.
- *   - `themes`: the array of all available theme definitions.
- *   - `class`: a computed CSS class string for the active theme.
- *   - `css`: a computed string of CSS variables for the active theme.
+ * @returns A `ThemeInstance` object with the following reactive properties:
+ *   - `name`: the reactive `Ref<string>` of the active theme name.
+ *   - `current`: a computed `Ref<ThemeDefinition>` of the active theme definition.
+ *   - `themes`: the reactive `Ref<ThemeDefinition[]>` of all available themes.
+ *   - `class`: a computed `Ref<string>` of the CSS class for the active theme.
+ *   - `css`: a computed `Ref<string>` of the CSS variables for the active theme.
  *
- * @throws Will throw an error if no theme with the specified name exists in `themes`.
+ * @throws {Error} If no theme matching the active `name` exists in `themes`.
  */
-export declare function createThemeInstance(name: MaybeRefOrGetter<string>, themes: DeepReadonly<ThemeDefinition[]>): ThemeInstance;
+export declare function createThemeInstance(name: Ref<string>, themes: DeepReadonly<Ref<ThemeDefinition[]>>): ThemeInstance;
 /**
  * Generates a CSS class name for a given theme.
  *

package/esm/utils/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAQ1E,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAY/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,UAoBtD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,QAM1D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,UAOvC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,MAAM,EAAE,YAAY,CAAC,eAAe,EAAE,CAAC,GACrC,aAAa,CAqBf;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,UAEzC"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAQ1E,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAY/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,UAoBtD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,QAM1D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,UAOvC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,GAC1C,aAAa,CAmBf;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,UAEzC"}

package/esm/utils/theme.js

@@ -1,63 +1,63 @@
-import { ref as d, toValue as p, computed as c } from "vue";
-import { parseColor as $ } from "./color.js";
-import { toKebabCase as l } from "./string.js";
-const a = "q-theme";
-function g() {
+import { computed as c } from "vue";
+import { parseColor as d } from "./color.js";
+import { toKebabCase as a } from "./string.js";
+const m = "q-theme";
+function h() {
   let e = document.getElementById(
-    a
+    m
   );
-  return e || (e = document.createElement("style"), e.id = a, document.head.appendChild(e)), e;
+  return e || (e = document.createElement("style"), e.id = m, document.head.appendChild(e)), e;
 }
 function i(e) {
-  let t = `.${f(e.name)} {
+  let t = `.${l(e.name)} {
 `;
   const n = e.scheme;
   let o;
   for (o in n) {
-    const r = n[o];
-    if (r) {
-      t += `  ${u(o)}: ${r};
+    const s = n[o];
+    if (s) {
+      t += `  ${u(o)}: ${s};
 `;
-      const s = $(r);
-      t += `  ${u(o)}-rgb: ${s.r} ${s.g} ${s.b};
+      const r = d(s);
+      t += `  ${u(o)}-rgb: ${r.r} ${r.g} ${r.b};
 `;
     }
   }
   return t += `}
 `, t;
 }
-function b(e) {
+function C(e) {
   const t = e.map(i).join(`
-`), n = g();
+`), n = h();
   n.textContent = t;
 }
 function u(e) {
-  return e ? `--q-theme-${l(e)}` : "";
+  return e ? `--q-theme-${a(e)}` : "";
 }
-function v(e, t) {
-  const n = d(p(e)), o = c(() => {
-    const m = t.find((h) => h.name === n.value);
-    if (!m)
-      throw new Error(`Theme "${n.value}" not found`);
-    return m;
-  }), r = c(() => f(o.value.name)), s = c(() => i(o.value));
+function T(e, t) {
+  const n = c(() => {
+    const r = t.value.find((f) => f.name === e.value);
+    if (!r)
+      throw new Error(`[Quidgest UI] Theme "${e.value}" not found`);
+    return r;
+  }), o = c(() => l(n.value.name)), s = c(() => i(n.value));
   return {
-    name: n,
-    current: o,
+    name: e,
+    current: n,
     themes: t,
-    class: r,
+    class: o,
     css: s
   };
 }
-function f(e) {
-  return `q-theme--${l(e)}`;
+function l(e) {
+  return `q-theme--${a(e)}`;
 }
 export {
-  a as THEME_NODE_ID,
-  v as createThemeInstance,
-  b as generateRootStyle,
+  m as THEME_NODE_ID,
+  T as createThemeInstance,
+  C as generateRootStyle,
   i as generateThemeCss,
-  f as getThemeClass,
-  g as getThemeNode,
+  l as getThemeClass,
+  h as getThemeNode,
   u as toProperty
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@quidgest/ui",
   "description": "Quidgest's UI framework",
-  "version": "0.16.30",
+  "version": "0.16.32",
   "private": false,
   "type": "module",
   "author": "Quidgest",