@nikkory/vibe-engine 4.0.0

package/dist/validators/slot-validator.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Slot Validator - Validates SlotConfig objects
+ *
+ * @packageDocumentation
+ * @module validators/slot-validator
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { ValidationResult } from '../types/algorithm-engine.types';
+import type { ComponentType } from '../types/index';
+import type { SlotConfig, SlotPosition, StoredComponentInSlot } from '../types/section.types';
+/**
+ * Validate a SlotConfig object
+ *
+ * @param config - The SlotConfig to validate
+ * @returns ValidationResult indicating success or failure with error messages
+ *
+ * @example
+ * ```typescript
+ * const result = validateSlotConfig({
+ *   slotId: 'header-slot',
+ *   position: 'header',
+ *   allowedComponents: ['button', 'badge'],
+ *   maxComponents: 5,
+ *   defaultComponent: 'button',
+ * });
+ *
+ * if (result.valid) {
+ *   console.log('Slot config is valid');
+ * } else {
+ *   console.log('Errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateSlotConfig(config: unknown): ValidationResult;
+/**
+ * Validate multiple SlotConfig objects
+ *
+ * @param slots - Array of SlotConfig objects to validate
+ * @returns ValidationResult with aggregated errors and warnings
+ *
+ * @example
+ * ```typescript
+ * const result = validateSlotConfigs([
+ *   { slotId: 'header', position: 'header', ... },
+ *   { slotId: 'content', position: 'content', ... },
+ * ]);
+ * ```
+ */
+export declare function validateSlotConfigs(slots: unknown): ValidationResult;
+/**
+ * Validate a StoredComponentInSlot object
+ *
+ * @param component - The StoredComponentInSlot to validate
+ * @returns ValidationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = validateStoredComponent({
+ *   componentRef: 'button',
+ *   instanceId: 'btn-1',
+ *   propOverrides: { variant: 'primary' },
+ *   order: 0,
+ *   visible: true,
+ * });
+ * ```
+ */
+export declare function validateStoredComponent(component: unknown): ValidationResult;
+/**
+ * Validate StoredComponentInSlot against its SlotConfig
+ *
+ * @param component - The StoredComponentInSlot to validate
+ * @param slotConfig - The SlotConfig to validate against
+ * @returns ValidationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = validateComponentInSlot(
+ *   { componentRef: 'button', ... },
+ *   { allowedComponents: ['button', 'badge'], maxComponents: 5, ... }
+ * );
+ * ```
+ */
+export declare function validateComponentInSlot(component: StoredComponentInSlot, slotConfig: SlotConfig): ValidationResult;
+/**
+ * Validate multiple components in a slot
+ *
+ * @param components - Array of StoredComponentInSlot to validate
+ * @param slotConfig - The SlotConfig to validate against
+ * @returns ValidationResult with aggregated errors
+ *
+ * @example
+ * ```typescript
+ * const result = validateComponentsInSlot(
+ *   [{ componentRef: 'button', ... }, { componentRef: 'badge', ... }],
+ *   { allowedComponents: ['button', 'badge'], maxComponents: 5, ... }
+ * );
+ * ```
+ */
+export declare function validateComponentsInSlot(components: readonly StoredComponentInSlot[], slotConfig: SlotConfig): ValidationResult;
+/**
+ * Create a validated SlotConfig
+ *
+ * @param config - Slot config to validate and return
+ * @returns The validated SlotConfig or throws on invalid
+ * @throws Error if validation fails
+ */
+export declare function createValidatedSlotConfig(config: unknown): SlotConfig;
+/**
+ * Create a validated StoredComponentInSlot
+ *
+ * @param component - Component to validate and return
+ * @returns The validated StoredComponentInSlot or throws on invalid
+ * @throws Error if validation fails
+ */
+export declare function createValidatedStoredComponent(component: unknown): StoredComponentInSlot;
+/**
+ * Type guard to check if a value is a valid SlotPosition
+ */
+export declare function isSlotPosition(value: unknown): value is SlotPosition;
+/**
+ * Type guard to check if a value is a valid ComponentType
+ */
+export declare function isComponentType(value: unknown): value is ComponentType;
+/**
+ * Check if a SlotConfig is valid
+ */
+export declare function isValidSlotConfig(config: unknown): config is SlotConfig;
+/**
+ * Check if a StoredComponentInSlot is valid
+ */
+export declare function isValidStoredComponent(component: unknown): component is StoredComponentInSlot;
+/**
+ * Default slot configuration for header position
+ */
+export declare const DEFAULT_HEADER_SLOT: SlotConfig;
+/**
+ * Default slot configuration for content position
+ */
+export declare const DEFAULT_CONTENT_SLOT: SlotConfig;
+/**
+ * Default slot configuration for footer position
+ */
+export declare const DEFAULT_FOOTER_SLOT: SlotConfig;
+/**
+ * Default slot configuration for sidebar position
+ */
+export declare const DEFAULT_SIDEBAR_SLOT: SlotConfig;
+/**
+ * Default slot configuration for overlay position
+ */
+export declare const DEFAULT_OVERLAY_SLOT: SlotConfig;
+/**
+ * Get default slot config for a position
+ *
+ * @param position - The slot position
+ * @returns Default SlotConfig for the position
+ */
+export declare function getDefaultSlotConfig(position: SlotPosition): SlotConfig;
+//# sourceMappingURL=slot-validator.d.ts.map

package/dist/validators/tier-validator.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Tier Validator
+ * Input validation for tier parameters
+ *
+ * @packageDocumentation
+ * @module validators/tier-validator
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Tier } from '../types';
+import type { ValidationResult } from '../types/algorithm-engine.types';
+/**
+ * Valid tier values
+ */
+export declare const VALID_TIERS: readonly Tier[];
+/**
+ * Check if a value is a valid tier
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid tier
+ *
+ * @example
+ * ```typescript
+ * isValidTier('basic')      // true
+ * isValidTier('enterprise') // true
+ * isValidTier('invalid')    // false
+ * ```
+ */
+export declare function isValidTier(value: unknown): value is Tier;
+/**
+ * Validate tier input
+ *
+ * @param tier - Tier to validate
+ * @returns Validation result with errors and warnings
+ *
+ * @example
+ * ```typescript
+ * validateTier('basic')
+ * // { valid: true, errors: [], warnings: [] }
+ *
+ * validateTier('invalid')
+ * // { valid: false, errors: ['Invalid tier...'], warnings: [] }
+ * ```
+ */
+export declare function validateTier(tier: unknown): ValidationResult;
+/**
+ * Assert that a value is a valid tier
+ *
+ * @param value - Value to check
+ * @throws Error if value is not a valid tier
+ *
+ * @example
+ * ```typescript
+ * assertValidTier('basic') // OK
+ * assertValidTier('invalid') // throws Error
+ * ```
+ */
+export declare function assertValidTier(value: unknown): asserts value is Tier;
+/**
+ * Parse and validate tier, returning undefined for invalid values
+ *
+ * @param value - Value to parse
+ * @returns Valid tier or undefined
+ *
+ * @example
+ * ```typescript
+ * parseTier('basic')   // 'basic'
+ * parseTier('invalid') // undefined
+ * parseTier(123)       // undefined
+ * ```
+ */
+export declare function parseTier(value: unknown): Tier | undefined;
+/**
+ * Get tier with fallback to default
+ *
+ * @param value - Value to check
+ * @param defaultTier - Default tier if invalid
+ * @returns Valid tier
+ *
+ * @example
+ * ```typescript
+ * getTierOrDefault('basic', 'standard')   // 'basic'
+ * getTierOrDefault('invalid', 'standard') // 'standard'
+ * ```
+ */
+export declare function getTierOrDefault(value: unknown, defaultTier: Tier): Tier;
+/**
+ * Suggest correct tier for typos
+ *
+ * @param input - User input
+ * @returns Suggested tier or undefined
+ *
+ * @example
+ * ```typescript
+ * suggestTier('basci')      // 'basic'
+ * suggestTier('enterprise') // 'enterprise'
+ * suggestTier('xyz')        // undefined
+ * ```
+ */
+export declare function suggestTier(input: string): Tier | undefined;
+//# sourceMappingURL=tier-validator.d.ts.map

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@nikkory/vibe-engine",
+  "version": "4.0.0",
+  "description": "Framework-agnostic code generation engine for Nikkory Vibe - Zero-token UI/UX code generation",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "vibe": "bin/vibe.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.mjs",
+      "require": "./dist/browser.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "code-generation",
+    "ui-components",
+    "design-systems",
+    "zero-token",
+    "clean-architecture",
+    "framework-agnostic",
+    "24-factor",
+    "composition-engine"
+  ],
+  "author": "Nikkory <dev@nikkory.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kemonra/nikkory-vibe.git",
+    "directory": "packages/engine"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^25.0.0",
+    "@vitest/coverage-v8": "^4.0.15",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0",
+    "vitest": "^4.0.15"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/tests/16-factor-integration.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 16-Factor Integration Tests
+ *
+ * Integration tests for the complete 16-factor system in StyleGenerator.
+ * Tests factor combinations and ensures all factors work together correctly.
+ *
+ * @packageDocumentation
+ * @module tests/generator/16-factor-integration
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=16-factor-integration.test.d.ts.map

package/tests/16-factor-visual.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 16-Factor Visual E2E Tests
+ *
+ * End-to-end tests for visual verification of 16-Factor system.
+ * These tests verify that factor props correctly apply visual styles.
+ *
+ * @packageDocumentation
+ * @module __tests__/e2e/16-factor-visual
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=16-factor-visual.test.d.ts.map

package/tests/5-level-integration.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 5-Level Abstraction Integration Tests
+ *
+ * Integration tests for the 5-Level Abstraction API with component props.
+ * Tests that MultiLevelProps works correctly across all levels.
+ *
+ * @packageDocumentation
+ * @module tests/resolution/5-level-integration
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=5-level-integration.test.d.ts.map

package/tests/CodeUtils.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CodeUtils Tests
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=CodeUtils.test.d.ts.map

package/tests/DesignSystems.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * DesignSystems Constants Tests
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=DesignSystems.test.d.ts.map

package/tests/GenerateComponentValidator.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * GenerateComponentValidator Tests
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=GenerateComponentValidator.test.d.ts.map

package/tests/Logger.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logger Tests
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Logger.test.d.ts.map

package/tests/StringUtils.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * StringUtils Tests
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=StringUtils.test.d.ts.map

package/tests/StyleGenerator.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * StyleGenerator Unit Tests
+ *
+ * Tests for the core style generation engine.
+ * These tests verify that StyleGenerator correctly generates component styles
+ * from design tokens.
+ *
+ * @packageDocumentation
+ * @module tests/StyleGenerator
+ * @since 2.0.0
+ */
+export {};
+//# sourceMappingURL=StyleGenerator.test.d.ts.map

package/tests/Tiers.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tiers Constants Tests
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Tiers.test.d.ts.map

package/tests/TokenRegistry.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * TokenRegistry Unit Tests
+ *
+ * Tests for the Token Registry - central registry for design system tokens.
+ * Verifies singleton pattern, token retrieval, registration, and utility functions.
+ *
+ * @packageDocumentation
+ * @module tests/TokenRegistry
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=TokenRegistry.test.d.ts.map

package/tests/TokenStyleResolver.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * TokenStyleResolver Unit Tests
+ *
+ * Tests for the Token Style Resolver - converting design tokens to Tailwind classes.
+ *
+ * @packageDocumentation
+ * @module tests/TokenStyleResolver
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=TokenStyleResolver.test.d.ts.map

package/tests/ValidationUtils.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ValidationUtils Tests
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=ValidationUtils.test.d.ts.map

package/tests/_pending_fix/Accordion.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Accordion Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Accordion
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Accordion.test.d.ts.map

package/tests/_pending_fix/Alert.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Alert Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Alert
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Alert.test.d.ts.map

package/tests/_pending_fix/AlertDialog.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AlertDialog Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/AlertDialog
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=AlertDialog.test.d.ts.map

package/tests/_pending_fix/AspectRatio.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AspectRatio Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/AspectRatio
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=AspectRatio.test.d.ts.map

package/tests/_pending_fix/Autocomplete.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Autocomplete Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Autocomplete
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Autocomplete.test.d.ts.map

package/tests/_pending_fix/Avatar.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Avatar Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Avatar
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Avatar.test.d.ts.map

package/tests/_pending_fix/Badge.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Badge Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Badge
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Badge.test.d.ts.map

package/tests/_pending_fix/Banner.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Banner Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Banner
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Banner.test.d.ts.map

package/tests/_pending_fix/Box.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Box Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Box
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Box.test.d.ts.map

package/tests/_pending_fix/Breadcrumb.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Breadcrumb Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Breadcrumb
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Breadcrumb.test.d.ts.map

package/tests/_pending_fix/Callout.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Callout Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Callout
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Callout.test.d.ts.map

package/tests/_pending_fix/Card.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Card Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Card
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Card.test.d.ts.map

package/tests/_pending_fix/Center.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Center Component Tests
+ *
+ * Auto-generated by Code Doctor v4.0
+ *
+ * @packageDocumentation
+ * @module tests/components/Center
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=Center.test.d.ts.map