chore: aiming to wrap this

docs/content/1.getting-started/2.options.md

@@ -109,7 +109,7 @@ This is only relevant when [`exposeConfig`](/getting-started/options#exposeconfi
 
 ::alert{type="warning"}
 
-It is unlikely for `exposeLevel` to ever be over 4 - the usual depth of a Tailwind config. A higher value is also likely to increase boot-time and disk space in dev.
+It is unlikely for `exposeLevel` to ever be over 4 - the usual depth of a Tailwind config. A higher value is also likely to increase boot-time and disk space in dev. Refer to the [Nuxt Virtual File System](https://nuxt.com/docs/guide/directory-structure/nuxt#virtual-file-system) to see generated files.
 
 ::
 

docs/content/2.tailwind/1.config.md

@@ -248,3 +248,9 @@ import { _800 as slate800 } from '#tailwind-config/theme/colors/slate'  // alias
   Please be aware this adds `~19.5KB` (`~3.5KB`) to the client bundle size.
 
 ::
+
+::alert{type="info"}
+
+  Import types are only provided through the `#tailwind-config/*` alias.
+
+::

src/module.ts

@@ -179,30 +179,30 @@ export default defineNuxtModule<ModuleOptions>({
        * @param maxLevel maximum level of depth
        */
       const populateMap = (obj: any, path: string[] = [], level = 1, maxLevel = moduleOptions.exposeLevel) => {
-        Object.entries(obj).forEach(([key, value = {}]) => {
+        Object.entries(obj).forEach(([key, value = {} as any]) => {
           const subpath = path.concat(key).join('/')
 
           if (
             level >= maxLevel || // if recursive call is more than desired
             typeof value !== 'object' || // if its not an object, no more recursion required
             Array.isArray(value) || // arrays are objects in JS, but we can't break it down
-            Object.keys(value as any).find(k => !k.match(/^[0-9a-z]+$/i)) // object has non-alphanumeric property (unsafe var name)
+            Object.keys(value).find(k => !k.match(/^[0-9a-z]+$/i)) // object has non-alphanumeric property (unsafe var name)
           ) {
-            const t = addTemplate({
+            addTemplate({
               filename: `tailwind.config/${subpath}.mjs`,
               getContents: () => `export default ${JSON.stringify(value, null, 2)}`
             })
-            dtsContent.push(`declare module "${`.nuxt/tailwind.config/${subpath}` || t.dst}" { const defaultExport: ${JSON.stringify(value)}; export default defaultExport; }`)
+            dtsContent.push(`declare module "#tailwind-config/${subpath}" { const defaultExport: ${JSON.stringify(value)}; export default defaultExport; }`)
           } else {
             // recurse through nested objects
             populateMap(value, path.concat(key), level + 1, maxLevel)
 
-            const values = Object.keys(value as any)
-            const t = addTemplate({
+            const values = Object.keys(value)
+            addTemplate({
               filename: `tailwind.config/${subpath}.mjs`,
               getContents: () => `${values.map(v => `import _${v} from "./${key}/${v}.mjs"`).join('\n')}\nconst config = { ${values.map(k => `"${k}": _${k}`).join(', ')} }\nexport { config as default${values.length > 0 ? ', _' : ''}${values.join(', _')} }`
             })
-            dtsContent.push(`declare module "${`.nuxt/tailwind.config/${subpath}` || t.dst}" {${Object.keys(value as any).map(v => ` export const _${v}: typeof import("${join(`.nuxt/tailwind.config/${key}/${subpath}` || t.dst, `../${v}`)}");`).join('')} const defaultExport: { ${values.map(k => `"${k}": typeof _${k}`).join(', ')} }; export default defaultExport; }`)
+            dtsContent.push(`declare module "#tailwind-config/${subpath}" {${Object.keys(value).map(v => ` export const _${v}: typeof import("#tailwind-config/${join(`${key}/${subpath}`, `../${v}`)}");`).join('')} const defaultExport: { ${values.map(k => `"${k}": typeof _${k}`).join(', ')} }; export default defaultExport; }`)
           }
         })
       }
@@ -215,14 +215,16 @@ export default defineNuxtModule<ModuleOptions>({
         getContents: () => `${configOptions.map(v => `import ${v} from "#build/tailwind.config/${v}.mjs"`).join('\n')}\nconst config = { ${configOptions.join(', ')} }\nexport { config as default, ${configOptions.join(', ')} }`,
         write: true
       })
-      dtsContent.push(`declare module "${'.nuxt/tailwind.config' || template.dst}" {${configOptions.map(v => ` export const ${v}: typeof import("${join('.nuxt/tailwind.config' || template.dst, v)}");`).join('')} const defaultExport: { ${configOptions.map(v => `"${v}": typeof ${v}`)} }; export default defaultExport; }`)
-
-      addTemplate({
+      dtsContent.push(`declare module "#tailwind-config" {${configOptions.map(v => ` export const ${v}: typeof import("${join('#tailwind-config', v)}");`).join('')} const defaultExport: { ${configOptions.map(v => `"${v}": typeof ${v}`)} }; export default defaultExport; }`)
+      const typesTemplate = addTemplate({
         filename: 'tailwind.config.d.ts',
         getContents: () => dtsContent.join('\n'),
         write: true
       })
       nuxt.options.alias['#tailwind-config'] = dirname(template.dst)
+      nuxt.hook('prepare:types', (opts) => {
+        opts.references.push({ path: typesTemplate.dst })
+      })
     }
 
     // Allow extending tailwindcss config by other modules