@thinkpixellab-public/px-vue 4.1.8 → 4.1.9

package/composables/useProvide.js

@@ -0,0 +1,29 @@
+import { computed, provide } from 'vue';
+
+/**
+ * Provides a reactive value that can be injected by child components.
+ *
+ * @param {symbol | string} key - a unique key used for provide/inject.
+ * @param {any | import('vue').Ref<any> | (() => any)} valueOrFn
+ *   - a **static value** (string, number, object, etc.).
+ *   - a **vue `ref()`** (reactive state that can change).
+ *   - a **function** (computed dynamically based on external state).
+ *
+ * @returns {void}
+ *   - provides `{ value }` if `valueOrFn` is static or computed.
+ *   - provides `{ value, setValue }` if `valueOrFn` is a `ref()`.
+ */
+export function useProvide(key, valueOrFn) {
+    // create a computed value that updates when valueOrFn is a function or ref
+    const computedValue = computed(() => {
+        if (typeof valueOrFn === 'function') {
+            return valueOrFn();
+        } else if (valueOrFn.value !== undefined) {
+            return valueOrFn.value;
+        } else {
+            return valueOrFn;
+        }
+    });
+
+    provide(key, computedValue);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thinkpixellab-public/px-vue",
-    "version": "4.1.8",
+    "version": "4.1.9",
     "description": "General purpose Vue components and helpers that can be used across projects.",
     "author": {
         "name": "Pixel Lab"

package/utils/utilsSsr.js

@@ -34,3 +34,8 @@ export function getQueryParam(name, fallback = null) {
 
     return params[name] || fallback;
 }
+
+export function getQueryBool(name) {
+    let val = getQueryParam(name, 'false').toLowerCase();
+    return !(val === '0' || val === 'false' || val === 'null' || val === 'undefined');
+}