@tachui/core 0.7.0-alpha1

package/dist/validation/build-time/transformer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.cjs","sources":["../../../src/validation/build-time/transformer.ts"],"sourcesContent":["/**\n * TypeScript Transformer for Build-Time Validation\n * \n * Analyzes TypeScript AST to validate TachUI component usage\n * at compile time and provide detailed error messages.\n */\n\n/**\n * NOTE: This module should only be imported in development/build environments.\n * TypeScript is a devDependency and should never be bundled in production.\n */\n\n// Dynamic TypeScript import - only loaded during build-time\nfunction getTypeScript() {\n  if (process.env.NODE_ENV === 'production') {\n    throw new Error('TypeScript transformer should not be used in production')\n  }\n  \n  // Check if we're in a browser environment\n  if (typeof window !== 'undefined') {\n    throw new Error('TypeScript transformer cannot run in browser environment')\n  }\n  \n  try {\n    return require('typescript')\n  } catch (_error) {\n    throw new Error('TypeScript is required for build-time validation. Install with: npm install -D typescript')\n  }\n}\n\nimport type {\n  BuildTimeValidationRule,\n  ValidationContext,\n  ValidationResult,\n  BuildTimeValidationError,\n  ComponentValidationPattern,\n  ModifierValidationPattern\n} from './types'\nimport { componentPatterns, modifierPatterns } from './rules'\n\n/**\n * Main TypeScript transformer factory\n */\nexport function createTachUITransformer(\n  program: any, // ts.Program when TypeScript is available\n  options: { strict?: boolean } = {}\n): any { // ts.TransformerFactory<ts.SourceFile> when TypeScript is available\n  const ts = getTypeScript()\n  \n  return (context: any) => {\n    return (sourceFile: any): any => {\n      const checker = program.getTypeChecker()\n      const validationContext: ValidationContext = {\n        sourceFile,\n        program,\n        checker,\n        fileName: sourceFile.fileName,\n        options: {\n          enabled: true,\n          strictMode: options.strict || false,\n          errorLevel: 'error',\n          excludeFiles: [],\n          includeFiles: [],\n          customRules: [],\n          configFile: ''\n        }\n      }\n\n      const diagnostics: any[] = []\n      \n      function visit(node: any): any {\n        // Check for TachUI component calls\n        if (ts.isCallExpression(node)) {\n          validateComponentCall(node, validationContext, diagnostics)\n        }\n        \n        // Check for TachUI modifier chains\n        if (ts.isPropertyAccessExpression(node)) {\n          validateModifierAccess(node, validationContext, diagnostics)\n        }\n\n        return ts.visitEachChild(node, visit, context)\n      }\n\n      const result = ts.visitNode(sourceFile, visit) as any\n\n      // Report diagnostics\n      if (diagnostics.length > 0) {\n        reportDiagnostics(diagnostics, sourceFile.fileName)\n      }\n\n      return result\n    }\n  }\n}\n\n/**\n * Validate TachUI component call expressions\n */\nfunction validateComponentCall(\n  node: any,\n  context: ValidationContext,\n  diagnostics: any[]\n): void {\n  const { checker, sourceFile } = context\n\n  // Get the function being called\n  const signature = checker.getResolvedSignature(node)\n  if (!signature || !signature.declaration) return\n\n  const symbolName = getSymbolName(node.expression, checker)\n  if (!symbolName) return\n\n  // Check if this is a TachUI component\n  const componentPattern = componentPatterns[symbolName]\n  if (!componentPattern) return\n\n  const errors = validateComponent(node, componentPattern, context)\n  \n  for (const error of errors) {\n    diagnostics.push(createDiagnostic(error, sourceFile))\n  }\n}\n\n/**\n * Validate TachUI modifier property access\n */\nfunction validateModifierAccess(\n  node: any,\n  context: ValidationContext,\n  diagnostics: any[]\n): void {\n  const { checker, sourceFile } = context\n\n  const modifierName = node.name.text\n  const modifierPattern = modifierPatterns[modifierName]\n  \n  if (!modifierPattern) return\n\n  // Get the component type this modifier is being applied to\n  const componentType = getComponentTypeFromExpression(node.expression, checker)\n  if (!componentType) return\n\n  const errors = validateModifier(node, modifierPattern, componentType, context)\n  \n  for (const error of errors) {\n    diagnostics.push(createDiagnostic(error, sourceFile))\n  }\n}\n\n/**\n * Validate a component against its pattern\n */\nfunction validateComponent(\n  node: any,\n  pattern: ComponentValidationPattern,\n  context: ValidationContext\n): BuildTimeValidationError[] {\n  const ts = getTypeScript()\n  const errors: BuildTimeValidationError[] = []\n  const { sourceFile } = context\n\n  // Check argument count\n  const args = node.arguments\n  const requiredCount = pattern.requiredProps.length\n  \n  if (args.length < requiredCount) {\n    const pos = getPosition(node, sourceFile)\n    errors.push({\n      message: `${pattern.componentName} requires ${requiredCount} arguments, got ${args.length}`,\n      code: 'TACH_MISSING_ARGS',\n      severity: 'error',\n      line: pos.line,\n      column: pos.column,\n      length: node.getText().length,\n      category: 'component',\n      component: pattern.componentName,\n      suggestion: `Add missing required properties: ${pattern.requiredProps.slice(args.length).join(', ')}`,\n      documentationLink: `https://docs.tachui.dev/components/${pattern.componentName.toLowerCase()}`\n    })\n  }\n\n  // Validate argument types (basic validation)\n  for (let i = 0; i < args.length && i < pattern.requiredProps.length; i++) {\n    const arg = args[i]\n    const propName = pattern.requiredProps[i]\n    \n    // Check for null/undefined\n    if (ts.isLiteralExpression(arg) && arg.text === 'null') {\n      const pos = getPosition(arg, sourceFile)\n      errors.push({\n        message: `${propName} cannot be null`,\n        code: 'TACH_NULL_PROP',\n        severity: 'error',\n        line: pos.line,\n        column: pos.column,\n        length: arg.getText().length,\n        category: 'component',\n        component: pattern.componentName,\n        suggestion: `Provide a valid value for ${propName}`\n      })\n    }\n  }\n\n  return errors\n}\n\n/**\n * Validate a modifier against its pattern\n */\nfunction validateModifier(\n  node: any,\n  pattern: ModifierValidationPattern,\n  componentType: string,\n  context: ValidationContext\n): BuildTimeValidationError[] {\n  const errors: BuildTimeValidationError[] = []\n  const { sourceFile } = context\n\n  // Check if modifier is valid for this component type\n  if (!pattern.validComponents.includes(componentType) && !pattern.validComponents.includes('*')) {\n    const pos = getPosition(node, sourceFile)\n    errors.push({\n      message: `${pattern.modifierName} modifier is not valid for ${componentType} components`,\n      code: 'TACH_INVALID_MODIFIER',\n      severity: 'error',\n      line: pos.line,\n      column: pos.column,\n      length: node.name.getText().length,\n      category: 'modifier',\n      component: componentType,\n      suggestion: `Use ${pattern.modifierName} with: ${pattern.validComponents.join(', ')}`,\n      documentationLink: `https://docs.tachui.dev/modifiers/${pattern.modifierName}`\n    })\n  }\n\n  return errors\n}\n\n/**\n * Get symbol name from expression\n */\nfunction getSymbolName(expression: any, checker: any): string | null {\n  const ts = getTypeScript()\n  \n  if (ts.isIdentifier(expression)) {\n    return expression.text\n  }\n  \n  if (ts.isPropertyAccessExpression(expression)) {\n    return expression.name.text\n  }\n\n  const symbol = checker.getSymbolAtLocation(expression)\n  return symbol?.name || null\n}\n\n/**\n * Get component type from modifier expression\n */\nfunction getComponentTypeFromExpression(expression: any, checker: any): string | null {\n  // This is a simplified implementation\n  // In practice, we'd need to trace back through the modifier chain\n  // to find the original component constructor\n  \n  const type = checker.getTypeAtLocation(expression)\n  const typeString = checker.typeToString(type)\n  \n  // Look for TachUI component types\n  const componentMatch = typeString.match(/(\\w+)Instance/)\n  return componentMatch ? componentMatch[1] : null\n}\n\n/**\n * Get line and column position from node\n */\nfunction getPosition(node: any, sourceFile: any): { line: number; column: number } {\n  const pos = sourceFile.getLineAndCharacterOfPosition(node.getStart())\n  return {\n    line: pos.line + 1, // 1-based line numbers\n    column: pos.character + 1 // 1-based column numbers\n  }\n}\n\n/**\n * Create TypeScript diagnostic from validation error\n */\nfunction createDiagnostic(error: BuildTimeValidationError, sourceFile: any): any {\n  const ts = getTypeScript()\n  const start = sourceFile.getPositionOfLineAndCharacter(error.line - 1, error.column - 1)\n  \n  return {\n    file: sourceFile,\n    start,\n    length: error.length,\n    messageText: error.message,\n    category: ts.DiagnosticCategory.Error,\n    code: error.code as any,\n    source: 'tachui'\n  }\n}\n\n/**\n * Report diagnostics to console in development\n */\nfunction reportDiagnostics(diagnostics: any[], fileName: string): void {\n  if (process.env.NODE_ENV === 'production') return\n  \n  const ts = getTypeScript()\n\n  console.group(`🔍 TachUI Validation Issues in ${fileName}`)\n  \n  for (const diagnostic of diagnostics) {\n    const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, '\\n')\n    const position = diagnostic.file && diagnostic.start !== undefined\n      ? diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start)\n      : { line: 0, character: 0 }\n    \n    console.error(`❌ Line ${position.line + 1}, Column ${position.character + 1}: ${message}`)\n  }\n  \n  console.groupEnd()\n}\n\n/**\n * Create custom validation rule\n */\nexport function createValidationRule(\n  name: string,\n  validate: (node: any, checker: any, context: ValidationContext) => ValidationResult\n): BuildTimeValidationRule {\n  return {\n    name,\n    severity: 'error',\n    description: `Custom validation rule: ${name}`,\n    validate,\n    generateMessage: (error) => error.message,\n    suggestFix: () => []\n  }\n}\n\n/**\n * Validation rule runner\n */\nexport function runValidationRules(\n  rules: BuildTimeValidationRule[],\n  node: any,\n  context: ValidationContext\n): ValidationResult {\n  const allErrors: BuildTimeValidationError[] = []\n  const allWarnings: BuildTimeValidationError[] = []\n  \n  for (const rule of rules) {\n    const result = rule.validate(node, context.checker, context)\n    \n    if (result.errors) {\n      allErrors.push(...result.errors)\n    }\n    \n    if (result.warnings) {\n      // Convert ValidationWarning to BuildTimeValidationError for consistency\n      const warningErrors = result.warnings.map(w => ({ ...w, severity: 'warning' as const }))\n      allWarnings.push(...warningErrors)\n    }\n  }\n  \n  return {\n    valid: allErrors.length === 0,\n    errors: allErrors,\n    warnings: allWarnings as any[] // Type assertion for compatibility\n  }\n}"],"names":["getTypeScript","createTachUITransformer","program","options","ts","context","sourceFile","checker","validationContext","diagnostics","visit","node","validateComponentCall","validateModifierAccess","result","reportDiagnostics","signature","symbolName","getSymbolName","componentPattern","componentPatterns","errors","validateComponent","error","createDiagnostic","modifierName","modifierPattern","modifierPatterns","componentType","getComponentTypeFromExpression","validateModifier","pattern","args","requiredCount","pos","getPosition","i","arg","propName","expression","type","componentMatch","start","fileName","diagnostic","message","position","createValidationRule","name","validate","runValidationRules","rules","allErrors","allWarnings","rule","warningErrors","w"],"mappings":"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"}

package/dist/validation/build-time/transformer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * TypeScript Transformer for Build-Time Validation
+ *
+ * Analyzes TypeScript AST to validate TachUI component usage
+ * at compile time and provide detailed error messages.
+ */
+import type { BuildTimeValidationRule, ValidationContext, ValidationResult } from './types';
+/**
+ * Main TypeScript transformer factory
+ */
+export declare function createTachUITransformer(program: any, // ts.Program when TypeScript is available
+options?: {
+    strict?: boolean;
+}): any;
+/**
+ * Create custom validation rule
+ */
+export declare function createValidationRule(name: string, validate: (node: any, checker: any, context: ValidationContext) => ValidationResult): BuildTimeValidationRule;
+/**
+ * Validation rule runner
+ */
+export declare function runValidationRules(rules: BuildTimeValidationRule[], node: any, context: ValidationContext): ValidationResult;
+//# sourceMappingURL=transformer.d.ts.map

package/dist/validation/build-time/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../../src/validation/build-time/transformer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAIjB,MAAM,SAAS,CAAA;AAGhB;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,GAAG,EAAE,0CAA0C;AACxD,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,GAAG,CAgDL;AAsOD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,KAAK,gBAAgB,GAClF,uBAAuB,CASzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,EAAE,EAChC,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAuBlB"}

package/dist/validation/build-time/transformer.js

@@ -0,0 +1,177 @@
+import { componentPatterns as d, modifierPatterns as h } from "./rules.js";
+function m() {
+  if (process.env.NODE_ENV === "production")
+    throw new Error("TypeScript transformer should not be used in production");
+  if (typeof window < "u")
+    throw new Error("TypeScript transformer cannot run in browser environment");
+  try {
+    return require("typescript");
+  } catch {
+    throw new Error("TypeScript is required for build-time validation. Install with: npm install -D typescript");
+  }
+}
+function $(e, t = {}) {
+  const n = m();
+  return (o) => (r) => {
+    const c = e.getTypeChecker(), i = {
+      sourceFile: r,
+      checker: c,
+      fileName: r.fileName,
+      options: {
+        strictMode: t.strict || !1
+      }
+    }, a = [];
+    function s(u) {
+      return n.isCallExpression(u) && v(u, i, a), n.isPropertyAccessExpression(u) && y(u, i, a), n.visitEachChild(u, s, o);
+    }
+    const l = n.visitNode(r, s);
+    return a.length > 0 && E(a, r.fileName), l;
+  };
+}
+function v(e, t, n) {
+  const { checker: o, sourceFile: r } = t, c = o.getResolvedSignature(e);
+  if (!c || !c.declaration) return;
+  const i = T(e.expression, o);
+  if (!i) return;
+  const a = d[i];
+  if (!a) return;
+  const s = C(e, a, t);
+  for (const l of s)
+    n.push(p(l, r));
+}
+function y(e, t, n) {
+  const { checker: o, sourceFile: r } = t, c = e.name.text, i = h[c];
+  if (!i) return;
+  const a = w(e.expression, o);
+  if (!a) return;
+  const s = N(e, i, a, t);
+  for (const l of s)
+    n.push(p(l, r));
+}
+function C(e, t, n) {
+  const o = m(), r = [], { sourceFile: c } = n, i = e.arguments, a = t.requiredProps.length;
+  if (i.length < a) {
+    const s = g(e, c);
+    r.push({
+      message: `${t.componentName} requires ${a} arguments, got ${i.length}`,
+      code: "TACH_MISSING_ARGS",
+      severity: "error",
+      line: s.line,
+      column: s.column,
+      length: e.getText().length,
+      category: "component",
+      component: t.componentName,
+      suggestion: `Add missing required properties: ${t.requiredProps.slice(i.length).join(", ")}`,
+      documentationLink: `https://docs.tachui.dev/components/${t.componentName.toLowerCase()}`
+    });
+  }
+  for (let s = 0; s < i.length && s < t.requiredProps.length; s++) {
+    const l = i[s], u = t.requiredProps[s];
+    if (o.isLiteralExpression(l) && l.text === "null") {
+      const f = g(l, c);
+      r.push({
+        message: `${u} cannot be null`,
+        code: "TACH_NULL_PROP",
+        severity: "error",
+        line: f.line,
+        column: f.column,
+        length: l.getText().length,
+        category: "component",
+        component: t.componentName,
+        suggestion: `Provide a valid value for ${u}`
+      });
+    }
+  }
+  return r;
+}
+function N(e, t, n, o) {
+  const r = [], { sourceFile: c } = o;
+  if (!t.validComponents.includes(n) && !t.validComponents.includes("*")) {
+    const i = g(e, c);
+    r.push({
+      message: `${t.modifierName} modifier is not valid for ${n} components`,
+      code: "TACH_INVALID_MODIFIER",
+      severity: "error",
+      line: i.line,
+      column: i.column,
+      length: e.name.getText().length,
+      category: "modifier",
+      component: n,
+      suggestion: `Use ${t.modifierName} with: ${t.validComponents.join(", ")}`,
+      documentationLink: `https://docs.tachui.dev/modifiers/${t.modifierName}`
+    });
+  }
+  return r;
+}
+function T(e, t) {
+  const n = m();
+  return n.isIdentifier(e) ? e.text : n.isPropertyAccessExpression(e) ? e.name.text : t.getSymbolAtLocation(e)?.name || null;
+}
+function w(e, t) {
+  const n = t.getTypeAtLocation(e), r = t.typeToString(n).match(/(\w+)Instance/);
+  return r ? r[1] : null;
+}
+function g(e, t) {
+  const n = t.getLineAndCharacterOfPosition(e.getStart());
+  return {
+    line: n.line + 1,
+    // 1-based line numbers
+    column: n.character + 1
+    // 1-based column numbers
+  };
+}
+function p(e, t) {
+  const n = m(), o = t.getPositionOfLineAndCharacter(e.line - 1, e.column - 1);
+  return {
+    file: t,
+    start: o,
+    length: e.length,
+    messageText: e.message,
+    category: n.DiagnosticCategory.Error,
+    code: e.code,
+    source: "tachui"
+  };
+}
+function E(e, t) {
+  if (process.env.NODE_ENV === "production") return;
+  const n = m();
+  console.group(`🔍 TachUI Validation Issues in ${t}`);
+  for (const o of e) {
+    const r = n.flattenDiagnosticMessageText(o.messageText, `
+`), c = o.file && o.start !== void 0 ? o.file.getLineAndCharacterOfPosition(o.start) : { line: 0, character: 0 };
+    console.error(`❌ Line ${c.line + 1}, Column ${c.character + 1}: ${r}`);
+  }
+  console.groupEnd();
+}
+function A(e, t) {
+  return {
+    name: e,
+    severity: "error",
+    description: `Custom validation rule: ${e}`,
+    validate: t,
+    generateMessage: (n) => n.message,
+    suggestFix: () => []
+  };
+}
+function S(e, t, n) {
+  const o = [], r = [];
+  for (const c of e) {
+    const i = c.validate(t, n.checker, n);
+    if (i.errors && o.push(...i.errors), i.warnings) {
+      const a = i.warnings.map((s) => ({ ...s, severity: "warning" }));
+      r.push(...a);
+    }
+  }
+  return {
+    valid: o.length === 0,
+    errors: o,
+    warnings: r
+    // Type assertion for compatibility
+  };
+}
+export {
+  $ as createTachUITransformer,
+  A as createValidationRule,
+  S as runValidationRules
+};
+//# sourceMappingURL=transformer.js.map

package/dist/validation/build-time/transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.js","sources":["../../../src/validation/build-time/transformer.ts"],"sourcesContent":["/**\n * TypeScript Transformer for Build-Time Validation\n * \n * Analyzes TypeScript AST to validate TachUI component usage\n * at compile time and provide detailed error messages.\n */\n\n/**\n * NOTE: This module should only be imported in development/build environments.\n * TypeScript is a devDependency and should never be bundled in production.\n */\n\n// Dynamic TypeScript import - only loaded during build-time\nfunction getTypeScript() {\n  if (process.env.NODE_ENV === 'production') {\n    throw new Error('TypeScript transformer should not be used in production')\n  }\n  \n  // Check if we're in a browser environment\n  if (typeof window !== 'undefined') {\n    throw new Error('TypeScript transformer cannot run in browser environment')\n  }\n  \n  try {\n    return require('typescript')\n  } catch (_error) {\n    throw new Error('TypeScript is required for build-time validation. Install with: npm install -D typescript')\n  }\n}\n\nimport type {\n  BuildTimeValidationRule,\n  ValidationContext,\n  ValidationResult,\n  BuildTimeValidationError,\n  ComponentValidationPattern,\n  ModifierValidationPattern\n} from './types'\nimport { componentPatterns, modifierPatterns } from './rules'\n\n/**\n * Main TypeScript transformer factory\n */\nexport function createTachUITransformer(\n  program: any, // ts.Program when TypeScript is available\n  options: { strict?: boolean } = {}\n): any { // ts.TransformerFactory<ts.SourceFile> when TypeScript is available\n  const ts = getTypeScript()\n  \n  return (context: any) => {\n    return (sourceFile: any): any => {\n      const checker = program.getTypeChecker()\n      const validationContext: ValidationContext = {\n        sourceFile,\n        program,\n        checker,\n        fileName: sourceFile.fileName,\n        options: {\n          enabled: true,\n          strictMode: options.strict || false,\n          errorLevel: 'error',\n          excludeFiles: [],\n          includeFiles: [],\n          customRules: [],\n          configFile: ''\n        }\n      }\n\n      const diagnostics: any[] = []\n      \n      function visit(node: any): any {\n        // Check for TachUI component calls\n        if (ts.isCallExpression(node)) {\n          validateComponentCall(node, validationContext, diagnostics)\n        }\n        \n        // Check for TachUI modifier chains\n        if (ts.isPropertyAccessExpression(node)) {\n          validateModifierAccess(node, validationContext, diagnostics)\n        }\n\n        return ts.visitEachChild(node, visit, context)\n      }\n\n      const result = ts.visitNode(sourceFile, visit) as any\n\n      // Report diagnostics\n      if (diagnostics.length > 0) {\n        reportDiagnostics(diagnostics, sourceFile.fileName)\n      }\n\n      return result\n    }\n  }\n}\n\n/**\n * Validate TachUI component call expressions\n */\nfunction validateComponentCall(\n  node: any,\n  context: ValidationContext,\n  diagnostics: any[]\n): void {\n  const { checker, sourceFile } = context\n\n  // Get the function being called\n  const signature = checker.getResolvedSignature(node)\n  if (!signature || !signature.declaration) return\n\n  const symbolName = getSymbolName(node.expression, checker)\n  if (!symbolName) return\n\n  // Check if this is a TachUI component\n  const componentPattern = componentPatterns[symbolName]\n  if (!componentPattern) return\n\n  const errors = validateComponent(node, componentPattern, context)\n  \n  for (const error of errors) {\n    diagnostics.push(createDiagnostic(error, sourceFile))\n  }\n}\n\n/**\n * Validate TachUI modifier property access\n */\nfunction validateModifierAccess(\n  node: any,\n  context: ValidationContext,\n  diagnostics: any[]\n): void {\n  const { checker, sourceFile } = context\n\n  const modifierName = node.name.text\n  const modifierPattern = modifierPatterns[modifierName]\n  \n  if (!modifierPattern) return\n\n  // Get the component type this modifier is being applied to\n  const componentType = getComponentTypeFromExpression(node.expression, checker)\n  if (!componentType) return\n\n  const errors = validateModifier(node, modifierPattern, componentType, context)\n  \n  for (const error of errors) {\n    diagnostics.push(createDiagnostic(error, sourceFile))\n  }\n}\n\n/**\n * Validate a component against its pattern\n */\nfunction validateComponent(\n  node: any,\n  pattern: ComponentValidationPattern,\n  context: ValidationContext\n): BuildTimeValidationError[] {\n  const ts = getTypeScript()\n  const errors: BuildTimeValidationError[] = []\n  const { sourceFile } = context\n\n  // Check argument count\n  const args = node.arguments\n  const requiredCount = pattern.requiredProps.length\n  \n  if (args.length < requiredCount) {\n    const pos = getPosition(node, sourceFile)\n    errors.push({\n      message: `${pattern.componentName} requires ${requiredCount} arguments, got ${args.length}`,\n      code: 'TACH_MISSING_ARGS',\n      severity: 'error',\n      line: pos.line,\n      column: pos.column,\n      length: node.getText().length,\n      category: 'component',\n      component: pattern.componentName,\n      suggestion: `Add missing required properties: ${pattern.requiredProps.slice(args.length).join(', ')}`,\n      documentationLink: `https://docs.tachui.dev/components/${pattern.componentName.toLowerCase()}`\n    })\n  }\n\n  // Validate argument types (basic validation)\n  for (let i = 0; i < args.length && i < pattern.requiredProps.length; i++) {\n    const arg = args[i]\n    const propName = pattern.requiredProps[i]\n    \n    // Check for null/undefined\n    if (ts.isLiteralExpression(arg) && arg.text === 'null') {\n      const pos = getPosition(arg, sourceFile)\n      errors.push({\n        message: `${propName} cannot be null`,\n        code: 'TACH_NULL_PROP',\n        severity: 'error',\n        line: pos.line,\n        column: pos.column,\n        length: arg.getText().length,\n        category: 'component',\n        component: pattern.componentName,\n        suggestion: `Provide a valid value for ${propName}`\n      })\n    }\n  }\n\n  return errors\n}\n\n/**\n * Validate a modifier against its pattern\n */\nfunction validateModifier(\n  node: any,\n  pattern: ModifierValidationPattern,\n  componentType: string,\n  context: ValidationContext\n): BuildTimeValidationError[] {\n  const errors: BuildTimeValidationError[] = []\n  const { sourceFile } = context\n\n  // Check if modifier is valid for this component type\n  if (!pattern.validComponents.includes(componentType) && !pattern.validComponents.includes('*')) {\n    const pos = getPosition(node, sourceFile)\n    errors.push({\n      message: `${pattern.modifierName} modifier is not valid for ${componentType} components`,\n      code: 'TACH_INVALID_MODIFIER',\n      severity: 'error',\n      line: pos.line,\n      column: pos.column,\n      length: node.name.getText().length,\n      category: 'modifier',\n      component: componentType,\n      suggestion: `Use ${pattern.modifierName} with: ${pattern.validComponents.join(', ')}`,\n      documentationLink: `https://docs.tachui.dev/modifiers/${pattern.modifierName}`\n    })\n  }\n\n  return errors\n}\n\n/**\n * Get symbol name from expression\n */\nfunction getSymbolName(expression: any, checker: any): string | null {\n  const ts = getTypeScript()\n  \n  if (ts.isIdentifier(expression)) {\n    return expression.text\n  }\n  \n  if (ts.isPropertyAccessExpression(expression)) {\n    return expression.name.text\n  }\n\n  const symbol = checker.getSymbolAtLocation(expression)\n  return symbol?.name || null\n}\n\n/**\n * Get component type from modifier expression\n */\nfunction getComponentTypeFromExpression(expression: any, checker: any): string | null {\n  // This is a simplified implementation\n  // In practice, we'd need to trace back through the modifier chain\n  // to find the original component constructor\n  \n  const type = checker.getTypeAtLocation(expression)\n  const typeString = checker.typeToString(type)\n  \n  // Look for TachUI component types\n  const componentMatch = typeString.match(/(\\w+)Instance/)\n  return componentMatch ? componentMatch[1] : null\n}\n\n/**\n * Get line and column position from node\n */\nfunction getPosition(node: any, sourceFile: any): { line: number; column: number } {\n  const pos = sourceFile.getLineAndCharacterOfPosition(node.getStart())\n  return {\n    line: pos.line + 1, // 1-based line numbers\n    column: pos.character + 1 // 1-based column numbers\n  }\n}\n\n/**\n * Create TypeScript diagnostic from validation error\n */\nfunction createDiagnostic(error: BuildTimeValidationError, sourceFile: any): any {\n  const ts = getTypeScript()\n  const start = sourceFile.getPositionOfLineAndCharacter(error.line - 1, error.column - 1)\n  \n  return {\n    file: sourceFile,\n    start,\n    length: error.length,\n    messageText: error.message,\n    category: ts.DiagnosticCategory.Error,\n    code: error.code as any,\n    source: 'tachui'\n  }\n}\n\n/**\n * Report diagnostics to console in development\n */\nfunction reportDiagnostics(diagnostics: any[], fileName: string): void {\n  if (process.env.NODE_ENV === 'production') return\n  \n  const ts = getTypeScript()\n\n  console.group(`🔍 TachUI Validation Issues in ${fileName}`)\n  \n  for (const diagnostic of diagnostics) {\n    const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, '\\n')\n    const position = diagnostic.file && diagnostic.start !== undefined\n      ? diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start)\n      : { line: 0, character: 0 }\n    \n    console.error(`❌ Line ${position.line + 1}, Column ${position.character + 1}: ${message}`)\n  }\n  \n  console.groupEnd()\n}\n\n/**\n * Create custom validation rule\n */\nexport function createValidationRule(\n  name: string,\n  validate: (node: any, checker: any, context: ValidationContext) => ValidationResult\n): BuildTimeValidationRule {\n  return {\n    name,\n    severity: 'error',\n    description: `Custom validation rule: ${name}`,\n    validate,\n    generateMessage: (error) => error.message,\n    suggestFix: () => []\n  }\n}\n\n/**\n * Validation rule runner\n */\nexport function runValidationRules(\n  rules: BuildTimeValidationRule[],\n  node: any,\n  context: ValidationContext\n): ValidationResult {\n  const allErrors: BuildTimeValidationError[] = []\n  const allWarnings: BuildTimeValidationError[] = []\n  \n  for (const rule of rules) {\n    const result = rule.validate(node, context.checker, context)\n    \n    if (result.errors) {\n      allErrors.push(...result.errors)\n    }\n    \n    if (result.warnings) {\n      // Convert ValidationWarning to BuildTimeValidationError for consistency\n      const warningErrors = result.warnings.map(w => ({ ...w, severity: 'warning' as const }))\n      allWarnings.push(...warningErrors)\n    }\n  }\n  \n  return {\n    valid: allErrors.length === 0,\n    errors: allErrors,\n    warnings: allWarnings as any[] // Type assertion for compatibility\n  }\n}"],"names":["getTypeScript","createTachUITransformer","program","options","ts","context","sourceFile","checker","validationContext","diagnostics","visit","node","validateComponentCall","validateModifierAccess","result","reportDiagnostics","signature","symbolName","getSymbolName","componentPattern","componentPatterns","errors","validateComponent","error","createDiagnostic","modifierName","modifierPattern","modifierPatterns","componentType","getComponentTypeFromExpression","validateModifier","pattern","args","requiredCount","pos","getPosition","i","arg","propName","expression","type","componentMatch","start","fileName","diagnostic","message","position","createValidationRule","name","validate","runValidationRules","rules","allErrors","allWarnings","rule","warningErrors","w"],"mappings":"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"}

package/dist/validation/build-time/types.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Build-Time Validation Types
+ *
+ * Type definitions for the build-time validation system that integrates
+ * with various build tools and provides TypeScript transformer capabilities.
+ */
+import type * as ts from 'typescript';
+/**
+ * Validation rule for build-time checking
+ */
+export interface BuildTimeValidationRule {
+    name: string;
+    severity: 'error' | 'warning' | 'info';
+    description: string;
+    validate(node: ts.Node, checker: ts.TypeChecker, context: ValidationContext): ValidationResult;
+    generateMessage?(error: BuildTimeValidationError): string;
+    suggestFix?(error: BuildTimeValidationError): CodeFix[];
+}
+/**
+ * Context for validation operations
+ */
+export interface ValidationContext {
+    sourceFile: ts.SourceFile;
+    program: ts.Program;
+    checker: ts.TypeChecker;
+    fileName: string;
+    options: ValidationOptions;
+}
+/**
+ * Validation result from a rule
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors?: BuildTimeValidationError[];
+    warnings?: BuildTimeValidationWarning[];
+    suggestions?: CodeFix[];
+}
+/**
+ * Build-time validation error details
+ */
+export interface BuildTimeValidationError {
+    message: string;
+    code: string;
+    severity: 'error' | 'warning' | 'info';
+    line: number;
+    column: number;
+    length: number;
+    category: string;
+    component?: string;
+    suggestion?: string;
+    documentationLink?: string;
+    fix?: CodeFix;
+}
+/**
+ * Build-time validation warning details
+ */
+export interface BuildTimeValidationWarning extends Omit<BuildTimeValidationError, 'severity'> {
+    severity: 'warning';
+}
+/**
+ * Code fix suggestion
+ */
+export interface CodeFix {
+    description: string;
+    changes: TextChange[];
+}
+/**
+ * Text change for code fixes
+ */
+export interface TextChange {
+    span: {
+        start: number;
+        length: number;
+    };
+    newText: string;
+}
+/**
+ * Build tool detection and integration
+ */
+export interface BuildToolInfo {
+    name: string;
+    version?: string;
+    configFile?: string;
+    detected: boolean;
+    supported: boolean;
+}
+/**
+ * Validation options for build-time checking
+ */
+export interface ValidationOptions {
+    enabled: boolean;
+    strictMode: boolean;
+    errorLevel: 'error' | 'warn' | 'info';
+    excludeFiles: string[];
+    includeFiles?: string[];
+    customRules: BuildTimeValidationRule[];
+    buildTool?: string;
+    configFile?: string;
+}
+/**
+ * Plugin configuration for different build tools
+ */
+export interface PluginConfig {
+    vite?: VitePluginOptions;
+    webpack?: WebpackPluginOptions;
+    nextjs?: NextJSPluginOptions;
+    typescript?: TypeScriptPluginOptions;
+}
+/**
+ * Vite plugin options
+ */
+export interface VitePluginOptions {
+    include?: string[];
+    exclude?: string[];
+    enforce?: 'pre' | 'post';
+    apply?: 'build' | 'serve' | ((config: any, env: any) => boolean);
+}
+/**
+ * Webpack plugin options
+ */
+export interface WebpackPluginOptions {
+    test?: RegExp;
+    include?: RegExp | string[];
+    exclude?: RegExp | string[];
+    options?: Record<string, any>;
+}
+/**
+ * Next.js plugin options
+ */
+export interface NextJSPluginOptions {
+    webpack?: WebpackPluginOptions;
+    babel?: BabelPluginOptions;
+    swc?: SWCPluginOptions;
+}
+/**
+ * TypeScript plugin options
+ */
+export interface TypeScriptPluginOptions {
+    transformers?: {
+        before?: ts.TransformerFactory<ts.SourceFile>[];
+        after?: ts.TransformerFactory<ts.SourceFile>[];
+        afterDeclarations?: ts.TransformerFactory<ts.SourceFile>[];
+    };
+}
+/**
+ * Babel plugin options
+ */
+export interface BabelPluginOptions {
+    include?: string[];
+    exclude?: string[];
+    presets?: any[];
+    plugins?: any[];
+}
+/**
+ * SWC plugin options
+ */
+export interface SWCPluginOptions {
+    test?: RegExp;
+    options?: Record<string, any>;
+}
+/**
+ * Build integration result
+ */
+export interface BuildIntegrationResult {
+    success: boolean;
+    buildTool: string;
+    message: string;
+    pluginRegistered: boolean;
+    configurationApplied: boolean;
+    errors?: string[];
+}
+/**
+ * Validation statistics for reporting
+ */
+export interface ValidationStats {
+    filesProcessed: number;
+    errorsFound: number;
+    warningsFound: number;
+    rulesApplied: number;
+    fixesApplied: number;
+    processingTime: number;
+}
+/**
+ * Component validation patterns
+ */
+export interface ComponentValidationPattern {
+    componentName: string;
+    requiredProps: string[];
+    optionalProps: string[];
+    validModifiers: string[];
+    invalidModifiers: string[];
+    examples: {
+        valid: string[];
+        invalid: string[];
+    };
+}
+/**
+ * Modifier validation patterns
+ */
+export interface ModifierValidationPattern {
+    modifierName: string;
+    validComponents: string[];
+    parameterTypes: {
+        [index: number]: string[];
+    };
+    noParameters?: boolean;
+    examples: {
+        valid: string[];
+        invalid: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/validation/build-time/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/validation/build-time/types.ts"],"names":[],"mappings":"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"}

package/dist/validation/comprehensive.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../reactive/cleanup.cjs");require("../reactive/unified-scheduler.cjs");const h=require("../reactive/signal.cjs");require("../reactive/scheduler.cjs");require("../reactive/theme.cjs");class o extends Error{constructor(t,n){super(t),this.context=n,this.name="TachUIValidationError"}getFormattedMessage(){const{component:t,suggestion:n,example:s,documentation:c,package:a}=this.context;let u=`❌ ${a?`[@tachui/${a}]`:"[Core]"} ${t} Component Error: ${this.message}
+`;return n&&(u+=`
+💡 Suggestion: ${n}
+`),s&&(u+=`
+❌ Wrong: ${s.wrong}`,u+=`
+✅ Correct: ${s.correct}
+`),c&&(u+=`
+📚 Documentation: ${c}`),u}}let r={enabled:process.env.NODE_ENV!=="production",strictMode:!1,errorLevel:"error",excludeFiles:[],packages:{core:!0,forms:!0,navigation:!0,symbols:!0,plugins:!0}};function d(e){r={...r,...e}}function i(){return r.enabled&&process.env.NODE_ENV!=="production"}const w={validateText(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Text component requires a content parameter",{component:"Text",suggestion:'Add a content parameter: Text("Hello World")',documentation:"https://docs.tachui.dev/components/text",example:{wrong:"Text()",correct:'Text("Hello World")'}});const[t]=e;if(t==null)throw new o("Text content cannot be undefined or null",{component:"Text",suggestion:"Provide a valid string, function, or Signal",example:{wrong:"Text(null)",correct:'Text("Hello World")'}});const n=typeof t;if(!(n==="string"||n==="function"||h.isSignal(t)))throw new o(`Text content must be a string, function, or Signal. Received: ${n}`,{component:"Text",suggestion:"Use a string literal, function, or reactive signal",example:{wrong:"Text(123)",correct:'Text("Hello World")'}})},validateButton(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Button component requires a title parameter",{component:"Button",suggestion:'Add a title parameter: Button("Click me", () => {})',documentation:"https://docs.tachui.dev/components/button",example:{wrong:"Button()",correct:'Button("Click me", () => {})'}});const[t,n]=e;if(t==null)throw new o("Button title cannot be undefined or null",{component:"Button",suggestion:"Provide a valid string, function, or Signal",example:{wrong:"Button(null)",correct:'Button("Click me")'}});const s=typeof t;if(!(s==="string"||s==="function"||h.isSignal(t)))throw new o(`Button title must be a string, function, or Signal. Received: ${s}`,{component:"Button",suggestion:"Use a string literal, function, or reactive signal",example:{wrong:"Button(123)",correct:'Button("Click me")'}});n===void 0&&e.length===1&&r.errorLevel!=="error"&&console.warn("⚠️ Button without action may not be interactive. Consider adding an action parameter.")},validateImage(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Image component requires a source parameter",{component:"Image",suggestion:'Add a source parameter: Image({ source: "image.jpg" })',documentation:"https://docs.tachui.dev/components/image",example:{wrong:"Image()",correct:'Image({ source: "image.jpg" })'}});const[t]=e;if(!t||typeof t!="object")throw new o("Image requires a props object",{component:"Image",suggestion:"Pass a props object with source property",example:{wrong:'Image("image.jpg")',correct:'Image({ source: "image.jpg" })'}});if(!t.source)throw new o("Image source property is required",{component:"Image",suggestion:"Provide a valid image source URL or path",example:{wrong:'Image({ alt: "description" })',correct:'Image({ source: "image.jpg", alt: "description" })'}})},validateToggle(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Toggle component requires an isOn parameter",{component:"Toggle",suggestion:"Add an isOn parameter: Toggle({ isOn: signal })",documentation:"https://docs.tachui.dev/components/toggle",example:{wrong:"Toggle()",correct:"Toggle({ isOn: isEnabled })"}});const[t]=e;if(!t||typeof t!="object")throw new o("Toggle requires a props object",{component:"Toggle",suggestion:"Pass a props object with isOn property",example:{wrong:"Toggle(true)",correct:"Toggle({ isOn: true })"}});if(t.isOn===void 0)throw new o("Toggle isOn property is required",{component:"Toggle",suggestion:"Provide a boolean value or Signal for isOn",example:{wrong:"Toggle({ onToggle: handler })",correct:"Toggle({ isOn: true, onToggle: handler })"}})},validateSlider(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Slider component requires a value parameter",{component:"Slider",suggestion:"Add a value parameter: Slider({ value: signal })",documentation:"https://docs.tachui.dev/components/slider",example:{wrong:"Slider()",correct:"Slider({ value: sliderValue })"}});const[t]=e;if(!t||typeof t!="object")throw new o("Slider requires a props object",{component:"Slider",suggestion:"Pass a props object with value property",example:{wrong:"Slider(50)",correct:"Slider({ value: 50 })"}});if(t.value===void 0)throw new o("Slider value property is required",{component:"Slider",suggestion:"Provide a numeric value or Signal for value",example:{wrong:"Slider({ min: 0, max: 100 })",correct:"Slider({ value: 50, min: 0, max: 100 })"}})},validatePicker(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Picker component requires options parameter",{component:"Picker",suggestion:'Add options parameter: Picker({ options: ["Option 1", "Option 2"] })',documentation:"https://docs.tachui.dev/components/picker",example:{wrong:"Picker()",correct:'Picker({ options: ["Red", "Green", "Blue"] })'}});const[t]=e;if(!t||typeof t!="object")throw new o("Picker requires a props object",{component:"Picker",suggestion:"Pass a props object with options array",example:{wrong:'Picker(["Option 1", "Option 2"])',correct:'Picker({ options: ["Option 1", "Option 2"] })'}});const n=t;if(!Array.isArray(n.options))throw new o("Picker options must be an array",{component:"Picker",suggestion:"Provide an array of options",example:{wrong:'Picker({ options: "Option 1" })',correct:'Picker({ options: ["Option 1", "Option 2"] })'}})},validateStack(e,t){if(!i()||!r.packages.core)return;if(t.length===0)throw new o(`${e} component requires a props object with children array`,{component:e,suggestion:`Add children: ${e}({ children: [Text("Hello")] })`,documentation:"https://docs.tachui.dev/components/layout",example:{wrong:`${e}()`,correct:`${e}({ children: [Text("Hello")] })`}});const[n]=t;if(!n||typeof n!="object")throw new o(`${e} requires a props object`,{component:e,suggestion:"Pass a props object with children array",example:{wrong:`${e}("invalid")`,correct:`${e}({ children: [Text("Hello")] })`}});const s=n;if(!Array.isArray(s.children))throw new o(`${e} children must be an array`,{component:e,suggestion:"Provide an array of components",example:{wrong:`${e}({ children: Text("Hello") })`,correct:`${e}({ children: [Text("Hello")] })`}})},validateList(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("List component requires a props object with data array",{component:"List",suggestion:"Add data: List({ data: items, renderItem: (item) => Text(item) })",documentation:"https://docs.tachui.dev/components/list",example:{wrong:"List()",correct:"List({ data: items, renderItem: (item) => Text(item) })"}});const[t]=e;if(!t||typeof t!="object")throw new o("List requires a props object",{component:"List",suggestion:"Pass a props object with data and renderItem",example:{wrong:"List(items)",correct:"List({ data: items, renderItem: (item) => Text(item) })"}});const n=t;if(!Array.isArray(n.data)&&!h.isSignal(n.data))throw new o("List data must be an array or Signal",{component:"List",suggestion:"Provide an array of items or reactive Signal",example:{wrong:'List({ data: "invalid", renderItem: fn })',correct:"List({ data: [1, 2, 3], renderItem: fn })"}});if(typeof n.renderItem!="function")throw new o("List renderItem must be a function",{component:"List",suggestion:"Provide a function that renders each item",example:{wrong:'List({ data: items, renderItem: "invalid" })',correct:"List({ data: items, renderItem: (item) => Text(item) })"}})},validateScrollView(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("ScrollView component requires a props object with children",{component:"ScrollView",suggestion:"Add children: ScrollView({ children: [content] })",documentation:"https://docs.tachui.dev/components/scrollview",example:{wrong:"ScrollView()",correct:"ScrollView({ children: [VStack({ children: items })] })"}});const[t]=e;if(!t||typeof t!="object")throw new o("ScrollView requires a props object",{component:"ScrollView",suggestion:"Pass a props object with children",example:{wrong:"ScrollView(content)",correct:"ScrollView({ children: [content] })"}})},validateAlert(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Alert component requires a props object with title",{component:"Alert",suggestion:'Add title: Alert({ title: "Warning", message: "Are you sure?" })',documentation:"https://docs.tachui.dev/components/alert",example:{wrong:"Alert()",correct:'Alert({ title: "Warning", message: "Continue?" })'}});const[t]=e;if(!t||typeof t!="object")throw new o("Alert requires a props object",{component:"Alert",suggestion:"Pass a props object with title and message",example:{wrong:'Alert("Warning")',correct:'Alert({ title: "Warning", message: "Continue?" })'}});if(!t.title)throw new o("Alert title property is required",{component:"Alert",suggestion:"Provide a title for the alert",example:{wrong:'Alert({ message: "Continue?" })',correct:'Alert({ title: "Warning", message: "Continue?" })'}})},validateMenu(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Menu component requires a props object with items",{component:"Menu",suggestion:'Add items: Menu({ items: [{ title: "Item 1", action: () => {} }] })',documentation:"https://docs.tachui.dev/components/menu",example:{wrong:"Menu()",correct:'Menu({ items: [{ title: "Edit", action: editAction }] })'}});const[t]=e;if(!t||typeof t!="object")throw new o("Menu requires a props object",{component:"Menu",suggestion:"Pass a props object with items array",example:{wrong:"Menu(items)",correct:"Menu({ items: menuItems })"}});const n=t;if(!Array.isArray(n.items))throw new o("Menu items must be an array",{component:"Menu",suggestion:"Provide an array of menu items",example:{wrong:'Menu({ items: "invalid" })',correct:'Menu({ items: [{ title: "Edit", action: editAction }] })'}})},validateDatePicker(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("DatePicker component requires a props object with value",{component:"DatePicker",suggestion:"Add value: DatePicker({ value: dateSignal })",documentation:"https://docs.tachui.dev/components/datepicker",example:{wrong:"DatePicker()",correct:'DatePicker({ value: dateSignal, displayStyle: "compact" })'}});const[t]=e;if(!t||typeof t!="object")throw new o("DatePicker requires a props object",{component:"DatePicker",suggestion:"Pass a props object with value property",example:{wrong:"DatePicker(new Date())",correct:"DatePicker({ value: dateSignal })"}});if(t.value===void 0)throw new o("DatePicker value property is required",{component:"DatePicker",suggestion:"Provide a Date value or Signal for value",example:{wrong:'DatePicker({ displayStyle: "compact" })',correct:'DatePicker({ value: dateSignal, displayStyle: "compact" })'}})},validateActionSheet(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("ActionSheet component requires a props object with buttons",{component:"ActionSheet",suggestion:'Add buttons: ActionSheet({ buttons: [{ title: "Action", action: () => {} }] })',documentation:"https://docs.tachui.dev/components/actionsheet",example:{wrong:"ActionSheet()",correct:'ActionSheet({ buttons: [{ title: "Delete", role: "destructive", action: deleteAction }] })'}});const[t]=e;if(!t||typeof t!="object")throw new o("ActionSheet requires a props object",{component:"ActionSheet",suggestion:"Pass a props object with buttons array",example:{wrong:"ActionSheet(buttons)",correct:"ActionSheet({ buttons: buttonsArray })"}});const n=t;if(!Array.isArray(n.buttons))throw new o("ActionSheet buttons must be an array",{component:"ActionSheet",suggestion:"Provide an array of button objects",example:{wrong:'ActionSheet({ buttons: { title: "Action" } })',correct:'ActionSheet({ buttons: [{ title: "Action", action: actionHandler }] })'}})},validateDivider(e){if(!(!i()||!r.packages.core)&&e.length>0){const[t]=e;if(t!==null&&typeof t!="object")throw new o("Divider props must be an object if provided",{component:"Divider",suggestion:"Pass an object or no arguments",example:{wrong:'Divider("invalid")',correct:"Divider() or Divider({ thickness: 2 })"}})}},validateSpacer(e){if(!(!i()||!r.packages.core)&&e.length>0){const[t]=e;if(t!=null&&typeof t!="object")throw new o("Spacer props must be an object if provided",{component:"Spacer",suggestion:"Pass an object with minLength property or no arguments",example:{wrong:"Spacer(20)",correct:"Spacer() or Spacer({ minLength: 20 })"}})}},validateSection(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Section component requires a props object with children",{component:"Section",suggestion:"Add children: Section({ children: [content] })",documentation:"https://docs.tachui.dev/components/section",example:{wrong:"Section()",correct:'Section({ children: [Text("Section content")] })'}});const[t]=e;if(!t||typeof t!="object")throw new o("Section requires a props object",{component:"Section",suggestion:"Pass a props object with children",example:{wrong:"Section(content)",correct:"Section({ children: [content] })"}})},validateShow(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Show component requires a props object with when condition",{component:"Show",suggestion:"Add when condition: Show({ when: condition, children: [content] })",documentation:"https://docs.tachui.dev/components/show",example:{wrong:"Show()",correct:'Show({ when: isVisible, children: [Text("Visible")] })'}});const[t]=e;if(!t||typeof t!="object")throw new o("Show requires a props object",{component:"Show",suggestion:"Pass a props object with when condition",example:{wrong:"Show(condition)",correct:"Show({ when: condition, children: [content] })"}});if(t.when===void 0)throw new o("Show when property is required",{component:"Show",suggestion:"Provide a boolean condition for when",example:{wrong:"Show({ children: [content] })",correct:"Show({ when: isVisible, children: [content] })"}})},validateLink(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Link component requires a props object with href",{component:"Link",suggestion:'Add href: Link({ href: "/path", children: [Text("Click here")] })',documentation:"https://docs.tachui.dev/components/link",example:{wrong:"Link()",correct:'Link({ href: "/about", children: [Text("About")] })'}});const[t]=e;if(!t||typeof t!="object")throw new o("Link requires a props object",{component:"Link",suggestion:"Pass a props object with href property",example:{wrong:'Link("/path")',correct:'Link({ href: "/path", children: [Text("Link")] })'}});if(!t.href)throw new o("Link href property is required",{component:"Link",suggestion:"Provide a valid URL or path for href",example:{wrong:'Link({ children: [Text("Link")] })',correct:'Link({ href: "/about", children: [Text("About")] })'}})},validateStepper(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("Stepper component requires a props object with value",{component:"Stepper",suggestion:"Add value: Stepper({ value: numberSignal })",documentation:"https://docs.tachui.dev/components/stepper",example:{wrong:"Stepper()",correct:"Stepper({ value: numberSignal, step: 1 })"}});const[t]=e;if(!t||typeof t!="object")throw new o("Stepper requires a props object",{component:"Stepper",suggestion:"Pass a props object with value property",example:{wrong:"Stepper(5)",correct:"Stepper({ value: 5, step: 1 })"}});if(t.value===void 0)throw new o("Stepper value property is required",{component:"Stepper",suggestion:"Provide a numeric value or Signal for value",example:{wrong:"Stepper({ step: 1 })",correct:"Stepper({ value: numberSignal, step: 1 })"}})},validateBasicInput(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("BasicInput component requires a props object with value",{component:"BasicInput",suggestion:"Add value: BasicInput({ value: textSignal })",documentation:"https://docs.tachui.dev/components/basicinput",example:{wrong:"BasicInput()",correct:'BasicInput({ value: textSignal, placeholder: "Enter text" })'}});const[t]=e;if(!t||typeof t!="object")throw new o("BasicInput requires a props object",{component:"BasicInput",suggestion:"Pass a props object with value property",example:{wrong:'BasicInput("text")',correct:"BasicInput({ value: textSignal })"}});if(t.value===void 0)throw new o("BasicInput value property is required",{component:"BasicInput",suggestion:"Provide a value for the input field",example:{wrong:'BasicInput({ placeholder: "Enter text" })',correct:'BasicInput({ value: textSignal, placeholder: "Enter text" })'}})},validateBasicForm(e){if(!i()||!r.packages.core)return;if(e.length===0)throw new o("BasicForm component requires children array",{component:"BasicForm",suggestion:"Add children: BasicForm([formFields])",documentation:"https://docs.tachui.dev/components/basicform",example:{wrong:"BasicForm()",correct:'BasicForm([BasicInput({}), Button("Submit")])'}});const[t,n]=e;if(!Array.isArray(t))throw new o("BasicForm requires children array as first parameter",{component:"BasicForm",suggestion:"Pass an array of form components as first parameter",example:{wrong:"BasicForm(BasicInput({}))",correct:"BasicForm([BasicInput({})])"}});if(n&&typeof n!="object")throw new o("BasicForm props must be an object",{component:"BasicForm",suggestion:"Pass props as second parameter object",example:{wrong:'BasicForm([], "invalid")',correct:"BasicForm([], { onSubmit: handleSubmit })"}})},validatePropsObject(e,t,n){if(t.length===0)throw new o(`${e} component requires a props object`,{component:e,suggestion:`Add props: ${e}({ /* props */ })`,documentation:n,example:{wrong:`${e}()`,correct:`${e}({ /* appropriate props */ })`}});const[s]=t;if(s!=null&&typeof s!="object")throw new o(`${e} requires a props object`,{component:e,suggestion:"Pass a props object",example:{wrong:`${e}("invalid")`,correct:`${e}({ /* props */ })`}})}},b={validatePluginComponent(e,t,n){if(!i()||!r.packages.plugins)return;const{getComponentValidator:s}=require("./plugin-registration"),c=s(e,t);if(c)try{c.validate(n)}catch(a){throw a instanceof o&&(a.context.package||(a.context.package=e)),a}else if(r.strictMode)throw new o(`No validator registered for ${t}`,{component:t,package:e,suggestion:"Ensure the plugin has registered its validator",documentation:"https://docs.tachui.dev/plugins/validation"})}},f={validateModifier(e,t,n,s=[]){if(!i()||e!=="core"&&!r.packages[e])return;const a={textShadow:{suggestion:"Use shadow() instead",example:'.shadow({ x: 2, y: 2, radius: 4, color: "rgba(0,0,0,0.25)" })'},id:{suggestion:'Use setAttribute("id", value) instead',example:'.setAttribute("id", "my-element")'},className:{suggestion:'Use css() or setAttribute("class", value) instead',example:'.css({ className: "my-class" })'},style:{suggestion:"Use css() for custom styles instead",example:'.css({ backgroundColor: "red" })'}}[n];if(a){const l=new o(`Modifier ${n} does not exist`,{component:t,package:e,suggestion:a.suggestion,example:a.example?{wrong:`.${n}()`,correct:a.example}:void 0});if(r.errorLevel==="error")throw l;console.warn(l.getFormattedMessage());return}if(new Set(["clipped","resizable"]).has(n)&&s.length>0){const l=new o(`${n}() takes no parameters`,{component:t,package:e,suggestion:`Use ${n}() without arguments`,example:{wrong:`.${n}(someValue)`,correct:`.${n}()`}});if(r.errorLevel==="error")throw l;console.warn(l.getFormattedMessage())}const u=new Set(["font","fontSize","fontWeight","textAlign","lineHeight","letterSpacing"]),g=new Set(["disabled","onTap","cursor"]);if(u.has(n)&&!["Text","Button"].includes(t)){const l=`${n} modifier is only valid for Text/Button components`;if(r.errorLevel==="error")throw new o(l,{component:t,package:e,suggestion:`Use ${n} modifier on Text or Button components only`});r.errorLevel==="warn"&&console.warn(`⚠️ [${e}] ${l}`)}if(g.has(n)&&!["Button","Toggle","Slider"].includes(t)){const l=`${n} modifier is only valid for interactive components`;r.errorLevel==="warn"&&console.warn(`⚠️ [${e}] ${l}`)}const{getComponentValidator:v}=require("./plugin-registration"),m=v(e,t);m&&m.validateModifier&&m.validateModifier(n,s)}},S={enable(e=!0){d({enabled:e})},enableStrictMode(){d({strictMode:!0}),console.info("🚨 TachUI Strict validation mode enabled")},setErrorLevel(e){d({errorLevel:e})},configurePackages(e){d({packages:{...r.packages,...e}})},test(){if(!i()){console.info("ℹ️ Validation is disabled in production mode");return}console.group("🔍 TachUI Comprehensive Validation System Test");try{console.info("✅ Core component validation: enabled"),console.info("✅ Plugin component validation: enabled"),console.info("✅ Modifier validation: enabled");const{getValidationStats:e}=require("./plugin-registration"),t=e();console.info(`✅ Registered plugin validators: ${t.totalValidators}`),console.info("✅ Comprehensive validation system is working correctly")}catch(e){console.error("❌ Validation test failed:",e)}console.groupEnd()},getStats(){const{getValidationStats:e}=require("./plugin-registration"),t=e();return{enabled:i(),config:r,coreComponents:Object.keys(w).filter(n=>n.startsWith("validate")).length,pluginValidators:t.totalValidators,packages:{core:r.packages.core,forms:r.packages.forms,navigation:r.packages.navigation,symbols:r.packages.symbols,plugins:r.packages.plugins},pluginStats:t.packages}}};function x(e,t,n,s="core"){return function(...a){t(a);const p=e.apply(this,a);return"modifier"in p&&typeof p.modifier=="object"?j(p,n,s):p}}function j(e,t,n){return i()?new Proxy(e,{get(s,c){const a=s[c];return c==="modifier"?k(a,t,n):a}}):e}function k(e,t,n){return e&&new Proxy(e,{get(s,c){const a=String(c),p=s[c];return a==="build"||a==="addModifier"||a==="responsive"?p:typeof p=="function"?function(...g){return f.validateModifier(n,t,a,g),p.apply(s,g)}:p}})}exports.CoreComponentValidation=w;exports.ModifierValidation=f;exports.PluginComponentValidation=b;exports.TachUIValidationError=o;exports.ValidationUtils=S;exports.configureValidation=d;exports.createValidatedComponent=x;exports.isValidationEnabled=i;
+//# sourceMappingURL=comprehensive.cjs.map