@quvel-kit/core 1.1.0

package/dist/utils/platform.js

@@ -0,0 +1,64 @@
+/**
+ * Platform Detection Utilities
+ *
+ * Detects platform tags from Quasar Platform and Screen APIs
+ * and formats them for the X-Platform header.
+ */
+import { Platform, Screen } from 'quasar';
+/**
+ * Detect all platform tags and return as comma-separated string
+ *
+ * @returns Comma-separated platform tags (e.g., "capacitor,ios,mobile,screen:sm")
+ *
+ * @example
+ * ```typescript
+ * // iPhone in Capacitor
+ * detectPlatformTags() // "capacitor,ios,mobile,screen:sm"
+ *
+ * // iPad in Safari
+ * detectPlatformTags() // "web,ios,tablet,screen:lg"
+ *
+ * // Electron on macOS
+ * detectPlatformTags() // "electron,macos,desktop,screen:xl"
+ * ```
+ */
+export function detectPlatformTags() {
+    const tags = [];
+    // SSR safety check - Platform.is is not available on server
+    if (!Platform.is) {
+        return 'ssr';
+    }
+    // Runtime/Container
+    if (Platform.is.capacitor)
+        tags.push('capacitor');
+    else if (Platform.is.cordova)
+        tags.push('cordova');
+    else if (Platform.is.electron)
+        tags.push('electron');
+    else
+        tags.push('web');
+    // Operating System
+    if (Platform.is.ios)
+        tags.push('ios');
+    else if (Platform.is.android)
+        tags.push('android');
+    else if (Platform.is.mac)
+        tags.push('macos');
+    else if (Platform.is.win)
+        tags.push('windows');
+    else if (Platform.is.linux)
+        tags.push('linux');
+    // Form Factor
+    if (Platform.is.mobile)
+        tags.push('mobile');
+    else if (Platform.is.desktop)
+        tags.push('desktop');
+    if (Platform.is.ipad)
+        tags.push('tablet');
+    // Screen Size (Quasar breakpoints)
+    const screenName = Screen.name; // 'xs' | 'sm' | 'md' | 'lg' | 'xl'
+    if (screenName) {
+        tags.push(`screen:${screenName}`);
+    }
+    return tags.join(',');
+}

package/dist/utils/scripts.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Script Loading Utilities
+ *
+ * Helper functions for dynamically loading and managing external scripts
+ */
+/**
+ * Dynamically loads an external script into the document
+ *
+ * @param scriptId - Unique ID for the script element
+ * @param src - URL of the script to load
+ * @param onLoad - Optional callback triggered after the script loads
+ */
+export declare function loadScript(scriptId: string, src: string, onLoad?: () => unknown): void;
+/**
+ * Removes a script from the DOM by its ID
+ *
+ * @param scriptId - Unique ID of the script element to remove
+ */
+export declare function unloadScript(scriptId: string): void;
+//# sourceMappingURL=scripts.d.ts.map

package/dist/utils/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/utils/scripts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAiBtF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMnD"}

package/dist/utils/scripts.js

@@ -0,0 +1,39 @@
+/**
+ * Script Loading Utilities
+ *
+ * Helper functions for dynamically loading and managing external scripts
+ */
+/**
+ * Dynamically loads an external script into the document
+ *
+ * @param scriptId - Unique ID for the script element
+ * @param src - URL of the script to load
+ * @param onLoad - Optional callback triggered after the script loads
+ */
+export function loadScript(scriptId, src, onLoad) {
+    if (!document.getElementById(scriptId)) {
+        const script = document.createElement('script');
+        script.id = scriptId;
+        script.src = src;
+        script.async = true;
+        script.defer = true;
+        if (onLoad) {
+            script.onload = onLoad;
+        }
+        document.head.appendChild(script);
+    }
+    else if (onLoad) {
+        onLoad();
+    }
+}
+/**
+ * Removes a script from the DOM by its ID
+ *
+ * @param scriptId - Unique ID of the script element to remove
+ */
+export function unloadScript(scriptId) {
+    const script = document.getElementById(scriptId);
+    if (script) {
+        script.remove();
+    }
+}

package/global.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Quvel UI Global Type Augmentations
+ *
+ * Central entry point for all Quvel UI package type augmentations.
+ *
+ * Usage:
+ * Add to your tsconfig.json:
+ * ```json
+ * {
+ *   "compilerOptions": {
+ *     "types": ["@quvel-kit/core/global"]
+ *   }
+ * }
+ * ```
+ */
+
+// Core type augmentations
+/// <reference path="./dist/types/global.d.ts" />
+/// <reference path="./dist/types/vue-shim.d.ts" />
+/// <reference path="./dist/types/ssr.d.ts" />
+/// <reference path="./dist/types/pinia.d.ts" />
+/// <reference path="./dist/container/types/vue.d.ts" />
+
+// Tenancy package augmentations (optional - loads if installed)
+/// <reference types="@quvel-kit/tenancy/augment-core" />
+
+// Future package augmentations can be added here:
+// /// <reference types="@quvel-kit/auth/augment-core" />
+// /// <reference types="@quvel-kit/routing/augment-router" />

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@quvel-kit/core",
+  "version": "1.1.0",
+  "description": "Core utilities for Quvel UI",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./auth": {
+      "import": "./dist/auth/index.js",
+      "types": "./dist/auth/index.d.ts"
+    },
+    "./build": {
+      "import": "./dist/build/index.js",
+      "types": "./dist/build/index.d.ts"
+    },
+    "./config": {
+      "import": "./dist/config/index.js",
+      "types": "./dist/config/index.d.ts"
+    },
+    "./config/moduleTransformer": {
+      "import": "./dist/config/moduleTransformer.js",
+      "types": "./dist/config/moduleTransformer.d.ts"
+    },
+    "./modules": {
+      "import": "./dist/modules/index.js",
+      "types": "./dist/modules/index.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/utils/index.js",
+      "types": "./dist/utils/index.d.ts"
+    },
+    "./composables": {
+      "import": "./dist/composables/index.js",
+      "types": "./dist/composables/index.d.ts"
+    },
+    "./components": {
+      "import": "./dist/components/index.js",
+      "types": "./dist/components/index.d.ts"
+    },
+    "./pages": {
+      "import": "./dist/pages/index.js",
+      "types": "./dist/pages/index.d.ts"
+    },
+    "./global": {
+      "types": "./global.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "global.d.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && npm run copy-vue && npm run copy-ambient-types",
+    "copy-vue": "rsync -a --include='*/' --include='*.vue' --exclude='*' src/ dist/",
+    "copy-ambient-types": "rsync -a --include='*/' --include='vue.d.ts' --include='global.d.ts' --include='ssr.d.ts' --include='vue-shim.d.ts' --include='pinia.d.ts' --exclude='*' src/ dist/",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "quasar",
+    "config",
+    "module-system",
+    "configuration"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "@quasar/app-vite": "^2.0.0",
+    "axios": "^1.0.0",
+    "laravel-echo": "^1.16.0",
+    "pusher-js": "^8.0.0",
+    "quasar": "^2.0.0",
+    "vue": "^3.0.0",
+    "vue-i18n": "^10.0.0",
+    "vue-router": "^4.0.0",
+    "zod": "^3.25.0"
+  },
+  "peerDependenciesMeta": {
+    "@quasar/app-vite": {
+      "optional": false
+    },
+    "laravel-echo": {
+      "optional": true
+    },
+    "pusher-js": {
+      "optional": true
+    },
+    "quasar": {
+      "optional": false
+    },
+    "vue": {
+      "optional": false
+    },
+    "vue-i18n": {
+      "optional": false
+    },
+    "vue-router": {
+      "optional": false
+    },
+    "zod": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "dotenv": "^17.2.3"
+  }
+}