Usage

Astro Integration Kit provides a suite of useful utilities to help you build your integrations. Some of them are “global” (eg. defineIntegration), others are meant to be used in hooks (eg. addDts) and plugins are available for more advanced usecases (eg. hasVitePluginPlugin). Each utility is fully documented with examples and options!

Here we are using the addDts utility to add a TypeScript declaration file to the user’s project! This is useful for typing things like Virtual Modules!

my-integration/index.ts

import { defineIntegration, addDts } from "astro-integration-kit"
import { z } from "astro/zod"

export default defineIntegration({
    name: "my-integration",
    optionsSchema: z.object({
        virtualModuleId: z.string()
    }),
    setup({ options, name }) {
        return {
            hooks: {
                "astro:config:setup": (params) => {
                    addDts(params, {
                        name,
                        content: `declare module ${JSON.stringify(options.virtualModuleId)} {}`
                    })
                }
            }
        }
    }
})