@layermint/sdk-vite

Vite plugin for LayerMint composable srcRoot overrides (region + brand + tenant) with named-export fallback and contract checks.

Install

pnpm add @layermint/sdk-vite

Usage

import { defineConfig } from "vite"
import { createVariantOverridePlugin } from "@layermint/sdk-vite"

export default defineConfig({
  plugins: [
    createVariantOverridePlugin({
      selector: {
        region: process.env.LAYERMINT_REGION,
        brand: process.env.LAYERMINT_BRAND,
        tenant: process.env.LAYERMINT_TENANT,
      },
      layers: ["region", "brand", "tenant", "default"],
      roots: {
        srcRoot: "src",
        variantsRoot: "src/variants",
      },
      mergeStrategy: "namedExport",
      contractChecks: true,
    }),
  ],
})

Rules

• Overrideable modules must use named exports only (no export default).
• Any @/* import under srcRoot can be overridden, except @/variants/*.
• Canonical override path order: region/<key>/brand/<key>/tenant/<key>.

What It Does

• Uses srcRoot as the canonical source tree.
• Resolves overrides from variantsRoot/<selector>/....
• Generates a virtual module that merges named exports with fallback to the default source file.

Docs

• Repository: https://github.com/layermint/layermint-packages