@lokascript/semantic 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokascript/semantic",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Semantic multilingual parser for hyperscript (23 languages)",
   "type": "module",
   "main": "dist/index.cjs",
@@ -13,6 +13,10 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
     "./browser": {
       "types": "./dist/index.d.ts",
       "default": "./dist/browser.global.js"

package/src/core.ts

@@ -0,0 +1,155 @@
+/**
+ * Core Entry Point (No Language Data)
+ *
+ * A minimal ESM entry point that exports core semantic analysis infrastructure
+ * without importing any language modules. Languages must be imported separately
+ * as side-effect imports that self-register with the registry.
+ *
+ * This enables tree-shaking for Vite/Rollup projects that only need specific
+ * languages rather than the full 25-language bundle.
+ *
+ * @example
+ * ```typescript
+ * // Import core infrastructure
+ * import { createSemanticAnalyzer, buildAST, isLanguageSupported } from '@lokascript/semantic/core';
+ *
+ * // Import only the languages you need (self-registering side effects)
+ * import '@lokascript/semantic/languages/en';
+ * import '@lokascript/semantic/languages/es';
+ *
+ * // Now use the analyzer
+ * const analyzer = createSemanticAnalyzer();
+ * const result = analyzer.analyze('toggle .active', 'en');
+ * ```
+ */
+
+// =============================================================================
+// Core Parser Bridge (SemanticAnalyzer)
+// =============================================================================
+
+export {
+  // Types
+  type SemanticAnalysisResult,
+  type SemanticAnalyzer,
+  type SemanticAnalyzerOptions,
+  // Implementation
+  SemanticAnalyzerImpl,
+  createSemanticAnalyzer,
+  // Thresholds
+  DEFAULT_CONFIDENCE_THRESHOLD,
+  HIGH_CONFIDENCE_THRESHOLD,
+  // Helpers
+  shouldUseSemanticResult,
+  rolesToCommandArgs,
+  // Cache types
+  type SemanticCacheConfig,
+  type CacheStats,
+} from './core-bridge';
+
+// =============================================================================
+// AST Builder
+// =============================================================================
+
+export {
+  // Main builder
+  ASTBuilder,
+  buildAST,
+  // Value converters
+  convertValue,
+  convertLiteral,
+  convertSelector,
+  convertReference,
+  convertPropertyPath,
+  convertExpression,
+  // Command mappers
+  getCommandMapper,
+  registerCommandMapper,
+  getRegisteredMappers,
+  // Types
+  type ASTNode,
+  type CommandNode,
+  type EventHandlerNode,
+  type ConditionalNode,
+  type CommandSequenceNode,
+  type BlockNode,
+  type ASTBuilderOptions,
+  type CommandMapper,
+  type CommandMapperResult,
+  type BuildASTResult,
+} from './ast-builder';
+
+// =============================================================================
+// Registry (Language Management)
+// =============================================================================
+
+export {
+  // Query functions
+  isLanguageSupported,
+  isLanguageRegistered,
+  getRegisteredLanguages,
+  getTokenizer,
+  tryGetProfile,
+  getProfile,
+  getPatternsForLanguage,
+  getPatternsForLanguageAndCommand,
+  // Registration functions (used by self-registering language modules)
+  registerLanguage,
+  registerPatterns,
+  setPatternGenerator,
+  // Profile utilities
+  mergeProfiles,
+} from './registry';
+
+// Re-export profile types from registry
+export type {
+  LanguageProfile,
+  WordOrder,
+  MarkingStrategy,
+  RoleMarker,
+  VerbConfig,
+  PossessiveConfig,
+  KeywordTranslation,
+  TokenizationConfig,
+} from './registry';
+
+// =============================================================================
+// Core Types
+// =============================================================================
+
+export type {
+  // Semantic types
+  ActionType,
+  SemanticRole,
+  SemanticValue,
+  SemanticNode,
+  CommandSemanticNode,
+  EventHandlerSemanticNode,
+  ConditionalSemanticNode,
+  CompoundSemanticNode,
+  LoopSemanticNode,
+  SemanticMetadata,
+  // Pattern types
+  LanguagePattern,
+  PatternMatchResult,
+  // Token types
+  LanguageToken,
+  TokenKind,
+  TokenStream,
+  LanguageTokenizer,
+} from './types';
+
+// Type helpers
+export {
+  createSelector,
+  createLiteral,
+  createReference,
+  createPropertyPath,
+  createCommandNode,
+  createEventHandler,
+} from './types';
+
+// =============================================================================
+// Cache
+// =============================================================================
+
+export { SemanticCache, semanticCache, createSemanticCache, withCache } from './cache';