@quidgest/ui 0.14.11 → 0.14.13

package/esm/utils/date/date.js

@@ -0,0 +1,91 @@
+import { tokenizeFormat as g, staticTokensMap as h, isUnitRepetition as y, dynamicTokensMap as E } from "./tokens.js";
+function x(n) {
+  const r = g(n);
+  if (!r)
+    throw Error("Failed to tokenize format string.");
+  const i = [...r.sort((e, a) => a.length - e.length)], t = [n];
+  if (r.filter((e) => h[e] !== void 0).forEach((e) => {
+    const a = h[e];
+    d(a, t, e);
+    const c = i.indexOf(e);
+    i.splice(c, 1);
+  }), [...i].forEach((e) => {
+    if (!y(e))
+      throw new Error(`Invalid token format: ${e}. Tokens must be repeated characters.`);
+    const a = e[0], c = w(a, e.length);
+    d(c, t, e);
+    const f = i.indexOf(e);
+    i.splice(f, 1);
+  }), i.length > 0)
+    throw new Error(`Unhandled tokens remain: ${i.join(", ")}`);
+  return t.forEach((e, a) => {
+    t[a] = T(e);
+  }), t.length === 1 ? t[0] : t;
+}
+function T(n) {
+  const r = "\0";
+  return n.replace(/'((?:[^']|'')+)'/g, (i, t) => t.replace(/''/g, r).split("").map((e) => e === r ? "!'" : "!" + e).join(""));
+}
+function w(n, r) {
+  const i = [], t = E[n];
+  if (t === void 0)
+    throw new Error(`Dynamic token '${n}' not found.`);
+  if (typeof t == "string") {
+    const s = p(t, r);
+    i.push(s);
+  } else Array.isArray(i) && t.forEach((o) => {
+    const s = p(o, r);
+    i.push(s);
+  });
+  return i;
+}
+function p(n, r) {
+  const i = n.startsWith("-");
+  return i && (n = n.substring(1)), n = n.repeat(r), i && (n = `-${n}`), n;
+}
+function d(n, r, i) {
+  if (typeof n == "string") {
+    const t = n;
+    r.forEach((o, s) => {
+      r[s] = u(o, i, t);
+    });
+  } else if (Array.isArray(n)) {
+    const t = n.length, o = [...r], s = o.length;
+    for (let e = 1; e < t; e++)
+      r.push(...o);
+    n.forEach((e, a) => {
+      const c = a * s, f = c + s - 1;
+      for (let l = c; l <= f; l++)
+        r[l] = u(r[l], i, e);
+    });
+  }
+}
+function u(n, r, i) {
+  let t = "", o = 0, s = !1, e = "";
+  const a = r.length;
+  for (; o < n.length; ) {
+    const c = n[o];
+    if (!s && (c === "'" || c === '"')) {
+      s = !0, e = c, t += c, o++;
+      continue;
+    }
+    if (s)
+      if (c === e)
+        if (o + 1 < n.length && n[o + 1] === e) {
+          t += e + e, o += 2;
+          continue;
+        } else {
+          s = !1, t += c, o++;
+          continue;
+        }
+      else {
+        t += c, o++;
+        continue;
+      }
+    n.substring(o, o + a) === r ? (t += i, o += a) : (t += c, o++);
+  }
+  return t;
+}
+export {
+  x as convertDatePatternToMask
+};

package/esm/utils/date/index.d.ts

@@ -0,0 +1,4 @@
+import { convertDatePatternToMask } from './date';
+import { isTimeOnlyFormat } from './tokens';
+export { convertDatePatternToMask, isTimeOnlyFormat };
+//# sourceMappingURL=index.d.ts.map

package/esm/utils/date/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/date/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,CAAA"}

package/esm/utils/date/tokens.d.ts

@@ -0,0 +1,49 @@
+export type TokenMap = {
+    [token: string]: string | string[];
+};
+export declare const staticTokensMap: TokenMap;
+export declare const dynamicTokensMap: TokenMap;
+/**
+ * Tokenizes a given format string by matching against both variable and fixed token patterns.
+ *
+ * This function dynamically constructs a regular expression that first targets variable tokens
+ * (allowing for 1 to 4 greedy occurrences) and then fixed tokens (sorted in descending order of length).
+ * It escapes any special regex characters in both token maps to ensure that they are correctly interpreted
+ * as literal strings in the resulting Regex.
+ *
+ * @remarks
+ * The generated regular expression is used to match and extract tokens from the provided format string.
+ * If any tokens are found based on the specified patterns from `variableTokensMap` and `tokensMap`, an array
+ * of tokens is returned; otherwise, `null` is returned.
+ *
+ * @param format - The string containing the format to be tokenized.
+ * @returns An array of matched tokens if present, or `null` if no tokens match.
+ *
+ * @example
+ * ```ts
+ * const tokens = tokenizeFormat("YYYY-MM-DD");
+ * console.log(tokens); // ['YYYY', 'MM', 'DD']
+ * ```
+ *
+ * @see dynamicTokensMap
+ * @see staticTokensMap
+ */
+export declare function tokenizeFormat(format: string): RegExpMatchArray | null;
+/**
+ * Determines if a given format string represents a time-only format.
+ *
+ * @param format - The format string to check (e.g., 'HH:mm:ss', 'YYYY-MM-DD HH:mm').
+ * @returns `true` if the format is time-only, `false` if it includes date components.
+ */
+export declare function isTimeOnlyFormat(format: string): boolean;
+/**
+ * Checks whether the given token is not composed entirely of a single repeated character.
+ *
+ * A valid unit repetition (e.g., 'yyyy') consists of the same character repeated. This function
+ * returns false if the token consists solely of one repeating character, and true otherwise.
+ *
+ * @param token - The string token to evaluate.
+ * @returns False if the token is a unit repetition; true if it is not.
+ */
+export declare function isUnitRepetition(token: string): boolean;
+//# sourceMappingURL=tokens.d.ts.map

package/esm/utils/date/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/utils/date/tokens.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,CAAA;AA0I7D,eAAO,MAAM,eAAe,EAAE,QAG7B,CAAA;AAuBD,eAAO,MAAM,gBAAgB,EAAE,QAG9B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAuBtE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOxD;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,WAG7C"}

package/esm/utils/date/tokens.js

@@ -0,0 +1,243 @@
+const c = {
+  // Era
+  GGGGG: "A",
+  // A, B
+  GGGG: "S",
+  // Anno Domini, Before Christ
+  GGG: "AA",
+  // AD, BC
+  GG: "AA",
+  // AD, BC
+  G: "AA",
+  // AD, BC
+  // Calendar year (y)
+  yy: "##",
+  // 44, 01, 00, 17
+  y: "N",
+  // 44, 1, 1900, 2017, 9999
+  // Local week-numbering year (Y)
+  YY: "##",
+  // 44, 01, 00, 17
+  Y: "N",
+  // 44, 1, 1900, 2017, 9999
+  // Quarter (formatting) – Q tokens
+  QQQQQ: "#",
+  // 1, 2, 3, 4
+  QQQQ: "#aa W",
+  // 1st quarter, 2nd quarter, ...
+  QQQ: "Q#",
+  // Q1, Q2, Q3, Q4
+  QQ: "##",
+  // 01, 02, 03, 04
+  Q: "#",
+  // 1, 2, 3, 4
+  // Quarter (stand-alone) – q tokens
+  qqqqq: "#",
+  // 1, 2, 3, 4
+  qqqq: "#aa W",
+  // 1st quarter, 2nd quarter, ...
+  qqq: "Q#",
+  // Q1, Q2, Q3, Q4
+  qq: "##",
+  // 01, 02, 03, 04
+  q: "#",
+  // 1, 2, 3, 4
+  // Month (formatting) – M tokens
+  MMMMM: "A",
+  // J, F, ..., D
+  MMMM: "W",
+  // January, February, ..., December
+  MMM: "Aaa",
+  // Jan, Feb, ..., Dec
+  MM: "##",
+  // 01, 02, ..., 12
+  M: "#n",
+  // 1, 2, ..., 12
+  // Month (stand-alone) – L tokens
+  LLLLL: "A",
+  // J, F, ..., D
+  LLLL: "W",
+  // January, February, ..., December
+  LLL: "Aaa",
+  // Jan, Feb, ..., Dec
+  LL: "##",
+  // 01, 02, ..., 12
+  L: "#n",
+  // 1, 2, ..., 12
+  // Local week of year (w tokens)
+  ww: "##",
+  // 01, 02, ..., 53
+  w: "#n",
+  // 1, 2, ..., 53
+  // Day of month (d tokens)
+  dd: "##",
+  // 01, 02, ..., 31
+  d: "#n",
+  // 1, 2, ..., 31
+  // Day of week (formatting) using E tokens
+  EEEEEE: "Aa",
+  // Mo, Tu, We, Th, Fr, Sa, Su
+  EEEEE: "A",
+  // M, T, W, T, F, S, S
+  EEEE: "W",
+  // Monday, Tuesday, ..., Sunday
+  EEE: "Aaa",
+  // Mon, Tue, Wed, ..., Sun
+  EE: "Aaa",
+  // Mon, Tue, Wed, ..., Sun
+  E: "Aaa",
+  // Mon, Tue, Wed, ..., Sun
+  // Local day of week (formatting) using e tokens
+  eeeeee: "Aa",
+  // Mo, Tu, We, Th, Fr, Sa, Su
+  eeeee: "A",
+  // M, T, W, T, F, S, S
+  eeee: "W",
+  // Monday, Tuesday, ..., Sunday
+  eee: "Aaa",
+  // Mon, Tue, Wed, ..., Sun
+  ee: "##",
+  // 02, 03, ..., 01
+  e: "#",
+  // 2, 3, 4, ..., 1
+  // Local day of week (stand-alone) using c tokens
+  cccccc: "Aa",
+  // Mo, Tu, We, Th, Fr, Sa, Su
+  ccccc: "A",
+  // M, T, W, T, F, S, S
+  cccc: "W",
+  // Monday, Tuesday, ..., Sunday
+  ccc: "Aaa",
+  // Mon, Tue, Wed, ..., Sun
+  cc: "##",
+  // 02, 03, ..., 01
+  c: "#"
+  // 2, 3, 4, ..., 1
+}, o = {
+  // AM, PM (a tokens)
+  aaaaa: "a",
+  // a, p
+  aaaa: "a.a.",
+  // a.m., p.m.
+  aaa: "AA",
+  // AM, PM
+  aa: "AA",
+  // AM, PM
+  a: "AA",
+  // AM, PM
+  // AM, PM, noon, midnight (b tokens)
+  bbbbb: "a",
+  // a, p
+  bbbb: "a.a.",
+  // a.m., p.m.
+  bbb: "AA",
+  // AM, PM
+  bb: "AA",
+  // AM, PM
+  b: "AA",
+  // AM, PM
+  // Flexible day period (B tokens)
+  B: "S",
+  // AM, PM, noon, midnight
+  // Hour [1-12] (h tokens)
+  hh: "##",
+  // 01, 02, ..., 11, 12
+  h: "#n",
+  // 1, 2, ..., 11, 12
+  // Hour [0-23] (H tokens)
+  HH: "##",
+  // 00, 01, 02, ..., 23
+  H: "#n",
+  // 0, 1, 2, ..., 23
+  // Hour [0-11] (K tokens)
+  KK: "##",
+  // 01, 02, ..., 11, 00
+  K: "#n",
+  // 1, 2, ..., 11, 0
+  // Hour [1-24] (k tokens)
+  kk: "##",
+  // 24, 01, 02, ..., 23
+  k: "#n",
+  // 24, 1, 2, ..., 23
+  // Minute (m tokens)
+  mm: "##",
+  // 00, 01, ..., 59
+  m: "#n",
+  // 0, 1, ..., 59
+  // Second (s tokens)
+  ss: "##",
+  // 00, 01, ..., 59
+  s: "#n",
+  // 0, 1, ..., 59,
+  // Timezone (ISO-8601 with Z) – X tokens
+  XXXXX: ["-##:##", "+##:##", "-##:##:##", "+##:##:##", "Z"],
+  // -08:00, +05:30, Z, +12:34:56
+  XXXX: ["-####", "+####", "-######", "+######", "Z"],
+  // -0800, +0530, Z, +123456
+  XXX: ["-##:##", "+##:##", "Z"],
+  // -08:00, +05:30, Z
+  XX: ["-####", "+####", "Z"],
+  // -0800, +0530, Z
+  X: ["-##", "+##", "-####", "+####", "Z"],
+  // -08, +0530, Z
+  // Timezone (ISO-8601 without Z) – x tokens
+  xxxxx: ["-##:##", "+##:##", "-##:##:##", "+##:##:##"],
+  // -08:00, +05:30, +00:00, +12:34:56
+  xxxx: ["-####", "+####", "-######", "+######"],
+  // -0800, +0530, +0000, +123456
+  xxx: ["-##:##", "+##:##"],
+  // -08:00, +05:30, +00:00
+  xx: ["-####", "+####"],
+  // -0800, +0530, +0000
+  x: ["-##", "+##", "-####", "+####"]
+  // -08, +0530, +00
+}, d = {
+  ...c,
+  ...o
+}, s = {
+  // Calendar year (y)
+  y: "#",
+  // 44, 1, 1900, 2017, 9999
+  // Local week-numbering year (Y)
+  Y: "#",
+  // 44, 1, 1900, 2017, 9000
+  // Extended year (u)
+  u: ["-#", "#"],
+  // -43, 1, 1900, 2017, 9999, -999
+  // Day of year (D tokens)
+  D: "#"
+  // 1, 2, ..., 365, 366
+}, i = {
+  // Fraction of second (S tokens)
+  S: "#"
+  // 0, 1, ..., 9
+}, x = {
+  ...s,
+  ...i
+};
+function b(e) {
+  const a = e.replace(/(['"]).*?\1/g, ""), r = Object.keys(x).map((n) => `${n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}{1,4}`).join("|"), E = Object.keys(d).sort((n, t) => t.length - n.length).map((n) => n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|"), M = `(${r}|${E})`, m = new RegExp(M, "g");
+  return a.match(m);
+}
+function Q(e) {
+  const a = b(e);
+  if (!a)
+    throw Error("Failed to tokenize format string.");
+  return a.some(u) && !a.some(p);
+}
+function p(e) {
+  return c[e] !== void 0 || A(e) && s[e[0]] !== void 0;
+}
+function u(e) {
+  return o[e] !== void 0 || A(e) && i[e[0]] !== void 0;
+}
+function A(e) {
+  return /^(\w)\1*$/.test(e);
+}
+export {
+  x as dynamicTokensMap,
+  Q as isTimeOnlyFormat,
+  A as isUnitRepetition,
+  d as staticTokensMap,
+  b as tokenizeFormat
+};

package/esm/utils/download.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Downloads the provided file.
+ *
+ * @param file - The File object to be downloaded.
+ */
+export declare function downloadFile(file: File): void;
+//# sourceMappingURL=download.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/utils/download.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAqB7C"}

package/esm/utils/download.js

@@ -0,0 +1,16 @@
+function r(o) {
+  const t = new FileReader();
+  t.onload = () => {
+    const a = o.type || "application/octet-stream", d = new Blob([t.result], { type: a }), e = Object.assign(document.createElement("a"), {
+      href: URL.createObjectURL(d),
+      download: o.name || "download"
+    });
+    document.body.appendChild(e), e.click(), setTimeout(() => {
+      var n;
+      URL.revokeObjectURL(e.href), (n = e.parentNode) == null || n.removeChild(e);
+    }, 100);
+  }, t.readAsArrayBuffer(o);
+}
+export {
+  r as downloadFile
+};

package/esm/utils/setupPropsProxy.d.ts

@@ -1,11 +1,24 @@
-import { SetupContext, VNode } from 'vue';
-type LooseRequired<T> = {
-    [P in keyof (T & Required<T>)]: T[P];
-};
-type Component<Props> = {
-    setup?: (this: void, props: LooseRequired<Readonly<Props>>, ctx: SetupContext<unknown>) => unknown;
-};
+import { VNode } from 'vue';
+/**
+ * Checks if a given property is defined in the `vnode` props.
+ *
+ * @param vnode The Vue component's VNode instance.
+ * @param prop The property name to check.
+ * @returns `true` if the property exists in the vnode props, `false` otherwise.
+ */
 export declare function propIsDefined(vnode: VNode, prop: string): boolean;
-export declare function setupPropsProxy<Props>(component: Component<Props>): Component<Props>;
-export {};
+/**
+ * Sets up a proxy for a Vue component's props.
+ * This proxy allows for fetching prop defaults from context.
+ *
+ * @template C The type of the component.
+ * @param component The component to wrap with the proxy.
+ * @returns The component with the `setup` function enhanced to use the proxy for props.
+ *
+ * Example usage:
+ * ```ts
+ * const QButton = setupPropsProxy(_QButton);
+ * ```
+ */
+export declare function setupPropsProxy<C>(component: C): C;
 //# sourceMappingURL=setupPropsProxy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"setupPropsProxy.d.ts","sourceRoot":"","sources":["../../src/utils/setupPropsProxy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,CAAA;AAO9C,KAAK,aAAa,CAAC,CAAC,IAAI;KACtB,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACpC,CAAA;AAED,KAAK,SAAS,CAAC,KAAK,IAAI;IACvB,KAAK,CAAC,EAAE,CACP,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EACrC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,KACtB,OAAO,CAAA;CACZ,CAAA;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAQvD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CA6BpF"}
+{"version":3,"file":"setupPropsProxy.d.ts","sourceRoot":"","sources":["../../src/utils/setupPropsProxy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,KAAK,EAAE,MAAM,KAAK,CAAA;AAO9C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAQvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAkClD"}

package/esm/utils/setupPropsProxy.js

@@ -1,30 +1,30 @@
 import { useDefaults as m } from "../composables/defaults.js";
-import { getCurrentInstance as c } from "vue";
-import { isEmpty as d } from "./isEmpty.js";
-import { toKebabCase as v } from "./string.js";
-function y(e, t) {
-  var n;
-  const r = v(t);
-  return r ? typeof ((n = e.props) == null ? void 0 : n[r]) < "u" : !1;
+import { getCurrentInstance as d } from "vue";
+import { isEmpty as v } from "./isEmpty.js";
+import { toKebabCase as y } from "./string.js";
+function g(r, n) {
+  var t;
+  const e = y(n);
+  return e ? typeof ((t = r.props) == null ? void 0 : t[e]) < "u" : !1;
 }
-function C(e) {
-  const t = e.setup;
-  return t && (e.setup = (r, n) => {
-    const o = m();
-    if (d(o.value)) return t(r, n);
-    const s = c();
-    if (s === null) return t(r, n);
-    const a = new Proxy(r, {
+function I(r) {
+  const n = r, e = n.setup;
+  return e && (n.setup = (t, o) => {
+    const s = m();
+    if (v(s.value)) return e(t, o);
+    const f = d();
+    if (f === null) return e(t, o);
+    const a = new Proxy(t, {
       get(l, u) {
-        var i;
-        const f = Reflect.get(l, u), p = (i = o.value) == null ? void 0 : i[u];
-        return typeof u == "string" && !y(s.vnode, u) ? p ?? f : f;
+        var p;
+        const i = Reflect.get(l, u), c = (p = s.value) == null ? void 0 : p[u];
+        return typeof u == "string" && !g(f.vnode, u) ? c ?? i : i;
       }
     });
-    return t(a, n);
-  }), e;
+    return e(a, o);
+  }), r;
 }
 export {
-  y as propIsDefined,
-  C as setupPropsProxy
+  g as propIsDefined,
+  I as setupPropsProxy
 };

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

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/utils/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,UAMtC"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/utils/string.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,UAEtC"}

package/esm/utils/string.js

@@ -1,6 +1,9 @@
 function a(e) {
-  return e.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/([0-9])([A-Za-z])/g, "$1-$2").replace(/([A-Za-z])([0-9])/g, "$1-$2").toLowerCase();
+  return e.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/([0-9])([a-zA-Z])/g, "$1 $2").replace(/([a-zA-Z])([0-9])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").trim().split(/\s+/);
+}
+function r(e) {
+  return a(e).join("-").toLowerCase();
 }
 export {
-  a as toKebabCase
+  r as toKebabCase
 };

package/esm/utils/theme.d.ts

@@ -1,4 +1,6 @@
-import { ThemeDefinition } from '../framework';
+import { ThemeDefinition, ThemeInstance } from '../composables/theme';
+import { DeepReadonly, Ref } from 'vue';
+export declare const THEME_NODE_ID = "q-theme";
 /**
  * Gets or creates a style node for applying dynamic themes.
  *
@@ -18,4 +20,14 @@ export declare function generateRootStyle(themes: ThemeDefinition[]): void;
  * @returns The corresponding CSS variable name.
  */
 export declare function toProperty(color: string): string;
+/**
+ * Creates a theme instance that allows reactive access to a specific theme.
+ *
+ * @param name - The name of the theme to use.
+ * @param themes - A readonly array of available theme definitions.
+ * @returns A ThemeInstance object containing the current theme and metadata.
+ *
+ * @throws Will throw an error if the specified theme name is not found.
+ */
+export declare function createThemeInstance(name: Ref<string>, themes: DeepReadonly<ThemeDefinition[]>): ThemeInstance;
 //# sourceMappingURL=theme.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAY/C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,QA2B1D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,UAOvC"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAQ5C,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAY/C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,QA2B1D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,UAOvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,MAAM,EAAE,YAAY,CAAC,eAAe,EAAE,CAAC,GACrC,aAAa,CAgBf"}

package/esm/utils/theme.js

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