@viberails/types 0.3.3 → 0.5.0

package/dist/index.cjs

@@ -148,7 +148,7 @@ var ROLE_DESCRIPTIONS = {
 };
 
 // src/index.ts
-var VERSION = "0.3.3";
+var VERSION = "0.5.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CONVENTION_LABELS,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/confidence.ts","../src/display-names.ts"],"sourcesContent":["declare const __PACKAGE_VERSION__: string;\nexport const VERSION: string = __PACKAGE_VERSION__;\n\nexport type { BoundaryConfig, BoundaryRule, BoundaryViolation } from './boundary.js';\nexport type { CheckResult, CheckRule, CheckViolation } from './check-result.js';\nexport type { Confidence, DetectedConvention } from './confidence.js';\nexport { confidenceFromConsistency } from './confidence.js';\nexport type {\n  ConfigConventions,\n  ConfigRules,\n  ConfigStack,\n  ConfigStructure,\n  ConventionValue,\n  PackageConfigOverrides,\n  ViberailsConfig,\n  WorkspaceConfig,\n} from './config.js';\nexport {\n  CONVENTION_LABELS,\n  FRAMEWORK_NAMES,\n  LIBRARY_NAMES,\n  ORM_NAMES,\n  ROLE_DESCRIPTIONS,\n  STYLING_NAMES,\n} from './display-names.js';\nexport type {\n  ImportEdge,\n  ImportGraph,\n  ImportGraphNode,\n  ImportKind,\n  WorkspacePackage,\n} from './graph.js';\nexport type {\n  CodebaseStatistics,\n  DetectedStack,\n  DetectedStructure,\n  DetectedWorkspace,\n  DirectoryInfo,\n  DirectoryRole,\n  FileStatistic,\n  PackageScanResult,\n  ScanResult,\n  StackItem,\n} from './scan-result.js';\n","/**\n * Confidence level for a detected convention or pattern.\n *\n * - `'high'` — ≥90% consistency across analyzed files. Enforced by default.\n * - `'medium'` — 70–89% consistency. Included in config but not enforced.\n * - `'low'` — <70% consistency. Omitted from config entirely.\n */\nexport type Confidence = 'high' | 'medium' | 'low';\n\n/**\n * A convention or pattern detected by the scanner, with metadata\n * about how confidently it was identified.\n *\n * @typeParam T - The type of the detected value. Defaults to `string`.\n */\nexport interface DetectedConvention<T = string> {\n  /** The detected value (e.g. a naming pattern, file extension, or path). */\n  value: T;\n\n  /** How confident the scanner is in this detection. */\n  confidence: Confidence;\n\n  /** Number of files analyzed to determine this convention. */\n  sampleSize: number;\n\n  /** Percentage (0–100) of files that follow this convention. */\n  consistency: number;\n}\n\n/**\n * Derives a confidence level from a consistency percentage.\n *\n * @param consistency - A number from 0 to 100 representing the percentage\n *   of files that follow a given convention.\n * @returns The corresponding confidence level:\n *   - `'high'` for consistency ≥ 90\n *   - `'medium'` for consistency ≥ 70 and < 90\n *   - `'low'` for consistency < 70\n */\nexport function confidenceFromConsistency(consistency: number): Confidence {\n  if (consistency >= 90) return 'high';\n  if (consistency >= 70) return 'medium';\n  return 'low';\n}\n","/** Display names for framework identifiers. */\nexport const FRAMEWORK_NAMES: Record<string, string> = {\n  nextjs: 'Next.js',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  angular: 'Angular',\n  remix: 'Remix',\n  nuxt: 'Nuxt',\n  sveltekit: 'SvelteKit',\n  astro: 'Astro',\n  gatsby: 'Gatsby',\n  solidjs: 'Solid.js',\n  qwik: 'Qwik',\n  electron: 'Electron',\n  tauri: 'Tauri',\n  nestjs: 'NestJS',\n  express: 'Express',\n  fastify: 'Fastify',\n  koa: 'Koa',\n  hono: 'Hono',\n  supabase: 'Supabase',\n  firebase: 'Firebase',\n  convex: 'Convex',\n};\n\n/** Display names for styling libraries. */\nexport const STYLING_NAMES: Record<string, string> = {\n  tailwindcss: 'Tailwind CSS',\n  'css-modules': 'CSS Modules',\n  'styled-components': 'styled-components',\n  emotion: 'Emotion',\n  sass: 'Sass',\n  'vanilla-extract': 'Vanilla Extract',\n  unocss: 'UnoCSS',\n  'panda-css': 'Panda CSS',\n  nativewind: 'NativeWind',\n};\n\n/** Display names for ORM / database clients. */\nexport const ORM_NAMES: Record<string, string> = {\n  prisma: 'Prisma',\n  drizzle: 'Drizzle',\n  typeorm: 'TypeORM',\n  sequelize: 'Sequelize',\n  mongoose: 'Mongoose',\n  kysely: 'Kysely',\n  'mikro-orm': 'MikroORM',\n};\n\n/** Display names for notable libraries. */\nexport const LIBRARY_NAMES: Record<string, string> = {\n  'react-query': 'React Query',\n  'tanstack-query': 'TanStack Query',\n  zod: 'Zod',\n  trpc: 'tRPC',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  nextjs: 'Next.js',\n  react: 'React',\n  sveltekit: 'SvelteKit',\n  svelte: 'Svelte',\n  astro: 'Astro',\n  vue: 'Vue',\n  apollo: 'Apollo Client',\n  urql: 'urql',\n  graphql: 'GraphQL',\n  'redux-toolkit': 'Redux Toolkit',\n  zustand: 'Zustand',\n  jotai: 'Jotai',\n  recoil: 'Recoil',\n  mobx: 'MobX',\n  xstate: 'XState',\n  valtio: 'Valtio',\n  'react-hook-form': 'React Hook Form',\n  formik: 'Formik',\n  axios: 'Axios',\n  'next-auth': 'NextAuth.js',\n  'auth-js': 'Auth.js',\n  clerk: 'Clerk',\n  lucia: 'Lucia',\n  'date-fns': 'date-fns',\n  dayjs: 'Day.js',\n  luxon: 'Luxon',\n  i18next: 'i18next',\n  'next-i18next': 'next-i18next',\n  stripe: 'Stripe',\n  'socket.io': 'Socket.IO',\n  'testing-library': 'Testing Library',\n  msw: 'MSW',\n  storybook: 'Storybook',\n  vite: 'Vite',\n  webpack: 'webpack',\n  esbuild: 'esbuild',\n  rspack: 'Rspack',\n  nx: 'Nx',\n  lerna: 'Lerna',\n};\n\n/** Display labels for convention keys. */\nexport const CONVENTION_LABELS: Record<string, string> = {\n  fileNaming: 'File naming',\n  componentNaming: 'Component naming',\n  hookNaming: 'Hook naming',\n  importAlias: 'Import alias',\n};\n\n/** Display names for directory roles. */\nexport const ROLE_DESCRIPTIONS: Record<string, string> = {\n  pages: 'Pages / Routes',\n  components: 'Components',\n  hooks: 'Hooks',\n  utils: 'Utilities',\n  types: 'Type definitions',\n  tests: 'Tests',\n  styles: 'Styles',\n  api: 'API routes',\n  config: 'Configuration',\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACuCO,SAAS,0BAA0B,aAAiC;AACzE,MAAI,eAAe,GAAI,QAAO;AAC9B,MAAI,eAAe,GAAI,QAAO;AAC9B,SAAO;AACT;;;AC1CO,IAAM,kBAA0C;AAAA,EACrD,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,KAAK;AAAA,EACL,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AACV;AAGO,IAAM,gBAAwC;AAAA,EACnD,aAAa;AAAA,EACb,eAAe;AAAA,EACf,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,MAAM;AAAA,EACN,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,YAAY;AACd;AAGO,IAAM,YAAoC;AAAA,EAC/C,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,aAAa;AACf;AAGO,IAAM,gBAAwC;AAAA,EACnD,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,KAAK;AAAA,EACL,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,IAAI;AAAA,EACJ,OAAO;AACT;AAGO,IAAM,oBAA4C;AAAA,EACvD,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,aAAa;AACf;AAGO,IAAM,oBAA4C;AAAA,EACvD,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,QAAQ;AACV;;;AFpHO,IAAM,UAAkB;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/confidence.ts","../src/display-names.ts"],"sourcesContent":["declare const __PACKAGE_VERSION__: string;\nexport const VERSION: string = __PACKAGE_VERSION__;\n\nexport type { BoundaryConfig, BoundaryRule, BoundaryViolation } from './boundary.js';\nexport type { CheckResult, CheckRule, CheckViolation } from './check-result.js';\nexport type { Confidence, DetectedConvention } from './confidence.js';\nexport { confidenceFromConsistency } from './confidence.js';\nexport type {\n  ConfigConventions,\n  ConfigCoverage,\n  ConfigDefaults,\n  ConfigMeta,\n  ConfigRules,\n  ConfigStack,\n  ConfigStructure,\n  ConventionMeta,\n  PackageBoundary,\n  PackageConfig,\n  PackageMeta,\n  ViberailsConfig,\n} from './config.js';\nexport {\n  CONVENTION_LABELS,\n  FRAMEWORK_NAMES,\n  LIBRARY_NAMES,\n  ORM_NAMES,\n  ROLE_DESCRIPTIONS,\n  STYLING_NAMES,\n} from './display-names.js';\nexport type {\n  ImportEdge,\n  ImportGraph,\n  ImportGraphNode,\n  ImportKind,\n  WorkspacePackage,\n} from './graph.js';\nexport type {\n  CodebaseStatistics,\n  DetectedStack,\n  DetectedStructure,\n  DetectedWorkspace,\n  DirectoryInfo,\n  DirectoryRole,\n  FileStatistic,\n  PackageScanResult,\n  ScanResult,\n  StackItem,\n} from './scan-result.js';\n","/**\n * Confidence level for a detected convention or pattern.\n *\n * - `'high'` — ≥90% consistency across analyzed files. Enforced by default.\n * - `'medium'` — 70–89% consistency. Included in config but not enforced.\n * - `'low'` — <70% consistency. Omitted from config entirely.\n */\nexport type Confidence = 'high' | 'medium' | 'low';\n\n/**\n * A convention or pattern detected by the scanner, with metadata\n * about how confidently it was identified.\n *\n * @typeParam T - The type of the detected value. Defaults to `string`.\n */\nexport interface DetectedConvention<T = string> {\n  /** The detected value (e.g. a naming pattern, file extension, or path). */\n  value: T;\n\n  /** How confident the scanner is in this detection. */\n  confidence: Confidence;\n\n  /** Number of files analyzed to determine this convention. */\n  sampleSize: number;\n\n  /** Percentage (0–100) of files that follow this convention. */\n  consistency: number;\n}\n\n/**\n * Derives a confidence level from a consistency percentage.\n *\n * @param consistency - A number from 0 to 100 representing the percentage\n *   of files that follow a given convention.\n * @returns The corresponding confidence level:\n *   - `'high'` for consistency ≥ 90\n *   - `'medium'` for consistency ≥ 70 and < 90\n *   - `'low'` for consistency < 70\n */\nexport function confidenceFromConsistency(consistency: number): Confidence {\n  if (consistency >= 90) return 'high';\n  if (consistency >= 70) return 'medium';\n  return 'low';\n}\n","/** Display names for framework identifiers. */\nexport const FRAMEWORK_NAMES: Record<string, string> = {\n  nextjs: 'Next.js',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  angular: 'Angular',\n  remix: 'Remix',\n  nuxt: 'Nuxt',\n  sveltekit: 'SvelteKit',\n  astro: 'Astro',\n  gatsby: 'Gatsby',\n  solidjs: 'Solid.js',\n  qwik: 'Qwik',\n  electron: 'Electron',\n  tauri: 'Tauri',\n  nestjs: 'NestJS',\n  express: 'Express',\n  fastify: 'Fastify',\n  koa: 'Koa',\n  hono: 'Hono',\n  supabase: 'Supabase',\n  firebase: 'Firebase',\n  convex: 'Convex',\n};\n\n/** Display names for styling libraries. */\nexport const STYLING_NAMES: Record<string, string> = {\n  tailwindcss: 'Tailwind CSS',\n  'css-modules': 'CSS Modules',\n  'styled-components': 'styled-components',\n  emotion: 'Emotion',\n  sass: 'Sass',\n  'vanilla-extract': 'Vanilla Extract',\n  unocss: 'UnoCSS',\n  'panda-css': 'Panda CSS',\n  nativewind: 'NativeWind',\n};\n\n/** Display names for ORM / database clients. */\nexport const ORM_NAMES: Record<string, string> = {\n  prisma: 'Prisma',\n  drizzle: 'Drizzle',\n  typeorm: 'TypeORM',\n  sequelize: 'Sequelize',\n  mongoose: 'Mongoose',\n  kysely: 'Kysely',\n  'mikro-orm': 'MikroORM',\n};\n\n/** Display names for notable libraries. */\nexport const LIBRARY_NAMES: Record<string, string> = {\n  'react-query': 'React Query',\n  'tanstack-query': 'TanStack Query',\n  zod: 'Zod',\n  trpc: 'tRPC',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  nextjs: 'Next.js',\n  react: 'React',\n  sveltekit: 'SvelteKit',\n  svelte: 'Svelte',\n  astro: 'Astro',\n  vue: 'Vue',\n  apollo: 'Apollo Client',\n  urql: 'urql',\n  graphql: 'GraphQL',\n  'redux-toolkit': 'Redux Toolkit',\n  zustand: 'Zustand',\n  jotai: 'Jotai',\n  recoil: 'Recoil',\n  mobx: 'MobX',\n  xstate: 'XState',\n  valtio: 'Valtio',\n  'react-hook-form': 'React Hook Form',\n  formik: 'Formik',\n  axios: 'Axios',\n  'next-auth': 'NextAuth.js',\n  'auth-js': 'Auth.js',\n  clerk: 'Clerk',\n  lucia: 'Lucia',\n  'date-fns': 'date-fns',\n  dayjs: 'Day.js',\n  luxon: 'Luxon',\n  i18next: 'i18next',\n  'next-i18next': 'next-i18next',\n  stripe: 'Stripe',\n  'socket.io': 'Socket.IO',\n  'testing-library': 'Testing Library',\n  msw: 'MSW',\n  storybook: 'Storybook',\n  vite: 'Vite',\n  webpack: 'webpack',\n  esbuild: 'esbuild',\n  rspack: 'Rspack',\n  nx: 'Nx',\n  lerna: 'Lerna',\n};\n\n/** Display labels for convention keys. */\nexport const CONVENTION_LABELS: Record<string, string> = {\n  fileNaming: 'File naming',\n  componentNaming: 'Component naming',\n  hookNaming: 'Hook naming',\n  importAlias: 'Import alias',\n};\n\n/** Display names for directory roles. */\nexport const ROLE_DESCRIPTIONS: Record<string, string> = {\n  pages: 'Pages / Routes',\n  components: 'Components',\n  hooks: 'Hooks',\n  utils: 'Utilities',\n  types: 'Type definitions',\n  tests: 'Tests',\n  styles: 'Styles',\n  api: 'API routes',\n  config: 'Configuration',\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACuCO,SAAS,0BAA0B,aAAiC;AACzE,MAAI,eAAe,GAAI,QAAO;AAC9B,MAAI,eAAe,GAAI,QAAO;AAC9B,SAAO;AACT;;;AC1CO,IAAM,kBAA0C;AAAA,EACrD,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,KAAK;AAAA,EACL,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AACV;AAGO,IAAM,gBAAwC;AAAA,EACnD,aAAa;AAAA,EACb,eAAe;AAAA,EACf,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,MAAM;AAAA,EACN,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,YAAY;AACd;AAGO,IAAM,YAAoC;AAAA,EAC/C,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,aAAa;AACf;AAGO,IAAM,gBAAwC;AAAA,EACnD,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,KAAK;AAAA,EACL,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,IAAI;AAAA,EACJ,OAAO;AACT;AAGO,IAAM,oBAA4C;AAAA,EACvD,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,aAAa;AACf;AAGO,IAAM,oBAA4C;AAAA,EACvD,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,QAAQ;AACV;;;AFpHO,IAAM,UAAkB;","names":[]}

package/dist/index.d.cts

@@ -32,7 +32,7 @@ interface BoundaryViolation {
 /**
  * The type of rule that was violated.
  */
-type CheckRule = 'file-size' | 'file-naming' | 'missing-test' | 'boundary-violation';
+type CheckRule = 'file-size' | 'file-naming' | 'missing-test' | 'test-coverage' | 'boundary-violation';
 /**
  * A single rule violation detected by `viberails check`.
  */
@@ -43,7 +43,7 @@ interface CheckViolation {
     rule: CheckRule;
     /** Human-readable description of the violation. */
     message: string;
-    /** Severity derived from config.enforcement. */
+    /** Severity derived from CLI mode (warn vs enforce). */
     severity: 'error' | 'warn';
 }
 /**
@@ -54,8 +54,6 @@ interface CheckResult {
     violations: CheckViolation[];
     /** Number of files that were checked. */
     checkedFiles: number;
-    /** The enforcement mode from config. */
-    enforcement: 'enforce' | 'warn';
 }
 
 /**
@@ -101,55 +99,113 @@ declare function confidenceFromConsistency(consistency: number): Confidence;
 interface ViberailsConfig {
     /** JSON Schema URL for editor validation. */
     $schema?: string;
-    /** Config format version. Always `1` for V1.0. */
+    /** Config format version. Always `1`. */
     version: number;
     /** Project name, typically from package.json. */
     name: string;
-    /** Whether conventions are warned about or enforced as errors. */
-    enforcement: 'warn' | 'enforce';
-    /** Detected or configured technology stack. */
-    stack: ConfigStack;
-    /** Detected or configured directory structure. */
-    structure: ConfigStructure;
-    /** Detected or configured coding conventions. */
-    conventions: ConfigConventions;
     /** Rule thresholds and toggles for enforcement. */
     rules: ConfigRules;
-    /** Glob patterns for files and directories to ignore. */
-    ignore: string[];
+    /** Glob patterns for files and directories to ignore. Project-specific only. */
+    ignore?: string[];
     /** Module boundary rules for import enforcement. */
     boundaries?: BoundaryConfig;
-    /** Workspace configuration for monorepo support (V1.1+). */
-    workspace?: WorkspaceConfig;
-    /** Per-package overrides for monorepo projects. Only packages that differ from global. */
-    packages?: PackageConfigOverrides[];
+    /**
+     * Shared defaults for all packages. Packages inherit these values
+     * and can override any field. Only present when packages share common config.
+     * Written by compactConfig(), consumed by expandDefaults() on load.
+     */
+    defaults?: ConfigDefaults;
+    /**
+     * Per-package configs. Required — single projects use `path: "."`.
+     * After loading, each package is self-contained (expandDefaults merges defaults in).
+     * On disk, stack/structure/conventions may be omitted when covered by defaults.
+     */
+    packages: PackageConfig[];
+    /** Scanner metadata. Regenerated on every sync — not user-editable. */
+    _meta?: ConfigMeta;
 }
 /**
- * Per-package configuration overrides for monorepo projects.
- * Only fields that differ from the global config are included.
+ * Per-package configuration.
+ * Self-contained after loading: stack, structure, and conventions are fully populated.
+ * On disk, these fields are optional — expandDefaults fills them from defaults.
  */
-interface PackageConfigOverrides {
+interface PackageConfig {
     /** Package name from package.json. */
     name: string;
-    /** Relative path to the package (e.g. "apps/web"). */
+    /** Relative path to the package (e.g. "apps/web", "." for root). */
     path: string;
-    /** Override stack fields (only differences from global). */
-    stack?: Partial<ConfigStack>;
-    /** Override conventions (only differences from global). */
-    conventions?: Partial<ConfigConventions>;
-    /** Override rules (only differences from global). */
+    /** Technology stack for this package. Optional on disk, filled by expandDefaults. */
+    stack?: ConfigStack;
+    /** Directory structure for this package. Optional on disk, filled by expandDefaults. */
+    structure?: ConfigStructure;
+    /** Coding conventions for this package. Optional on disk, filled by expandDefaults. */
+    conventions?: ConfigConventions;
+    /** Override rules for this package (only differences from global). */
     rules?: Partial<ConfigRules>;
+    /** Coverage command/path overrides for this package. */
+    coverage?: ConfigCoverage;
     /** Additional ignore patterns for this package (appended to global). */
     ignore?: string[];
+    /** Per-package boundary rules. */
+    boundaries?: PackageBoundary;
+}
+/**
+ * Per-package boundary declaration.
+ */
+interface PackageBoundary {
+    /** Packages/modules this package must NOT import from. */
+    deny: string[];
+    /** Files exempt from boundary checks. */
+    ignore?: string[];
+}
+/**
+ * Shared default values for all packages. Packages inherit from these
+ * and override specific fields. Keeps config DRY when packages share tooling.
+ */
+interface ConfigDefaults {
+    /** Default technology stack, inherited by all packages. */
+    stack?: Partial<ConfigStack>;
+    /** Default directory structure, inherited by all packages. */
+    structure?: Partial<ConfigStructure>;
+    /** Default coding conventions, inherited by all packages. */
+    conventions?: ConfigConventions;
+    /** Default coverage command/path inherited by all packages. */
+    coverage?: ConfigCoverage;
 }
 /**
- * Workspace configuration for monorepo projects.
+ * Coverage collection configuration.
+ * If omitted, viberails falls back to supported test runner defaults.
  */
-interface WorkspaceConfig {
-    /** Relative paths to workspace packages (e.g. `"packages/scanner"`). */
-    packages: string[];
-    /** Whether this project is a monorepo with multiple packages. */
-    isMonorepo: boolean;
+interface ConfigCoverage {
+    /** Command used to generate coverage summary data. */
+    command?: string;
+    /** Relative path to coverage summary JSON (from package root). */
+    summaryPath?: string;
+}
+/**
+ * Scanner metadata, separated from user-editable config.
+ * Regenerated on every `sync`. Never manually edited.
+ */
+interface ConfigMeta {
+    /** ISO timestamp of the last sync. */
+    lastSync?: string;
+    /** Per-package scanner metadata, keyed by package path. */
+    packages?: Record<string, PackageMeta>;
+}
+/** Scanner metadata for a single convention. */
+interface ConventionMeta {
+    /** The value detected by the scanner (e.g. "kebab-case"). */
+    value: string;
+    /** Scanner confidence level. */
+    confidence: Confidence;
+    /** Consistency percentage (0-100). */
+    consistency: number;
+    /** Set when a convention is newly detected during sync. */
+    detected?: boolean;
+}
+/** Scanner metadata for a package. */
+interface PackageMeta {
+    conventions?: Record<string, ConventionMeta>;
 }
 /**
  * Technology stack configuration. Each field is a string identifier,
@@ -177,7 +233,7 @@ interface ConfigStack {
 }
 /**
  * Directory structure configuration. Each field is a path relative
- * to the project root.
+ * to the package root.
  */
 interface ConfigStructure {
     /** Source directory (e.g. `"src"`), or undefined for flat structure. */
@@ -198,33 +254,18 @@ interface ConfigStructure {
     testPattern?: string;
 }
 /**
- * A convention value that may carry scanner metadata.
- * When generated from a scan, includes confidence and consistency info.
- * When manually set, is just a plain string.
- */
-type ConventionValue = string | {
-    /** The convention value. */
-    value: string;
-    /** Scanner confidence level. Prefixed with `_` to signal metadata. */
-    _confidence: Confidence;
-    /** Scanner consistency percentage. Prefixed with `_` to signal metadata. */
-    _consistency: number;
-    /** Set by mergeConfig when a convention is newly detected during sync. */
-    _detected?: boolean;
-};
-/**
- * Coding convention configuration. Each field can be a plain string
- * (confirmed by user) or an object with scanner metadata (auto-detected).
+ * Coding convention configuration. Plain strings only.
+ * Scanner metadata lives in `_meta.packages[path].conventions`.
  */
 interface ConfigConventions {
     /** File naming convention (e.g. `"kebab-case"`, `"camelCase"`). */
-    fileNaming?: ConventionValue;
+    fileNaming?: string;
     /** Component naming convention (e.g. `"PascalCase"`). */
-    componentNaming?: ConventionValue;
+    componentNaming?: string;
     /** Hook naming convention (e.g. `"useXxx"`). */
-    hookNaming?: ConventionValue;
+    hookNaming?: string;
     /** Import alias pattern (e.g. `"@/*"`, `"~/*"`). */
-    importAlias?: ConventionValue;
+    importAlias?: string;
 }
 /**
  * Rule thresholds and toggles for convention enforcement.
@@ -242,15 +283,11 @@ interface ConfigRules {
      */
     maxTestFileLines: number;
     /**
-     * Maximum number of lines allowed per function.
-     * @default 50
-     */
-    maxFunctionLines: number;
-    /**
-     * Whether to require test files for source modules.
-     * @default true
+     * Minimum line coverage target percentage.
+     * 0 disables coverage threshold checks.
+     * @default 80
      */
-    requireTests: boolean;
+    testCoverage: number;
     /**
      * Whether to enforce detected file naming conventions.
      * @default true
@@ -258,9 +295,14 @@ interface ConfigRules {
     enforceNaming: boolean;
     /**
      * Whether to enforce module boundary rules.
-     * @default false (V1.1+ feature)
+     * @default false
      */
     enforceBoundaries: boolean;
+    /**
+     * Whether to enforce that every source file has a corresponding test file.
+     * @default true
+     */
+    enforceMissingTests: boolean;
 }
 
 /** Display names for framework identifiers. */
@@ -368,6 +410,8 @@ interface PackageScanResult {
     conventions: Record<string, DetectedConvention>;
     /** Quantitative statistics for this package. */
     statistics: CodebaseStatistics;
+    /** Whether this package appears to be types-only (no runtime dependencies). */
+    typesOnly?: boolean;
 }
 /**
  * Workspace information detected by scanning the project root
@@ -469,4 +513,4 @@ interface FileStatistic {
 
 declare const VERSION: string;
 
-export { type BoundaryConfig, type BoundaryRule, type BoundaryViolation, CONVENTION_LABELS, type CheckResult, type CheckRule, type CheckViolation, type CodebaseStatistics, type Confidence, type ConfigConventions, type ConfigRules, type ConfigStack, type ConfigStructure, type ConventionValue, type DetectedConvention, type DetectedStack, type DetectedStructure, type DetectedWorkspace, type DirectoryInfo, type DirectoryRole, FRAMEWORK_NAMES, type FileStatistic, type ImportEdge, type ImportGraph, type ImportGraphNode, type ImportKind, LIBRARY_NAMES, ORM_NAMES, type PackageConfigOverrides, type PackageScanResult, ROLE_DESCRIPTIONS, STYLING_NAMES, type ScanResult, type StackItem, VERSION, type ViberailsConfig, type WorkspaceConfig, type WorkspacePackage, confidenceFromConsistency };
+export { type BoundaryConfig, type BoundaryRule, type BoundaryViolation, CONVENTION_LABELS, type CheckResult, type CheckRule, type CheckViolation, type CodebaseStatistics, type Confidence, type ConfigConventions, type ConfigCoverage, type ConfigDefaults, type ConfigMeta, type ConfigRules, type ConfigStack, type ConfigStructure, type ConventionMeta, type DetectedConvention, type DetectedStack, type DetectedStructure, type DetectedWorkspace, type DirectoryInfo, type DirectoryRole, FRAMEWORK_NAMES, type FileStatistic, type ImportEdge, type ImportGraph, type ImportGraphNode, type ImportKind, LIBRARY_NAMES, ORM_NAMES, type PackageBoundary, type PackageConfig, type PackageMeta, type PackageScanResult, ROLE_DESCRIPTIONS, STYLING_NAMES, type ScanResult, type StackItem, VERSION, type ViberailsConfig, type WorkspacePackage, confidenceFromConsistency };

package/dist/index.d.ts

@@ -32,7 +32,7 @@ interface BoundaryViolation {
 /**
  * The type of rule that was violated.
  */
-type CheckRule = 'file-size' | 'file-naming' | 'missing-test' | 'boundary-violation';
+type CheckRule = 'file-size' | 'file-naming' | 'missing-test' | 'test-coverage' | 'boundary-violation';
 /**
  * A single rule violation detected by `viberails check`.
  */
@@ -43,7 +43,7 @@ interface CheckViolation {
     rule: CheckRule;
     /** Human-readable description of the violation. */
     message: string;
-    /** Severity derived from config.enforcement. */
+    /** Severity derived from CLI mode (warn vs enforce). */
     severity: 'error' | 'warn';
 }
 /**
@@ -54,8 +54,6 @@ interface CheckResult {
     violations: CheckViolation[];
     /** Number of files that were checked. */
     checkedFiles: number;
-    /** The enforcement mode from config. */
-    enforcement: 'enforce' | 'warn';
 }
 
 /**
@@ -101,55 +99,113 @@ declare function confidenceFromConsistency(consistency: number): Confidence;
 interface ViberailsConfig {
     /** JSON Schema URL for editor validation. */
     $schema?: string;
-    /** Config format version. Always `1` for V1.0. */
+    /** Config format version. Always `1`. */
     version: number;
     /** Project name, typically from package.json. */
     name: string;
-    /** Whether conventions are warned about or enforced as errors. */
-    enforcement: 'warn' | 'enforce';
-    /** Detected or configured technology stack. */
-    stack: ConfigStack;
-    /** Detected or configured directory structure. */
-    structure: ConfigStructure;
-    /** Detected or configured coding conventions. */
-    conventions: ConfigConventions;
     /** Rule thresholds and toggles for enforcement. */
     rules: ConfigRules;
-    /** Glob patterns for files and directories to ignore. */
-    ignore: string[];
+    /** Glob patterns for files and directories to ignore. Project-specific only. */
+    ignore?: string[];
     /** Module boundary rules for import enforcement. */
     boundaries?: BoundaryConfig;
-    /** Workspace configuration for monorepo support (V1.1+). */
-    workspace?: WorkspaceConfig;
-    /** Per-package overrides for monorepo projects. Only packages that differ from global. */
-    packages?: PackageConfigOverrides[];
+    /**
+     * Shared defaults for all packages. Packages inherit these values
+     * and can override any field. Only present when packages share common config.
+     * Written by compactConfig(), consumed by expandDefaults() on load.
+     */
+    defaults?: ConfigDefaults;
+    /**
+     * Per-package configs. Required — single projects use `path: "."`.
+     * After loading, each package is self-contained (expandDefaults merges defaults in).
+     * On disk, stack/structure/conventions may be omitted when covered by defaults.
+     */
+    packages: PackageConfig[];
+    /** Scanner metadata. Regenerated on every sync — not user-editable. */
+    _meta?: ConfigMeta;
 }
 /**
- * Per-package configuration overrides for monorepo projects.
- * Only fields that differ from the global config are included.
+ * Per-package configuration.
+ * Self-contained after loading: stack, structure, and conventions are fully populated.
+ * On disk, these fields are optional — expandDefaults fills them from defaults.
  */
-interface PackageConfigOverrides {
+interface PackageConfig {
     /** Package name from package.json. */
     name: string;
-    /** Relative path to the package (e.g. "apps/web"). */
+    /** Relative path to the package (e.g. "apps/web", "." for root). */
     path: string;
-    /** Override stack fields (only differences from global). */
-    stack?: Partial<ConfigStack>;
-    /** Override conventions (only differences from global). */
-    conventions?: Partial<ConfigConventions>;
-    /** Override rules (only differences from global). */
+    /** Technology stack for this package. Optional on disk, filled by expandDefaults. */
+    stack?: ConfigStack;
+    /** Directory structure for this package. Optional on disk, filled by expandDefaults. */
+    structure?: ConfigStructure;
+    /** Coding conventions for this package. Optional on disk, filled by expandDefaults. */
+    conventions?: ConfigConventions;
+    /** Override rules for this package (only differences from global). */
     rules?: Partial<ConfigRules>;
+    /** Coverage command/path overrides for this package. */
+    coverage?: ConfigCoverage;
     /** Additional ignore patterns for this package (appended to global). */
     ignore?: string[];
+    /** Per-package boundary rules. */
+    boundaries?: PackageBoundary;
+}
+/**
+ * Per-package boundary declaration.
+ */
+interface PackageBoundary {
+    /** Packages/modules this package must NOT import from. */
+    deny: string[];
+    /** Files exempt from boundary checks. */
+    ignore?: string[];
+}
+/**
+ * Shared default values for all packages. Packages inherit from these
+ * and override specific fields. Keeps config DRY when packages share tooling.
+ */
+interface ConfigDefaults {
+    /** Default technology stack, inherited by all packages. */
+    stack?: Partial<ConfigStack>;
+    /** Default directory structure, inherited by all packages. */
+    structure?: Partial<ConfigStructure>;
+    /** Default coding conventions, inherited by all packages. */
+    conventions?: ConfigConventions;
+    /** Default coverage command/path inherited by all packages. */
+    coverage?: ConfigCoverage;
 }
 /**
- * Workspace configuration for monorepo projects.
+ * Coverage collection configuration.
+ * If omitted, viberails falls back to supported test runner defaults.
  */
-interface WorkspaceConfig {
-    /** Relative paths to workspace packages (e.g. `"packages/scanner"`). */
-    packages: string[];
-    /** Whether this project is a monorepo with multiple packages. */
-    isMonorepo: boolean;
+interface ConfigCoverage {
+    /** Command used to generate coverage summary data. */
+    command?: string;
+    /** Relative path to coverage summary JSON (from package root). */
+    summaryPath?: string;
+}
+/**
+ * Scanner metadata, separated from user-editable config.
+ * Regenerated on every `sync`. Never manually edited.
+ */
+interface ConfigMeta {
+    /** ISO timestamp of the last sync. */
+    lastSync?: string;
+    /** Per-package scanner metadata, keyed by package path. */
+    packages?: Record<string, PackageMeta>;
+}
+/** Scanner metadata for a single convention. */
+interface ConventionMeta {
+    /** The value detected by the scanner (e.g. "kebab-case"). */
+    value: string;
+    /** Scanner confidence level. */
+    confidence: Confidence;
+    /** Consistency percentage (0-100). */
+    consistency: number;
+    /** Set when a convention is newly detected during sync. */
+    detected?: boolean;
+}
+/** Scanner metadata for a package. */
+interface PackageMeta {
+    conventions?: Record<string, ConventionMeta>;
 }
 /**
  * Technology stack configuration. Each field is a string identifier,
@@ -177,7 +233,7 @@ interface ConfigStack {
 }
 /**
  * Directory structure configuration. Each field is a path relative
- * to the project root.
+ * to the package root.
  */
 interface ConfigStructure {
     /** Source directory (e.g. `"src"`), or undefined for flat structure. */
@@ -198,33 +254,18 @@ interface ConfigStructure {
     testPattern?: string;
 }
 /**
- * A convention value that may carry scanner metadata.
- * When generated from a scan, includes confidence and consistency info.
- * When manually set, is just a plain string.
- */
-type ConventionValue = string | {
-    /** The convention value. */
-    value: string;
-    /** Scanner confidence level. Prefixed with `_` to signal metadata. */
-    _confidence: Confidence;
-    /** Scanner consistency percentage. Prefixed with `_` to signal metadata. */
-    _consistency: number;
-    /** Set by mergeConfig when a convention is newly detected during sync. */
-    _detected?: boolean;
-};
-/**
- * Coding convention configuration. Each field can be a plain string
- * (confirmed by user) or an object with scanner metadata (auto-detected).
+ * Coding convention configuration. Plain strings only.
+ * Scanner metadata lives in `_meta.packages[path].conventions`.
  */
 interface ConfigConventions {
     /** File naming convention (e.g. `"kebab-case"`, `"camelCase"`). */
-    fileNaming?: ConventionValue;
+    fileNaming?: string;
     /** Component naming convention (e.g. `"PascalCase"`). */
-    componentNaming?: ConventionValue;
+    componentNaming?: string;
     /** Hook naming convention (e.g. `"useXxx"`). */
-    hookNaming?: ConventionValue;
+    hookNaming?: string;
     /** Import alias pattern (e.g. `"@/*"`, `"~/*"`). */
-    importAlias?: ConventionValue;
+    importAlias?: string;
 }
 /**
  * Rule thresholds and toggles for convention enforcement.
@@ -242,15 +283,11 @@ interface ConfigRules {
      */
     maxTestFileLines: number;
     /**
-     * Maximum number of lines allowed per function.
-     * @default 50
-     */
-    maxFunctionLines: number;
-    /**
-     * Whether to require test files for source modules.
-     * @default true
+     * Minimum line coverage target percentage.
+     * 0 disables coverage threshold checks.
+     * @default 80
      */
-    requireTests: boolean;
+    testCoverage: number;
     /**
      * Whether to enforce detected file naming conventions.
      * @default true
@@ -258,9 +295,14 @@ interface ConfigRules {
     enforceNaming: boolean;
     /**
      * Whether to enforce module boundary rules.
-     * @default false (V1.1+ feature)
+     * @default false
      */
     enforceBoundaries: boolean;
+    /**
+     * Whether to enforce that every source file has a corresponding test file.
+     * @default true
+     */
+    enforceMissingTests: boolean;
 }
 
 /** Display names for framework identifiers. */
@@ -368,6 +410,8 @@ interface PackageScanResult {
     conventions: Record<string, DetectedConvention>;
     /** Quantitative statistics for this package. */
     statistics: CodebaseStatistics;
+    /** Whether this package appears to be types-only (no runtime dependencies). */
+    typesOnly?: boolean;
 }
 /**
  * Workspace information detected by scanning the project root
@@ -469,4 +513,4 @@ interface FileStatistic {
 
 declare const VERSION: string;
 
-export { type BoundaryConfig, type BoundaryRule, type BoundaryViolation, CONVENTION_LABELS, type CheckResult, type CheckRule, type CheckViolation, type CodebaseStatistics, type Confidence, type ConfigConventions, type ConfigRules, type ConfigStack, type ConfigStructure, type ConventionValue, type DetectedConvention, type DetectedStack, type DetectedStructure, type DetectedWorkspace, type DirectoryInfo, type DirectoryRole, FRAMEWORK_NAMES, type FileStatistic, type ImportEdge, type ImportGraph, type ImportGraphNode, type ImportKind, LIBRARY_NAMES, ORM_NAMES, type PackageConfigOverrides, type PackageScanResult, ROLE_DESCRIPTIONS, STYLING_NAMES, type ScanResult, type StackItem, VERSION, type ViberailsConfig, type WorkspaceConfig, type WorkspacePackage, confidenceFromConsistency };
+export { type BoundaryConfig, type BoundaryRule, type BoundaryViolation, CONVENTION_LABELS, type CheckResult, type CheckRule, type CheckViolation, type CodebaseStatistics, type Confidence, type ConfigConventions, type ConfigCoverage, type ConfigDefaults, type ConfigMeta, type ConfigRules, type ConfigStack, type ConfigStructure, type ConventionMeta, type DetectedConvention, type DetectedStack, type DetectedStructure, type DetectedWorkspace, type DirectoryInfo, type DirectoryRole, FRAMEWORK_NAMES, type FileStatistic, type ImportEdge, type ImportGraph, type ImportGraphNode, type ImportKind, LIBRARY_NAMES, ORM_NAMES, type PackageBoundary, type PackageConfig, type PackageMeta, type PackageScanResult, ROLE_DESCRIPTIONS, STYLING_NAMES, type ScanResult, type StackItem, VERSION, type ViberailsConfig, type WorkspacePackage, confidenceFromConsistency };

package/dist/index.js

@@ -115,7 +115,7 @@ var ROLE_DESCRIPTIONS = {
 };
 
 // src/index.ts
-var VERSION = "0.3.3";
+var VERSION = "0.5.0";
 export {
   CONVENTION_LABELS,
   FRAMEWORK_NAMES,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/confidence.ts","../src/display-names.ts","../src/index.ts"],"sourcesContent":["/**\n * Confidence level for a detected convention or pattern.\n *\n * - `'high'` — ≥90% consistency across analyzed files. Enforced by default.\n * - `'medium'` — 70–89% consistency. Included in config but not enforced.\n * - `'low'` — <70% consistency. Omitted from config entirely.\n */\nexport type Confidence = 'high' | 'medium' | 'low';\n\n/**\n * A convention or pattern detected by the scanner, with metadata\n * about how confidently it was identified.\n *\n * @typeParam T - The type of the detected value. Defaults to `string`.\n */\nexport interface DetectedConvention<T = string> {\n  /** The detected value (e.g. a naming pattern, file extension, or path). */\n  value: T;\n\n  /** How confident the scanner is in this detection. */\n  confidence: Confidence;\n\n  /** Number of files analyzed to determine this convention. */\n  sampleSize: number;\n\n  /** Percentage (0–100) of files that follow this convention. */\n  consistency: number;\n}\n\n/**\n * Derives a confidence level from a consistency percentage.\n *\n * @param consistency - A number from 0 to 100 representing the percentage\n *   of files that follow a given convention.\n * @returns The corresponding confidence level:\n *   - `'high'` for consistency ≥ 90\n *   - `'medium'` for consistency ≥ 70 and < 90\n *   - `'low'` for consistency < 70\n */\nexport function confidenceFromConsistency(consistency: number): Confidence {\n  if (consistency >= 90) return 'high';\n  if (consistency >= 70) return 'medium';\n  return 'low';\n}\n","/** Display names for framework identifiers. */\nexport const FRAMEWORK_NAMES: Record<string, string> = {\n  nextjs: 'Next.js',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  angular: 'Angular',\n  remix: 'Remix',\n  nuxt: 'Nuxt',\n  sveltekit: 'SvelteKit',\n  astro: 'Astro',\n  gatsby: 'Gatsby',\n  solidjs: 'Solid.js',\n  qwik: 'Qwik',\n  electron: 'Electron',\n  tauri: 'Tauri',\n  nestjs: 'NestJS',\n  express: 'Express',\n  fastify: 'Fastify',\n  koa: 'Koa',\n  hono: 'Hono',\n  supabase: 'Supabase',\n  firebase: 'Firebase',\n  convex: 'Convex',\n};\n\n/** Display names for styling libraries. */\nexport const STYLING_NAMES: Record<string, string> = {\n  tailwindcss: 'Tailwind CSS',\n  'css-modules': 'CSS Modules',\n  'styled-components': 'styled-components',\n  emotion: 'Emotion',\n  sass: 'Sass',\n  'vanilla-extract': 'Vanilla Extract',\n  unocss: 'UnoCSS',\n  'panda-css': 'Panda CSS',\n  nativewind: 'NativeWind',\n};\n\n/** Display names for ORM / database clients. */\nexport const ORM_NAMES: Record<string, string> = {\n  prisma: 'Prisma',\n  drizzle: 'Drizzle',\n  typeorm: 'TypeORM',\n  sequelize: 'Sequelize',\n  mongoose: 'Mongoose',\n  kysely: 'Kysely',\n  'mikro-orm': 'MikroORM',\n};\n\n/** Display names for notable libraries. */\nexport const LIBRARY_NAMES: Record<string, string> = {\n  'react-query': 'React Query',\n  'tanstack-query': 'TanStack Query',\n  zod: 'Zod',\n  trpc: 'tRPC',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  nextjs: 'Next.js',\n  react: 'React',\n  sveltekit: 'SvelteKit',\n  svelte: 'Svelte',\n  astro: 'Astro',\n  vue: 'Vue',\n  apollo: 'Apollo Client',\n  urql: 'urql',\n  graphql: 'GraphQL',\n  'redux-toolkit': 'Redux Toolkit',\n  zustand: 'Zustand',\n  jotai: 'Jotai',\n  recoil: 'Recoil',\n  mobx: 'MobX',\n  xstate: 'XState',\n  valtio: 'Valtio',\n  'react-hook-form': 'React Hook Form',\n  formik: 'Formik',\n  axios: 'Axios',\n  'next-auth': 'NextAuth.js',\n  'auth-js': 'Auth.js',\n  clerk: 'Clerk',\n  lucia: 'Lucia',\n  'date-fns': 'date-fns',\n  dayjs: 'Day.js',\n  luxon: 'Luxon',\n  i18next: 'i18next',\n  'next-i18next': 'next-i18next',\n  stripe: 'Stripe',\n  'socket.io': 'Socket.IO',\n  'testing-library': 'Testing Library',\n  msw: 'MSW',\n  storybook: 'Storybook',\n  vite: 'Vite',\n  webpack: 'webpack',\n  esbuild: 'esbuild',\n  rspack: 'Rspack',\n  nx: 'Nx',\n  lerna: 'Lerna',\n};\n\n/** Display labels for convention keys. */\nexport const CONVENTION_LABELS: Record<string, string> = {\n  fileNaming: 'File naming',\n  componentNaming: 'Component naming',\n  hookNaming: 'Hook naming',\n  importAlias: 'Import alias',\n};\n\n/** Display names for directory roles. */\nexport const ROLE_DESCRIPTIONS: Record<string, string> = {\n  pages: 'Pages / Routes',\n  components: 'Components',\n  hooks: 'Hooks',\n  utils: 'Utilities',\n  types: 'Type definitions',\n  tests: 'Tests',\n  styles: 'Styles',\n  api: 'API routes',\n  config: 'Configuration',\n};\n","declare const __PACKAGE_VERSION__: string;\nexport const VERSION: string = __PACKAGE_VERSION__;\n\nexport type { BoundaryConfig, BoundaryRule, BoundaryViolation } from './boundary.js';\nexport type { CheckResult, CheckRule, CheckViolation } from './check-result.js';\nexport type { Confidence, DetectedConvention } from './confidence.js';\nexport { confidenceFromConsistency } from './confidence.js';\nexport type {\n  ConfigConventions,\n  ConfigRules,\n  ConfigStack,\n  ConfigStructure,\n  ConventionValue,\n  PackageConfigOverrides,\n  ViberailsConfig,\n  WorkspaceConfig,\n} from './config.js';\nexport {\n  CONVENTION_LABELS,\n  FRAMEWORK_NAMES,\n  LIBRARY_NAMES,\n  ORM_NAMES,\n  ROLE_DESCRIPTIONS,\n  STYLING_NAMES,\n} from './display-names.js';\nexport type {\n  ImportEdge,\n  ImportGraph,\n  ImportGraphNode,\n  ImportKind,\n  WorkspacePackage,\n} from './graph.js';\nexport type {\n  CodebaseStatistics,\n  DetectedStack,\n  DetectedStructure,\n  DetectedWorkspace,\n  DirectoryInfo,\n  DirectoryRole,\n  FileStatistic,\n  PackageScanResult,\n  ScanResult,\n  StackItem,\n} from './scan-result.js';\n"],"mappings":";AAuCO,SAAS,0BAA0B,aAAiC;AACzE,MAAI,eAAe,GAAI,QAAO;AAC9B,MAAI,eAAe,GAAI,QAAO;AAC9B,SAAO;AACT;;;AC1CO,IAAM,kBAA0C;AAAA,EACrD,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,KAAK;AAAA,EACL,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AACV;AAGO,IAAM,gBAAwC;AAAA,EACnD,aAAa;AAAA,EACb,eAAe;AAAA,EACf,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,MAAM;AAAA,EACN,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,YAAY;AACd;AAGO,IAAM,YAAoC;AAAA,EAC/C,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,aAAa;AACf;AAGO,IAAM,gBAAwC;AAAA,EACnD,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,KAAK;AAAA,EACL,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,IAAI;AAAA,EACJ,OAAO;AACT;AAGO,IAAM,oBAA4C;AAAA,EACvD,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,aAAa;AACf;AAGO,IAAM,oBAA4C;AAAA,EACvD,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,QAAQ;AACV;;;ACpHO,IAAM,UAAkB;","names":[]}
+{"version":3,"sources":["../src/confidence.ts","../src/display-names.ts","../src/index.ts"],"sourcesContent":["/**\n * Confidence level for a detected convention or pattern.\n *\n * - `'high'` — ≥90% consistency across analyzed files. Enforced by default.\n * - `'medium'` — 70–89% consistency. Included in config but not enforced.\n * - `'low'` — <70% consistency. Omitted from config entirely.\n */\nexport type Confidence = 'high' | 'medium' | 'low';\n\n/**\n * A convention or pattern detected by the scanner, with metadata\n * about how confidently it was identified.\n *\n * @typeParam T - The type of the detected value. Defaults to `string`.\n */\nexport interface DetectedConvention<T = string> {\n  /** The detected value (e.g. a naming pattern, file extension, or path). */\n  value: T;\n\n  /** How confident the scanner is in this detection. */\n  confidence: Confidence;\n\n  /** Number of files analyzed to determine this convention. */\n  sampleSize: number;\n\n  /** Percentage (0–100) of files that follow this convention. */\n  consistency: number;\n}\n\n/**\n * Derives a confidence level from a consistency percentage.\n *\n * @param consistency - A number from 0 to 100 representing the percentage\n *   of files that follow a given convention.\n * @returns The corresponding confidence level:\n *   - `'high'` for consistency ≥ 90\n *   - `'medium'` for consistency ≥ 70 and < 90\n *   - `'low'` for consistency < 70\n */\nexport function confidenceFromConsistency(consistency: number): Confidence {\n  if (consistency >= 90) return 'high';\n  if (consistency >= 70) return 'medium';\n  return 'low';\n}\n","/** Display names for framework identifiers. */\nexport const FRAMEWORK_NAMES: Record<string, string> = {\n  nextjs: 'Next.js',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  angular: 'Angular',\n  remix: 'Remix',\n  nuxt: 'Nuxt',\n  sveltekit: 'SvelteKit',\n  astro: 'Astro',\n  gatsby: 'Gatsby',\n  solidjs: 'Solid.js',\n  qwik: 'Qwik',\n  electron: 'Electron',\n  tauri: 'Tauri',\n  nestjs: 'NestJS',\n  express: 'Express',\n  fastify: 'Fastify',\n  koa: 'Koa',\n  hono: 'Hono',\n  supabase: 'Supabase',\n  firebase: 'Firebase',\n  convex: 'Convex',\n};\n\n/** Display names for styling libraries. */\nexport const STYLING_NAMES: Record<string, string> = {\n  tailwindcss: 'Tailwind CSS',\n  'css-modules': 'CSS Modules',\n  'styled-components': 'styled-components',\n  emotion: 'Emotion',\n  sass: 'Sass',\n  'vanilla-extract': 'Vanilla Extract',\n  unocss: 'UnoCSS',\n  'panda-css': 'Panda CSS',\n  nativewind: 'NativeWind',\n};\n\n/** Display names for ORM / database clients. */\nexport const ORM_NAMES: Record<string, string> = {\n  prisma: 'Prisma',\n  drizzle: 'Drizzle',\n  typeorm: 'TypeORM',\n  sequelize: 'Sequelize',\n  mongoose: 'Mongoose',\n  kysely: 'Kysely',\n  'mikro-orm': 'MikroORM',\n};\n\n/** Display names for notable libraries. */\nexport const LIBRARY_NAMES: Record<string, string> = {\n  'react-query': 'React Query',\n  'tanstack-query': 'TanStack Query',\n  zod: 'Zod',\n  trpc: 'tRPC',\n  expo: 'Expo',\n  'react-native': 'React Native',\n  nextjs: 'Next.js',\n  react: 'React',\n  sveltekit: 'SvelteKit',\n  svelte: 'Svelte',\n  astro: 'Astro',\n  vue: 'Vue',\n  apollo: 'Apollo Client',\n  urql: 'urql',\n  graphql: 'GraphQL',\n  'redux-toolkit': 'Redux Toolkit',\n  zustand: 'Zustand',\n  jotai: 'Jotai',\n  recoil: 'Recoil',\n  mobx: 'MobX',\n  xstate: 'XState',\n  valtio: 'Valtio',\n  'react-hook-form': 'React Hook Form',\n  formik: 'Formik',\n  axios: 'Axios',\n  'next-auth': 'NextAuth.js',\n  'auth-js': 'Auth.js',\n  clerk: 'Clerk',\n  lucia: 'Lucia',\n  'date-fns': 'date-fns',\n  dayjs: 'Day.js',\n  luxon: 'Luxon',\n  i18next: 'i18next',\n  'next-i18next': 'next-i18next',\n  stripe: 'Stripe',\n  'socket.io': 'Socket.IO',\n  'testing-library': 'Testing Library',\n  msw: 'MSW',\n  storybook: 'Storybook',\n  vite: 'Vite',\n  webpack: 'webpack',\n  esbuild: 'esbuild',\n  rspack: 'Rspack',\n  nx: 'Nx',\n  lerna: 'Lerna',\n};\n\n/** Display labels for convention keys. */\nexport const CONVENTION_LABELS: Record<string, string> = {\n  fileNaming: 'File naming',\n  componentNaming: 'Component naming',\n  hookNaming: 'Hook naming',\n  importAlias: 'Import alias',\n};\n\n/** Display names for directory roles. */\nexport const ROLE_DESCRIPTIONS: Record<string, string> = {\n  pages: 'Pages / Routes',\n  components: 'Components',\n  hooks: 'Hooks',\n  utils: 'Utilities',\n  types: 'Type definitions',\n  tests: 'Tests',\n  styles: 'Styles',\n  api: 'API routes',\n  config: 'Configuration',\n};\n","declare const __PACKAGE_VERSION__: string;\nexport const VERSION: string = __PACKAGE_VERSION__;\n\nexport type { BoundaryConfig, BoundaryRule, BoundaryViolation } from './boundary.js';\nexport type { CheckResult, CheckRule, CheckViolation } from './check-result.js';\nexport type { Confidence, DetectedConvention } from './confidence.js';\nexport { confidenceFromConsistency } from './confidence.js';\nexport type {\n  ConfigConventions,\n  ConfigCoverage,\n  ConfigDefaults,\n  ConfigMeta,\n  ConfigRules,\n  ConfigStack,\n  ConfigStructure,\n  ConventionMeta,\n  PackageBoundary,\n  PackageConfig,\n  PackageMeta,\n  ViberailsConfig,\n} from './config.js';\nexport {\n  CONVENTION_LABELS,\n  FRAMEWORK_NAMES,\n  LIBRARY_NAMES,\n  ORM_NAMES,\n  ROLE_DESCRIPTIONS,\n  STYLING_NAMES,\n} from './display-names.js';\nexport type {\n  ImportEdge,\n  ImportGraph,\n  ImportGraphNode,\n  ImportKind,\n  WorkspacePackage,\n} from './graph.js';\nexport type {\n  CodebaseStatistics,\n  DetectedStack,\n  DetectedStructure,\n  DetectedWorkspace,\n  DirectoryInfo,\n  DirectoryRole,\n  FileStatistic,\n  PackageScanResult,\n  ScanResult,\n  StackItem,\n} from './scan-result.js';\n"],"mappings":";AAuCO,SAAS,0BAA0B,aAAiC;AACzE,MAAI,eAAe,GAAI,QAAO;AAC9B,MAAI,eAAe,GAAI,QAAO;AAC9B,SAAO;AACT;;;AC1CO,IAAM,kBAA0C;AAAA,EACrD,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,KAAK;AAAA,EACL,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AACV;AAGO,IAAM,gBAAwC;AAAA,EACnD,aAAa;AAAA,EACb,eAAe;AAAA,EACf,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,MAAM;AAAA,EACN,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,YAAY;AACd;AAGO,IAAM,YAAoC;AAAA,EAC/C,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,aAAa;AACf;AAGO,IAAM,gBAAwC;AAAA,EACnD,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,mBAAmB;AAAA,EACnB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,KAAK;AAAA,EACL,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,IAAI;AAAA,EACJ,OAAO;AACT;AAGO,IAAM,oBAA4C;AAAA,EACvD,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,aAAa;AACf;AAGO,IAAM,oBAA4C;AAAA,EACvD,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,QAAQ;AACV;;;ACpHO,IAAM,UAAkB;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viberails/types",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "Shared type definitions for viberails",
   "type": "module",
   "main": "./dist/index.cjs",