nuxt-typed-router 1.0.2 → 1.0.3

package/README.md

@@ -84,9 +84,13 @@ The module will create 2 files:
 
 # Usage in Vue/Nuxt
 
+## Check out this demo and clone it! [nuxt-typed-router-demo](https://github.com/victorgarciaesgi/nuxt-typed-router-demo)
+
+<br/>
+
 ### **_Requirements_**
 
-You have to specify the output dir of the generated files in your configuration
+You can specify the output dir of the generated files in your configuration. It defaults to `<srcDir>/generated`
 
 ```ts
 import TypedRouter from 'nuxt-typed-router';
@@ -146,6 +150,8 @@ export type TypedRouteList =
   | 'index-user';
 ```
 
+> nuxt-typed-router will also create a plugin in your `<srcDir>/plugins` folder with the injected `$typedRouter` and `$routesList` helpers
+
 # Usage with `useTypedRouter` hook
 
 `useTypedRouter` is an exported composable from nuxt-typed-router. It contains a clone of `vue-router` but with stritly typed route names and params type-check
@@ -171,7 +177,7 @@ export default defineComponent({
 </script>
 ```
 
-# Usage with `$typedRouter` injected method
+# Usage with `$typedRouter` and `$routesList` injected helpers
 
 `$typedRouter` is an injected clone of vue-router `$router`, but fully typed with all your routes.
 It's available anywhere you have access to Nuxt context
@@ -183,10 +189,10 @@ import { defineComponent } from 'vue';
 export default defineComponent({
   name: 'Index',
   setup() {
-    const { $typedRouter } = useNuxtApp();
+    const { $typedRouter, $routesList } = useNuxtApp();
 
     function navigate() {
-      $typedRouter.push({ name: 'activate' });
+      $typedRouter.push({ name: $routesList.activate });
     }
 
     return {
@@ -197,6 +203,25 @@ export default defineComponent({
 </script>
 ```
 
+# Usage outside Vue component
+
+You can import the `useTypedRouter` composable from where it's generated.
+Exemple with `pinia` store here
+
+```ts
+import pinia from 'pinia';
+import { useTypedRouter } from 'nuxt-typed-router/hook';
+
+export const useFooStore = defineStore('foo', {
+  actions: {
+    bar() {
+      const { router, routes } = useTypedRouter();
+      router.push({ name: routes.index.user, params: { user: 2 } });
+    },
+  },
+});
+```
+
 ## Development
 
 1. Clone this repository

package/dist/module.json

@@ -5,5 +5,5 @@
     "nuxt": "^3.0.0",
     "bridge": false
   },
-  "version": "1.0.2"
+  "version": "1.0.3"
 }

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { extendPages, addPluginTemplate, defineNuxtModule } from '@nuxt/kit';
+import { extendPages, defineNuxtModule } from '@nuxt/kit';
 import { fileURLToPath } from 'url';
 import chalk from 'chalk';
 import logSymbols from 'log-symbols';
@@ -307,7 +307,7 @@ function createRuntimePluginFile(routesDeclTemplate) {
 
     return {
       provide: {
-        typedRouter: nuxtApp.vueApp.$router,
+        typedRouter: nuxtApp.$router,
         routesList,
       },
     };
@@ -317,14 +317,7 @@ function createRuntimePluginFile(routesDeclTemplate) {
 function createRuntimeHookFile(routesDeclTemplate) {
   return `
   import { getCurrentInstance } from 'vue';
-
-  function useNuxtApp() {
-    const vm = getCurrentInstance();
-    if (!vm) {
-      throw new Error('nuxt instance unavailable');
-    }
-    return vm.appContext.app.$nuxt;
-  }
+  import { useNuxtApp } from '#app';
 
   export const useTypedRouter = () => {
     const { $router } = useNuxtApp();
@@ -337,6 +330,8 @@ function createRuntimeHookFile(routesDeclTemplate) {
     };
   };
 
+  export default {};
+
   `;
 }
 function createRuntimeRoutesFile({
@@ -380,27 +375,25 @@ function createTypedRouteParamsExport(routesParams) {
 }
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-function routeHook(outDir, routesObjectName) {
+function routeHook(outDir, routesObjectName, srcDir, nuxt) {
   try {
     extendPages(async (routes) => {
-      const { routesDeclTemplate, routesList, routesObjectTemplate, routesParams } = constructRouteMap(routes);
-      const pluginName = "typed-router.mjs";
-      const runtimeDir = resolve(__dirname, process.env.NUXT_BUILD_TYPE === "stub" ? "../../dist/runtime" : "./runtime");
-      const pluginPath = resolve(runtimeDir, pluginName);
-      await Promise.all([
-        saveRouteFiles(runtimeDir, "useTypedRouter.mjs", createRuntimeHookFile(routesDeclTemplate)),
-        saveRouteFiles(runtimeDir, pluginName, createRuntimePluginFile(routesDeclTemplate))
-      ]);
-      addPluginTemplate({
-        src: pluginPath,
-        filename: pluginName,
-        options: {
-          routesList: "test"
-        }
-      });
-      await saveRouteFiles(outDir, `__routes.ts`, createRuntimeRoutesFile({ routesList, routesObjectTemplate, routesObjectName }));
-      await saveRouteFiles(outDir, `typed-router.d.ts`, createDeclarationRoutesFile({ routesDeclTemplate, routesList, routesParams }));
-      console.log(logSymbols.success, `[typed-router] Routes definitions generated`);
+      if (routes.length) {
+        const { routesDeclTemplate, routesList, routesObjectTemplate, routesParams } = constructRouteMap(routes);
+        const pluginName = "__typed-router.ts";
+        const runtimeDir = resolve(__dirname, process.env.NUXT_BUILD_TYPE === "stub" ? "../../dist/runtime" : "./runtime");
+        const pluginPath = resolve(runtimeDir, pluginName);
+        nuxt.hook("build:done", async () => {
+          const pluginFolder = `${srcDir}/plugins`;
+          await saveRouteFiles(pluginFolder, pluginName, createRuntimePluginFile(routesDeclTemplate));
+        });
+        await saveRouteFiles(runtimeDir, "useTypedRouter.mjs", createRuntimeHookFile(routesDeclTemplate));
+        await saveRouteFiles(outDir, `__routes.ts`, createRuntimeRoutesFile({ routesList, routesObjectTemplate, routesObjectName }));
+        await saveRouteFiles(outDir, `typed-router.d.ts`, createDeclarationRoutesFile({ routesDeclTemplate, routesList, routesParams }));
+        console.log(logSymbols.success, `[typed-router] Routes definitions generated`);
+      } else {
+        console.log(logSymbols.warning, chalk.yellow(`[typed-router] No routes defined. Check if your ${chalk.underline(chalk.bold("pages"))} folder exists and remove ${chalk.underline(chalk.bold("app.vue"))}`));
+      }
     });
   } catch (e) {
     console.error(chalk.red("Error while generating routes definitions model"), "\n" + e);
@@ -418,10 +411,10 @@ const module = defineNuxtModule({
     stripAtFromName: false
   },
   setup(moduleOptions, nuxt) {
-    const { outDir = `${nuxt.options.srcDir}/generated`, routesObjectName } = moduleOptions;
-    nuxt.hook("pages:extend", () => routeHook(outDir, routesObjectName));
-    nuxt.hook("build:extendRoutes", () => routeHook(outDir, routesObjectName));
-    routeHook(outDir, routesObjectName);
+    const srcDir = nuxt.options.srcDir;
+    const { outDir = `${srcDir}/generated`, routesObjectName } = moduleOptions;
+    nuxt.hook("pages:extend", () => routeHook(outDir, routesObjectName, srcDir, nuxt));
+    routeHook(outDir, routesObjectName, srcDir, nuxt);
   }
 });
 

package/dist/runtime/typed-router.d.ts

@@ -1,33 +1,11 @@
 import { defineNuxtPlugin } from '#app';
 
 export default defineNuxtPlugin((nuxtApp) => {
-  const routesList = {
-    activate: 'activate',
-    index: 'index',
-    childOne: {
-      childOneChildOneSubOne: 'parent-child-one-child-one-sub-one',
-      user: { index: 'parent-child-one-child-one-sub-one-user' },
-      childOneChildOneSubTwo: 'parent-child-one-child-one-sub-two',
-      index: 'parent-child-one',
-    },
-    childTwo: {
-      childTwoId: 'parent-child-two-id',
-      childTwoChildOneSubOne: 'parent-child-two-child-one-sub-one',
-      index: 'parent-child-two',
-      profile: {
-        id: {
-          slug: { index: 'parent-child-two-profile-id-slug' },
-          index: 'parent-child-two-profile-id',
-        },
-        index: 'parent-child-two-profile',
-      },
-    },
-    rootPage: 'rootPage',
-  };
+  const routesList = {};
 
   return {
     provide: {
-      typedRouter: nuxtApp.vueApp.$router,
+      typedRouter: nuxtApp.$router,
       routesList,
     },
   };

package/dist/runtime/typed-router.mjs

@@ -1,33 +1,11 @@
 import { defineNuxtPlugin } from '#app';
 
 export default defineNuxtPlugin((nuxtApp) => {
-  const routesList = {
-    activate: 'activate',
-    index: 'index',
-    childOne: {
-      childOneChildOneSubOne: 'parent-child-one-child-one-sub-one',
-      user: { index: 'parent-child-one-child-one-sub-one-user' },
-      childOneChildOneSubTwo: 'parent-child-one-child-one-sub-two',
-      index: 'parent-child-one',
-    },
-    childTwo: {
-      childTwoId: 'parent-child-two-id',
-      childTwoChildOneSubOne: 'parent-child-two-child-one-sub-one',
-      index: 'parent-child-two',
-      profile: {
-        id: {
-          slug: { index: 'parent-child-two-profile-id-slug' },
-          index: 'parent-child-two-profile-id',
-        },
-        index: 'parent-child-two-profile',
-      },
-    },
-    rootPage: 'rootPage',
-  };
+  const routesList = {};
 
   return {
     provide: {
-      typedRouter: nuxtApp.vueApp.$router,
+      typedRouter: nuxtApp.$router,
       routesList,
     },
   };

package/dist/runtime/useTypedRouter.d.ts

@@ -1,42 +1,15 @@
 import { getCurrentInstance } from 'vue';
-
-function useNuxtApp() {
-  const vm = getCurrentInstance();
-  if (!vm) {
-    throw new Error('nuxt instance unavailable');
-  }
-  return vm.appContext.app.$nuxt;
-}
+import { useNuxtApp } from '#app';
 
 export const useTypedRouter = () => {
   const { $router } = useNuxtApp();
 
-  const routesList = {
-    activate: 'activate',
-    index: 'index',
-    childOne: {
-      childOneChildOneSubOne: 'parent-child-one-child-one-sub-one',
-      user: { index: 'parent-child-one-child-one-sub-one-user' },
-      childOneChildOneSubTwo: 'parent-child-one-child-one-sub-two',
-      index: 'parent-child-one',
-    },
-    childTwo: {
-      childTwoId: 'parent-child-two-id',
-      childTwoChildOneSubOne: 'parent-child-two-child-one-sub-one',
-      index: 'parent-child-two',
-      profile: {
-        id: {
-          slug: { index: 'parent-child-two-profile-id-slug' },
-          index: 'parent-child-two-profile-id',
-        },
-        index: 'parent-child-two-profile',
-      },
-    },
-    rootPage: 'rootPage',
-  };
+  const routesList = {};
 
   return {
     router: $router,
     routes: routesList,
   };
 };
+
+export default {};

package/dist/runtime/useTypedRouter.mjs

@@ -1,42 +1,15 @@
 import { getCurrentInstance } from 'vue';
-
-function useNuxtApp() {
-  const vm = getCurrentInstance();
-  if (!vm) {
-    throw new Error('nuxt instance unavailable');
-  }
-  return vm.appContext.app.$nuxt;
-}
+import { useNuxtApp } from '#app';
 
 export const useTypedRouter = () => {
   const { $router } = useNuxtApp();
 
-  const routesList = {
-    activate: 'activate',
-    index: 'index',
-    childOne: {
-      childOneChildOneSubOne: 'parent-child-one-child-one-sub-one',
-      user: { index: 'parent-child-one-child-one-sub-one-user' },
-      childOneChildOneSubTwo: 'parent-child-one-child-one-sub-two',
-      index: 'parent-child-one',
-    },
-    childTwo: {
-      childTwoId: 'parent-child-two-id',
-      childTwoChildOneSubOne: 'parent-child-two-child-one-sub-one',
-      index: 'parent-child-two',
-      profile: {
-        id: {
-          slug: { index: 'parent-child-two-profile-id-slug' },
-          index: 'parent-child-two-profile-id',
-        },
-        index: 'parent-child-two-profile',
-      },
-    },
-    rootPage: 'rootPage',
-  };
+  const routesList = {};
 
   return {
     router: $router,
     routes: routesList,
   };
 };
+
+export default {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-typed-router",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Provide autocompletion for pages route names generated by Nuxt router",
   "type": "module",
   "scripts": {