{"id":22548,"library":"vite-cpat","title":"Vite CPAT","description":"Vite plugin for compiling .cpat files (Clarity Pattern files) using clarity-pattern-parser. Current stable version is 0.1.9. The plugin integrates with Vite's build pipeline to parse .cpat files and export patterns as JavaScript modules. Low release cadence, requires TypeScript module augmentation for type safety. Alternative to manual parsing workflows, designed specifically for Vite projects.","status":"active","version":"0.1.9","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","vite","vite-plugin","typescript"],"install":[{"cmd":"npm install vite-cpat","lang":"bash","label":"npm"},{"cmd":"yarn add vite-cpat","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-cpat","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency for parsing .cpat files","package":"clarity-pattern-parser","optional":false}],"imports":[{"note":"ESM-only; CommonJS require will fail","wrong":"const cpat = require('vite-cpat')","symbol":"default","correct":"import cpat from 'vite-cpat'"},{"note":"Pattern type is imported from clarity-pattern-parser, not vite-cpat","wrong":"import { Pattern } from 'vite-cpat'","symbol":"Pattern","correct":"import type { Pattern } from 'clarity-pattern-parser'"},{"note":"Must include the compileWithParams function export to match the actual module shape","wrong":"declare module '*.cpat' { export default Record<string, Pattern> }","symbol":".cpat module declaration","correct":"declare module '*.cpat' { ... }"}],"quickstart":{"code":"import { defineConfig } from 'vite';\nimport cpat from 'vite-cpat';\n\nexport default defineConfig({\n  plugins: [cpat()],\n});","lang":"typescript","description":"Registers the Vite plugin to handle .cpat files in your project."},"warnings":[{"fix":"Install clarity-pattern-parser: yarn add clarity-pattern-parser","message":"Plugin expects clarity-pattern-parser as a peer dependency; must be installed separately.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Add declare module '*.cpat' { ... } as shown in README","message":"TypeScript projects require a module declaration for '*.cpat' imports; omitted by default.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use import syntax instead of require()","message":"ESM-only; does not support CommonJS require() syntax.","severity":"breaking","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install the package and ensure 'moduleResolution' is set to 'node16' or 'bundler' in tsconfig.json","cause":"Missing installation or TypeScript not configured for ESM resolution.","error":"Cannot find module 'vite-cpat' or its corresponding type declarations."},{"fix":"Add the declare module '*.cpat' block from the README to a global .d.ts file","cause":"Missing module declaration for .cpat files in a TypeScript project.","error":"Module '\"*.cpat\"' resolves to a non-module entity and cannot be imported using this construct."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}