@lokascript/semantic 1.0.0

package/src/browser-ja.ts

@@ -0,0 +1,162 @@
+/**
+ * Japanese Browser Bundle Entry Point
+ *
+ * Minimal single-language bundle.
+ * Estimated size: ~73 KB (~26 KB gzip)
+ *
+ * @example
+ * ```html
+ * <script src="hyperfixi-semantic.ja.global.js"></script>
+ * <script>
+ *   const ast = LokaScriptSemanticJa.parse('toggle .active', 'ja');
+ * </script>
+ * ```
+ */
+
+// =============================================================================
+// Register Languages: ja
+// =============================================================================
+
+import './languages/ja';
+
+// =============================================================================
+// Version
+// =============================================================================
+
+export const VERSION = '1.0.0-ja';
+
+// =============================================================================
+// Supported Languages
+// =============================================================================
+
+const SUPPORTED_LANGUAGES = ['ja'] as const;
+
+/**
+ * Get all supported languages in this bundle.
+ */
+export function getSupportedLanguages(): string[] {
+  return [...SUPPORTED_LANGUAGES];
+}
+
+/**
+ * Validate that a language is supported by this bundle.
+ */
+function validateLanguage(language: string): void {
+  if (language !== 'ja') {
+    throw new Error(`Language not supported in this bundle: ${language}. ` + `Supported: ja`);
+  }
+}
+
+// =============================================================================
+// Tokenizers (from registry)
+// =============================================================================
+
+export { getTokenizer, isLanguageSupported } from './registry';
+
+import type { LanguageToken } from './types';
+import { tokenize as tokenizeInternal } from './tokenizers';
+
+/**
+ * Tokenize input and return array of tokens (browser-friendly wrapper).
+ */
+export function tokenize(input: string, language: string): LanguageToken[] {
+  validateLanguage(language);
+  const stream = tokenizeInternal(input, language);
+  return [...stream.tokens];
+}
+
+// Re-export tokenizers
+export { japaneseTokenizer } from './tokenizers/japanese';
+
+// =============================================================================
+// Patterns (from registry - lazy generation)
+// =============================================================================
+
+import { getPatternsForLanguage as getPatternsFromRegistry } from './registry';
+import type { LanguagePattern, ActionType } from './types';
+
+/**
+ * Get all patterns for a language.
+ */
+export function getPatternsForLanguage(language: string): LanguagePattern[] {
+  validateLanguage(language);
+  return getPatternsFromRegistry(language);
+}
+
+/**
+ * Get patterns for a language and specific command.
+ */
+export function getPatternsForLanguageAndCommand(
+  language: string,
+  command: ActionType
+): LanguagePattern[] {
+  return getPatternsForLanguage(language)
+    .filter(p => p.command === command)
+    .sort((a, b) => b.priority - a.priority);
+}
+
+// =============================================================================
+// Language Profiles (from registry)
+// =============================================================================
+
+export { getProfile, tryGetProfile } from './registry';
+export { japaneseProfile } from './generators/language-profiles';
+
+// =============================================================================
+// Parsing
+// =============================================================================
+
+export { parse, canParse } from './parser';
+export { parseAny, parseExplicit, isExplicitSyntax } from './explicit';
+
+// =============================================================================
+// Rendering
+// =============================================================================
+
+export { render, renderExplicit, toExplicit, fromExplicit } from './explicit';
+
+// =============================================================================
+// AST Builder
+// =============================================================================
+
+export { buildAST, ASTBuilder, getCommandMapper, registerCommandMapper } from './ast-builder';
+
+// =============================================================================
+// Semantic Analyzer (for core parser integration)
+// =============================================================================
+
+export {
+  createSemanticAnalyzer,
+  SemanticAnalyzerImpl,
+  shouldUseSemanticResult,
+  DEFAULT_CONFIDENCE_THRESHOLD,
+  HIGH_CONFIDENCE_THRESHOLD,
+} from './core-bridge';
+
+export type { SemanticAnalyzer, SemanticAnalysisResult } from './core-bridge';
+
+// =============================================================================
+// Type Helpers
+// =============================================================================
+
+export {
+  createSelector,
+  createLiteral,
+  createReference,
+  createPropertyPath,
+  createCommandNode,
+  createEventHandler,
+} from './types';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type {
+  ActionType,
+  SemanticRole,
+  SemanticValue,
+  SemanticNode,
+  LanguageToken,
+  TokenStream,
+} from './types';

package/src/browser-ko.ts

@@ -0,0 +1,162 @@
+/**
+ * Korean Browser Bundle Entry Point
+ *
+ * Minimal single-language bundle.
+ * Estimated size: ~67 KB (~23 KB gzip)
+ *
+ * @example
+ * ```html
+ * <script src="lokascript-semantic.ko.global.js"></script>
+ * <script>
+ *   const ast = LokaScriptSemanticKo.parse('toggle .active', 'ko');
+ * </script>
+ * ```
+ */
+
+// =============================================================================
+// Register Languages: ko
+// =============================================================================
+
+import './languages/ko';
+
+// =============================================================================
+// Version
+// =============================================================================
+
+export const VERSION = '1.0.0-ko';
+
+// =============================================================================
+// Supported Languages
+// =============================================================================
+
+const SUPPORTED_LANGUAGES = ['ko'] as const;
+
+/**
+ * Get all supported languages in this bundle.
+ */
+export function getSupportedLanguages(): string[] {
+  return [...SUPPORTED_LANGUAGES];
+}
+
+/**
+ * Validate that a language is supported by this bundle.
+ */
+function validateLanguage(language: string): void {
+  if (language !== 'ko') {
+    throw new Error(`Language not supported in this bundle: ${language}. ` + `Supported: ko`);
+  }
+}
+
+// =============================================================================
+// Tokenizers (from registry)
+// =============================================================================
+
+export { getTokenizer, isLanguageSupported } from './registry';
+
+import type { LanguageToken } from './types';
+import { tokenize as tokenizeInternal } from './tokenizers';
+
+/**
+ * Tokenize input and return array of tokens (browser-friendly wrapper).
+ */
+export function tokenize(input: string, language: string): LanguageToken[] {
+  validateLanguage(language);
+  const stream = tokenizeInternal(input, language);
+  return [...stream.tokens];
+}
+
+// Re-export tokenizers
+export { koreanTokenizer } from './tokenizers/korean';
+
+// =============================================================================
+// Patterns (from registry - lazy generation)
+// =============================================================================
+
+import { getPatternsForLanguage as getPatternsFromRegistry } from './registry';
+import type { LanguagePattern, ActionType } from './types';
+
+/**
+ * Get all patterns for a language.
+ */
+export function getPatternsForLanguage(language: string): LanguagePattern[] {
+  validateLanguage(language);
+  return getPatternsFromRegistry(language);
+}
+
+/**
+ * Get patterns for a language and specific command.
+ */
+export function getPatternsForLanguageAndCommand(
+  language: string,
+  command: ActionType
+): LanguagePattern[] {
+  return getPatternsForLanguage(language)
+    .filter(p => p.command === command)
+    .sort((a, b) => b.priority - a.priority);
+}
+
+// =============================================================================
+// Language Profiles (from registry)
+// =============================================================================
+
+export { getProfile, tryGetProfile } from './registry';
+export { koreanProfile } from './generators/language-profiles';
+
+// =============================================================================
+// Parsing
+// =============================================================================
+
+export { parse, canParse } from './parser';
+export { parseAny, parseExplicit, isExplicitSyntax } from './explicit';
+
+// =============================================================================
+// Rendering
+// =============================================================================
+
+export { render, renderExplicit, toExplicit, fromExplicit } from './explicit';
+
+// =============================================================================
+// AST Builder
+// =============================================================================
+
+export { buildAST, ASTBuilder, getCommandMapper, registerCommandMapper } from './ast-builder';
+
+// =============================================================================
+// Semantic Analyzer (for core parser integration)
+// =============================================================================
+
+export {
+  createSemanticAnalyzer,
+  SemanticAnalyzerImpl,
+  shouldUseSemanticResult,
+  DEFAULT_CONFIDENCE_THRESHOLD,
+  HIGH_CONFIDENCE_THRESHOLD,
+} from './core-bridge';
+
+export type { SemanticAnalyzer, SemanticAnalysisResult } from './core-bridge';
+
+// =============================================================================
+// Type Helpers
+// =============================================================================
+
+export {
+  createSelector,
+  createLiteral,
+  createReference,
+  createPropertyPath,
+  createCommandNode,
+  createEventHandler,
+} from './types';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type {
+  ActionType,
+  SemanticRole,
+  SemanticValue,
+  SemanticNode,
+  LanguageToken,
+  TokenStream,
+} from './types';

package/src/browser-lazy.ts

@@ -0,0 +1,189 @@
+/**
+ * Lazy Loading Browser Bundle Entry Point
+ *
+ * A minimal browser bundle that registers NO languages by default.
+ * Languages are loaded on-demand using the loadLanguage() function.
+ *
+ * This is ideal for applications that:
+ * - Need to minimize initial bundle size
+ * - Load languages based on user locale
+ * - Support multiple languages but don't need all upfront
+ *
+ * @example
+ * ```html
+ * <script src="hyperfixi-semantic.lazy.global.js"></script>
+ * <script>
+ *   // Load only the languages you need
+ *   await LokaScriptSemanticLazy.loadLanguage('en');
+ *   await LokaScriptSemanticLazy.loadLanguage('ja');
+ *
+ *   // Now parsing works for loaded languages
+ *   const ast = LokaScriptSemanticLazy.parse('toggle .active', 'en');
+ * </script>
+ * ```
+ */
+
+// =============================================================================
+// Version
+// =============================================================================
+
+export const VERSION = '1.0.0-lazy';
+
+// =============================================================================
+// Language Loader (Core Feature)
+// =============================================================================
+
+export {
+  loadLanguage,
+  loadLanguages,
+  canLoadLanguage,
+  getLoadedLanguages,
+  getUnloadedLanguages,
+  SUPPORTED_LANGUAGES,
+  type LoadLanguageOptions,
+  type LoadLanguageResult,
+  type LanguageModule,
+} from './language-loader';
+
+// =============================================================================
+// Registry (For checking loaded languages)
+// =============================================================================
+
+export {
+  getTokenizer,
+  isLanguageSupported,
+  isLanguageRegistered,
+  getRegisteredLanguages,
+  getProfile,
+  tryGetProfile,
+} from './registry';
+
+// =============================================================================
+// Tokenizers
+// =============================================================================
+
+import type { LanguageToken } from './types';
+import { tokenize as tokenizeInternal } from './tokenizers';
+import { isLanguageRegistered } from './registry';
+
+/**
+ * Tokenize input and return array of tokens.
+ * @throws Error if language is not loaded
+ */
+export function tokenize(input: string, language: string): LanguageToken[] {
+  if (!isLanguageRegistered(language)) {
+    throw new Error(
+      `Language '${language}' is not loaded. ` + `Call loadLanguage('${language}') first.`
+    );
+  }
+  const stream = tokenizeInternal(input, language);
+  return [...stream.tokens];
+}
+
+// =============================================================================
+// Patterns (from registry)
+// =============================================================================
+
+import { getPatternsForLanguage as getPatternsFromRegistry } from './registry';
+import type { LanguagePattern, ActionType } from './types';
+
+/**
+ * Get all patterns for a language.
+ * @throws Error if language is not loaded
+ */
+export function getPatternsForLanguage(language: string): LanguagePattern[] {
+  if (!isLanguageRegistered(language)) {
+    throw new Error(
+      `Language '${language}' is not loaded. ` + `Call loadLanguage('${language}') first.`
+    );
+  }
+  return getPatternsFromRegistry(language);
+}
+
+/**
+ * Get patterns for a language and specific command.
+ */
+export function getPatternsForLanguageAndCommand(
+  language: string,
+  command: ActionType
+): LanguagePattern[] {
+  return getPatternsForLanguage(language)
+    .filter(p => p.command === command)
+    .sort((a, b) => b.priority - a.priority);
+}
+
+// =============================================================================
+// Parsing
+// =============================================================================
+
+export { parse, canParse } from './parser';
+export { parseAny, parseExplicit, isExplicitSyntax } from './explicit';
+
+// =============================================================================
+// Rendering
+// =============================================================================
+
+export { render, renderExplicit, toExplicit, fromExplicit } from './explicit';
+
+// =============================================================================
+// AST Builder
+// =============================================================================
+
+export { buildAST, ASTBuilder, getCommandMapper, registerCommandMapper } from './ast-builder';
+
+// =============================================================================
+// Semantic Analyzer (for core parser integration)
+// =============================================================================
+
+export {
+  createSemanticAnalyzer,
+  SemanticAnalyzerImpl,
+  shouldUseSemanticResult,
+  DEFAULT_CONFIDENCE_THRESHOLD,
+  HIGH_CONFIDENCE_THRESHOLD,
+} from './core-bridge';
+
+export type { SemanticAnalyzer, SemanticAnalysisResult } from './core-bridge';
+
+// =============================================================================
+// Type Helpers
+// =============================================================================
+
+export {
+  createSelector,
+  createLiteral,
+  createReference,
+  createPropertyPath,
+  createCommandNode,
+  createEventHandler,
+} from './types';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type {
+  ActionType,
+  SemanticRole,
+  SemanticValue,
+  SemanticNode,
+  LanguageToken,
+  TokenStream,
+} from './types';
+
+// =============================================================================
+// Pattern Generator Setup
+// =============================================================================
+
+// Set up the pattern generator so that lazy-loaded languages work correctly.
+// This enables the registry's getPatternsForLanguage to generate patterns
+// when a language is loaded.
+import { setPatternGenerator } from './registry';
+import { buildPatternsForLanguage } from './patterns/builders';
+import type { LanguageProfile } from './generators/language-profiles';
+
+function patternGeneratorForProfile(profile: LanguageProfile): LanguagePattern[] {
+  return buildPatternsForLanguage(profile.code);
+}
+
+setPatternGenerator(patternGeneratorForProfile);