@nuxt/module-builder 0.1.3 → 0.1.7

package/README.md

@@ -14,9 +14,17 @@
 - Auto generated types and shims for `@nuxt/schema`
 
 
+## Quick start
+
+You can quickly get started with pre-configured [module starter](https://github.com/nuxt/starter/tree/module):
+
+```bash
+$ npx nuxi init -t "nuxt/starter#module" my-module
+```
+
 ## Project structure
 
-Using module builder, requires a special project setup. You can check a full example [here](./example).
+Using module builder, requires a special project setup. You can check an example [here](./example).
 
 ### `src/module.ts`
 
@@ -24,6 +32,8 @@ This is the entrypoint for module definition.
 
 A default export using `defineNuxtModule` and `ModuleOptions` type export is expected.
 
+You could also optionally export `ModuleHooks` to annotate any custom hooks module uses.
+
 ```js [src/module.ts]
 import { defineNuxtModule } from '@nuxt/kit'
 
@@ -31,6 +41,10 @@ export interface ModuleOptions {
   apiKey: string
 }
 
+export interface ModuleHooks {
+  'my-module:init': any
+}
+
 export default defineNuxtModule<ModuleOptions>({
   meta: {
     name: 'my-module',

package/dist/chunks/build.mjs

@@ -2,11 +2,13 @@ import { promises, existsSync } from 'fs';
 import { pathToFileURL } from 'url';
 import { resolve } from 'pathe';
 import consola from 'consola';
+import { findExports } from 'mlly';
 
-async function buildModule(rootDir) {
+async function buildModule(opts) {
   const { build } = await import('unbuild');
-  await build(rootDir, false, {
+  await build(opts.rootDir, false, {
     declaration: true,
+    stub: opts.stub,
     entries: [
       "src/module",
       { input: "src/runtime/", outDir: "dist/runtime", ext: "mjs" }
@@ -19,7 +21,11 @@ async function buildModule(rootDir) {
       "@nuxt/schema",
       "@nuxt/schema-edge",
       "@nuxt/kit",
-      "@nuxt/kit-edge"
+      "@nuxt/kit-edge",
+      "nuxt",
+      "nuxt-edge",
+      "nuxt3",
+      "vue"
     ],
     hooks: {
       async "rollup:done"(ctx) {
@@ -54,18 +60,32 @@ async function writeTypes(distDir, meta) {
   if (existsSync(dtsFile)) {
     return;
   }
+  const moduleTypesFile = resolve(distDir, "module.d.ts");
+  const moduleTypes = await promises.readFile(moduleTypesFile, "utf8").catch(() => "");
+  const typeExports = findExports(moduleTypes);
+  const isStub = moduleTypes.includes("export *");
+  const hasModuleOptions = isStub || typeExports.find((exp) => exp.names.includes("ModuleOptions"));
+  const hasModuleHooks = isStub || typeExports.find((exp) => exp.names.includes("ModuleHooks"));
   const schemaShims = [];
-  if (meta.configKey) {
-    schemaShims.push(`  interface NuxtConfig { ['${meta.configKey}']?: Partial<ModuleOptions> }`, `  interface NuxtOptions { ['${meta.configKey}']?: ModuleOptions }`);
+  const moduleImports = [];
+  if (meta.configKey && hasModuleOptions) {
+    moduleImports.push("ModuleOptions");
+    schemaShims.push(`  interface NuxtConfig { ['${meta.configKey}']?: Partial<ModuleOptions> }`);
+    schemaShims.push(`  interface NuxtOptions { ['${meta.configKey}']?: ModuleOptions }`);
+  }
+  if (hasModuleHooks) {
+    moduleImports.push("ModuleHooks");
+    schemaShims.push("  interface NuxtHooks extends ModuleHooks {}");
   }
   const dtsContents = `
-import type { ModuleOptions } from './module'
+import { ${moduleImports.join(", ")} } from './module'
 
 ${schemaShims.length ? `declare module '@nuxt/schema' {
 ${schemaShims.join("\n")}
 }
 ` : ""}
-export * from './module'
+
+export { default } from './module'
 `;
   await promises.writeFile(dtsFile, dtsContents, "utf8");
 }
@@ -77,7 +97,7 @@ async function writeCJSStub(distDir) {
   const cjsStub = `module.exports = function(...args) {
   return import('./module.mjs').then(m => m.default.call(this, ...args))
 }
-const _meta = module.exports.meta = require('./meta.json')
+const _meta = module.exports.meta = require('./module.json')
 module.exports.getMeta = () => Promise.resolve(_meta)
 `;
   await promises.writeFile(cjsStubFile, cjsStub, "utf8");

package/dist/cli.mjs

@@ -5,11 +5,15 @@ import { b as buildModule } from './chunks/build.mjs';
 import 'fs';
 import 'url';
 import 'consola';
+import 'mlly';
 
 async function main() {
   const args = mri(process.argv.slice(2));
   const rootDir = resolve(args._[0] || ".");
-  await buildModule(rootDir);
+  await buildModule({
+    rootDir,
+    stub: args.stub
+  });
 }
 main().catch((err) => {
   console.error(err);

package/dist/index.d.ts

@@ -1,3 +1,7 @@
-declare function buildModule(rootDir: string): Promise<void>;
+interface BuildModuleOptions {
+    rootDir: string;
+    stub?: boolean;
+}
+declare function buildModule(opts: BuildModuleOptions): Promise<void>;
 
-export { buildModule };
+export { BuildModuleOptions, buildModule };

package/dist/index.mjs

@@ -3,3 +3,4 @@ import 'fs';
 import 'url';
 import 'pathe';
 import 'consola';
+import 'mlly';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/module-builder",
-  "version": "0.1.3",
+  "version": "0.1.7",
   "description": "Complete solution to build Nuxt Modules",
   "license": "MIT",
   "type": "module",
@@ -28,6 +28,7 @@
   },
   "dependencies": {
     "consola": "^2.15.3",
+    "mlly": "^0.3.19",
     "mri": "^1.2.0",
     "pathe": "^0.2.0",
     "unbuild": "^0.6.7"
@@ -38,7 +39,7 @@
     "@nuxtjs/eslint-config-typescript": "latest",
     "@types/mri": "latest",
     "eslint": "latest",
-    "jiti": "latest",
+    "jiti": "^1.12.9",
     "standard-version": "latest"
   }
 }