@develate/quasar-ext-utils 0.0.2

package/README.md

@@ -0,0 +1,33 @@
+# `@develate/quasar-ext-utils`
+
+A Quasar App Extension with shared Quasar/Vue utilities and development helpers.
+
+## Install
+
+```bash
+quasar ext add @develate/quasar-ext-utils
+```
+
+## Uninstall
+
+```bash
+quasar ext remove @develate/quasar-ext-utils
+```
+
+## Local network development
+
+Pass `--ni` to a development run to bind Quasar to the current local IPv4
+address. The extra `--` is required because Quasar does not accept extension
+specific top-level options:
+
+```bash
+quasar dev -- --ni
+```
+
+The extension prefers private LAN addresses (`10.x.x.x`, `192.168.x.x`, or
+`172.16.x.x` through `172.31.x.x`) and falls back to another non-internal IPv4
+address or `localhost`.
+
+## Donate
+
+If you appreciate the work that went into this App Extension, please consider [donating to Quasar](https://donate.quasar.dev).

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@develate/quasar-ext-utils",
+  "version": "0.0.2",
+  "description": "A Quasar App Extension",
+  "keywords": [
+    "quasar",
+    "quasar-app-extension",
+    "quasar-app-vite",
+    "quasar-cli",
+    "vue",
+    "vuejs"
+  ],
+  "license": "MIT",
+  "author": "Thorsten <tk@programmierung.deutschehandarbeit.de>",
+  "type": "module",
+  "main": "src/index.ts",
+  "imports": {
+    "#q-app": "@quasar/app-vite"
+  },
+  "devDependencies": {
+    "@quasar/app-vite": "^3.7.0",
+    "quasar": "^2.25.1",
+    "vue": "^3.5.39"
+  },
+  "peerDependencies": {
+    "@quasar/app-vite": "^3.5.0"
+  },
+  "engines": {
+    "node": ">= 26 || ^24 || ^22.12"
+  }
+}

package/src/index.ts

@@ -0,0 +1,46 @@
+/**
+ * Quasar App Extension index/runner script
+ * (runs on each dev/build)
+ *
+ * Docs: https://quasar.dev/app-extensions/development-guide/index-api
+ */
+
+import os from "node:os";
+import { defineIndexScript } from "#q-app";
+
+function getLocalIp() {
+  const addresses = Object.values(os.networkInterfaces())
+    .flatMap(networkInterface => networkInterface ?? [])
+    .filter(addr => addr.family === "IPv4" && !addr.internal);
+
+  // Prefer actual LAN/private addresses over VPNs such as Tailscale.
+  const lan = addresses.find(
+    ({ address }) =>
+      address.startsWith("10.") ||
+      address.startsWith("192.168.") ||
+      /^172\.(1[6-9]|2\d|3[01])\./.test(address)
+  );
+
+  return lan?.address ?? addresses[0]?.address ?? "localhost";
+}
+
+// can be async
+export default defineIndexScript(api => {
+  api.extendQuasarConf(() => ({
+    boot: [
+      "~@develate/quasar-app-extension-quasar-ext-utils/src/runtime/boot.register.ts"
+    ]
+  }));
+
+  api.extendQuasarConf((_, extensionApi) => {
+    if (!extensionApi.ctx.dev || !process.argv.includes("--ni")) {
+      return;
+    }
+
+    return {
+      devServer: {
+        host: getLocalIp()
+      }
+    };
+  });
+});

package/src/install.ts

@@ -0,0 +1,18 @@
+/**
+ * Quasar App Extension install script
+ * https://quasar.dev/app-extensions/development-guide/install-api
+ */
+
+import { defineInstallScript } from "#q-app";
+
+// can be async
+export default defineInstallScript(api => {
+  api.extendPackageJson({
+    scripts: {
+      pull: "git pull --rebase --autostash && npm run setup",
+      setup: "npm install && npm install --prefix src-capacitor",
+      "build-ios": "quasar build -m capacitor -T ios --ide",
+      "dev-ios": "quasar dev -m capacitor -T ios"
+    }
+  });
+});

package/src/runtime/MyComponent.vue

@@ -0,0 +1,16 @@
+<template>
+  <div class="my-component">
+    <div>My Component</div>
+    <div>This is a simple Vue component.</div>
+  </div>
+</template>
+
+<script setup lang="ts">
+//
+</script>
+
+<style lang="sass">
+.my-component
+  > div:first-child
+    font-weight: bold
+</style>

package/src/runtime/boot.register.ts

@@ -0,0 +1,6 @@
+import { defineBoot } from "#q-app";
+import MyComponent from "./MyComponent.vue";
+
+export default defineBoot(async ({ app }) => {
+  app.component("my-component", MyComponent);
+});

package/src/runtime/env.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="@quasar/app-vite/client" />
+
+/**
+ * Uncomment and add types for your custom environment
+ * variables to avoid TypeScript errors
+ * when using them via import.meta.env.VARIABLE_NAME
+ *
+ * Example:
+ *
+ * interface ImportMetaEnv {
+ *   readonly MY_VAR: string
+ *   readonly MY_OTHER_VAR: boolean
+ * }
+ */
+// interface ImportMetaEnv {}

package/src/runtime/shims-vue.d.ts

@@ -0,0 +1,5 @@
+declare module "*.vue" {
+  import { DefineComponent } from "vue";
+  const component: DefineComponent;
+  export default component;
+}

package/src/uninstall.ts

@@ -0,0 +1,9 @@
+/**
+ * Quasar App Extension uninstall script
+ * https://quasar.dev/app-extensions/development-guide/uninstall-api
+ */
+
+import { defineUninstallScript } from "#q-app";
+
+// can be async
+export default defineUninstallScript((/* api */) => {});

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "target": "esnext",
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "moduleDetection": "force",
+    "moduleResolution": "bundler",
+    "isolatedModules": true,
+    "module": "preserve",
+    "noEmit": true,
+    "lib": ["esnext", "dom", "dom.iterable"],
+    "strict": true,
+    "allowUnreachableCode": false,
+    "allowUnusedLabels": false,
+    "noImplicitOverride": true,
+    "exactOptionalPropertyTypes": true,
+    "noUncheckedIndexedAccess": true
+  },
+  "include": ["./src/**/*"],
+  "exclude": ["./node_modules"]
+}