@lokascript/compilation-service 2.0.0

package/dist/index.d.cts

@@ -0,0 +1,168 @@
+import { I as InputFormat, S as SemanticJSON, D as Diagnostic, a as CompileResponse, B as BehaviorSpec, T as TriggerDiff, O as OperationDiff, A as AbstractOperation, b as TestRenderer, c as TestRenderOptions, G as GeneratedTest, d as ComponentRenderer, e as ComponentRenderOptions, f as GeneratedComponent } from './service-891L1MYk.cjs';
+export { w as AddClassOp, y as AppendContentOp, P as BlurOp, C as CompilationService, g as CompileRequest, m as ComponentRequest, n as ComponentResponse, J as DecrementOp, q as DiffInput, o as DiffRequest, p as DiffResponse, K as FetchOp, M as FocusOp, l as GeneratedTestOutput, H as HideOp, F as IncrementOp, Q as LogOp, N as NavigateOp, r as OperationChangeKind, R as RemoveClassOp, t as SemanticJSONValue, s as ServiceOptions, x as SetContentOp, E as SetVariableOp, z as ShowOp, u as TargetRef, j as TestRequest, k as TestResponse, v as ToggleClassOp, h as TranslateRequest, i as TranslateResponse, L as TriggerEventOp, V as ValidationResponse, W as WaitOp } from './service-891L1MYk.cjs';
+
+/**
+ * Input format detection.
+ *
+ * Determines whether input is natural language, explicit syntax, or LLM JSON.
+ */
+
+/**
+ * Detect the input format from a string.
+ */
+declare function detectFormat(input: string): InputFormat;
+
+/**
+ * LLM JSON input validation.
+ *
+ * Validates structured semantic JSON from LLM output and converts
+ * it to a SemanticNode compatible with the semantic package.
+ */
+
+/**
+ * Validate LLM JSON input structure.
+ * Returns diagnostics (empty = valid).
+ */
+declare function validateSemanticJSON(input: SemanticJSON): Diagnostic[];
+/**
+ * Convert validated SemanticJSON to a SemanticNode-compatible object.
+ *
+ * Returns a plain object matching the SemanticNode interface from
+ * @lokascript/semantic, using ReadonlyMap for roles.
+ */
+declare function jsonToSemanticNode(input: SemanticJSON): unknown;
+
+/**
+ * Semantic-keyed LRU cache.
+ *
+ * Caches compilation results keyed by canonical semantic representation.
+ * Different input languages that produce the same semantics hit the same cache.
+ */
+
+/**
+ * Simple LRU cache using Map insertion order.
+ */
+declare class SemanticCache {
+    private cache;
+    private readonly maxSize;
+    /** Cache hit/miss statistics */
+    hits: number;
+    misses: number;
+    constructor(maxSize?: number);
+    /**
+     * Get a cached response, or undefined if not cached.
+     */
+    get(key: string): CompileResponse | undefined;
+    /**
+     * Store a response in the cache.
+     */
+    set(key: string, value: CompileResponse): void;
+    /** Current cache size */
+    get size(): number;
+    /** Clear all entries */
+    clear(): void;
+}
+/**
+ * Generate a canonical cache key from a semantic node and compilation options.
+ *
+ * The key is based on semantic identity, not syntax — so the same behavior
+ * described in English, Japanese, or explicit syntax produces the same key.
+ */
+declare function generateCacheKey(node: unknown, options: {
+    optimization?: number;
+    target?: string;
+    minify?: boolean;
+}): string;
+
+/**
+ * Operation Extraction
+ *
+ * Converts a SemanticNode (from the parsing pipeline) into a BehaviorSpec
+ * containing abstract operations. This is the bridge between semantic roles
+ * and framework-agnostic behavior descriptions.
+ */
+
+/**
+ * Extract abstract operations from a semantic node.
+ *
+ * Handles event handlers (extracts trigger + recurses into body)
+ * and standalone commands.
+ */
+declare function extractOperations(node: unknown): BehaviorSpec;
+
+/**
+ * Semantic Diff Engine
+ *
+ * Compares two BehaviorSpecs at the abstract operation level.
+ * Uses LCS (longest common subsequence) for operation-level diffing
+ * and post-processes to detect reorderings.
+ */
+
+interface DiffResult {
+    identical: boolean;
+    trigger: TriggerDiff | null;
+    operations: OperationDiff[];
+    summary: string;
+}
+/**
+ * Compare two BehaviorSpecs and produce a structured diff.
+ */
+declare function diffBehaviors(a: BehaviorSpec, b: BehaviorSpec): DiffResult;
+/**
+ * Produce a deterministic string key for an AbstractOperation.
+ * Two operations with the same key are semantically identical.
+ */
+declare function canonicalizeOp(op: AbstractOperation): string;
+
+/**
+ * Playwright Test Renderer
+ *
+ * Generates complete Playwright test files from BehaviorSpecs.
+ * Each generated test creates an HTML fixture, triggers the behavior,
+ * and asserts the expected DOM changes.
+ */
+
+declare class PlaywrightRenderer implements TestRenderer {
+    readonly framework = "playwright";
+    render(spec: BehaviorSpec, options?: TestRenderOptions): GeneratedTest;
+}
+
+/**
+ * React Component Renderer
+ *
+ * Generates complete React functional components from BehaviorSpecs.
+ * Maps abstract operations to React hooks (useState, useRef, useCallback) and JSX.
+ */
+
+declare class ReactRenderer implements ComponentRenderer {
+    readonly framework = "react";
+    render(spec: BehaviorSpec, options?: ComponentRenderOptions): GeneratedComponent;
+}
+
+/**
+ * Vue 3 Component Renderer
+ *
+ * Generates Vue 3 Single File Components (SFC) with Composition API
+ * (<script setup>) from BehaviorSpecs.
+ * Maps abstract operations to Vue refs and template directives.
+ */
+
+declare class VueRenderer implements ComponentRenderer {
+    readonly framework = "vue";
+    render(spec: BehaviorSpec, options?: ComponentRenderOptions): GeneratedComponent;
+}
+
+/**
+ * Svelte 5 Component Renderer
+ *
+ * Generates Svelte 5 components with runes ($state, $derived, $effect)
+ * from BehaviorSpecs.
+ * Maps abstract operations to direct state mutation and Svelte template syntax.
+ */
+
+declare class SvelteRenderer implements ComponentRenderer {
+    readonly framework = "svelte";
+    render(spec: BehaviorSpec, options?: ComponentRenderOptions): GeneratedComponent;
+}
+
+export { AbstractOperation, BehaviorSpec, CompileResponse, ComponentRenderOptions, ComponentRenderer, Diagnostic, GeneratedComponent, GeneratedTest, InputFormat, OperationDiff, PlaywrightRenderer, ReactRenderer, SemanticCache, SemanticJSON, SvelteRenderer, TestRenderOptions, TestRenderer, TriggerDiff, VueRenderer, canonicalizeOp, detectFormat, diffBehaviors, extractOperations, generateCacheKey, jsonToSemanticNode, validateSemanticJSON };

package/dist/index.d.ts

@@ -0,0 +1,168 @@
+import { I as InputFormat, S as SemanticJSON, D as Diagnostic, a as CompileResponse, B as BehaviorSpec, T as TriggerDiff, O as OperationDiff, A as AbstractOperation, b as TestRenderer, c as TestRenderOptions, G as GeneratedTest, d as ComponentRenderer, e as ComponentRenderOptions, f as GeneratedComponent } from './service-891L1MYk.js';
+export { w as AddClassOp, y as AppendContentOp, P as BlurOp, C as CompilationService, g as CompileRequest, m as ComponentRequest, n as ComponentResponse, J as DecrementOp, q as DiffInput, o as DiffRequest, p as DiffResponse, K as FetchOp, M as FocusOp, l as GeneratedTestOutput, H as HideOp, F as IncrementOp, Q as LogOp, N as NavigateOp, r as OperationChangeKind, R as RemoveClassOp, t as SemanticJSONValue, s as ServiceOptions, x as SetContentOp, E as SetVariableOp, z as ShowOp, u as TargetRef, j as TestRequest, k as TestResponse, v as ToggleClassOp, h as TranslateRequest, i as TranslateResponse, L as TriggerEventOp, V as ValidationResponse, W as WaitOp } from './service-891L1MYk.js';
+
+/**
+ * Input format detection.
+ *
+ * Determines whether input is natural language, explicit syntax, or LLM JSON.
+ */
+
+/**
+ * Detect the input format from a string.
+ */
+declare function detectFormat(input: string): InputFormat;
+
+/**
+ * LLM JSON input validation.
+ *
+ * Validates structured semantic JSON from LLM output and converts
+ * it to a SemanticNode compatible with the semantic package.
+ */
+
+/**
+ * Validate LLM JSON input structure.
+ * Returns diagnostics (empty = valid).
+ */
+declare function validateSemanticJSON(input: SemanticJSON): Diagnostic[];
+/**
+ * Convert validated SemanticJSON to a SemanticNode-compatible object.
+ *
+ * Returns a plain object matching the SemanticNode interface from
+ * @lokascript/semantic, using ReadonlyMap for roles.
+ */
+declare function jsonToSemanticNode(input: SemanticJSON): unknown;
+
+/**
+ * Semantic-keyed LRU cache.
+ *
+ * Caches compilation results keyed by canonical semantic representation.
+ * Different input languages that produce the same semantics hit the same cache.
+ */
+
+/**
+ * Simple LRU cache using Map insertion order.
+ */
+declare class SemanticCache {
+    private cache;
+    private readonly maxSize;
+    /** Cache hit/miss statistics */
+    hits: number;
+    misses: number;
+    constructor(maxSize?: number);
+    /**
+     * Get a cached response, or undefined if not cached.
+     */
+    get(key: string): CompileResponse | undefined;
+    /**
+     * Store a response in the cache.
+     */
+    set(key: string, value: CompileResponse): void;
+    /** Current cache size */
+    get size(): number;
+    /** Clear all entries */
+    clear(): void;
+}
+/**
+ * Generate a canonical cache key from a semantic node and compilation options.
+ *
+ * The key is based on semantic identity, not syntax — so the same behavior
+ * described in English, Japanese, or explicit syntax produces the same key.
+ */
+declare function generateCacheKey(node: unknown, options: {
+    optimization?: number;
+    target?: string;
+    minify?: boolean;
+}): string;
+
+/**
+ * Operation Extraction
+ *
+ * Converts a SemanticNode (from the parsing pipeline) into a BehaviorSpec
+ * containing abstract operations. This is the bridge between semantic roles
+ * and framework-agnostic behavior descriptions.
+ */
+
+/**
+ * Extract abstract operations from a semantic node.
+ *
+ * Handles event handlers (extracts trigger + recurses into body)
+ * and standalone commands.
+ */
+declare function extractOperations(node: unknown): BehaviorSpec;
+
+/**
+ * Semantic Diff Engine
+ *
+ * Compares two BehaviorSpecs at the abstract operation level.
+ * Uses LCS (longest common subsequence) for operation-level diffing
+ * and post-processes to detect reorderings.
+ */
+
+interface DiffResult {
+    identical: boolean;
+    trigger: TriggerDiff | null;
+    operations: OperationDiff[];
+    summary: string;
+}
+/**
+ * Compare two BehaviorSpecs and produce a structured diff.
+ */
+declare function diffBehaviors(a: BehaviorSpec, b: BehaviorSpec): DiffResult;
+/**
+ * Produce a deterministic string key for an AbstractOperation.
+ * Two operations with the same key are semantically identical.
+ */
+declare function canonicalizeOp(op: AbstractOperation): string;
+
+/**
+ * Playwright Test Renderer
+ *
+ * Generates complete Playwright test files from BehaviorSpecs.
+ * Each generated test creates an HTML fixture, triggers the behavior,
+ * and asserts the expected DOM changes.
+ */
+
+declare class PlaywrightRenderer implements TestRenderer {
+    readonly framework = "playwright";
+    render(spec: BehaviorSpec, options?: TestRenderOptions): GeneratedTest;
+}
+
+/**
+ * React Component Renderer
+ *
+ * Generates complete React functional components from BehaviorSpecs.
+ * Maps abstract operations to React hooks (useState, useRef, useCallback) and JSX.
+ */
+
+declare class ReactRenderer implements ComponentRenderer {
+    readonly framework = "react";
+    render(spec: BehaviorSpec, options?: ComponentRenderOptions): GeneratedComponent;
+}
+
+/**
+ * Vue 3 Component Renderer
+ *
+ * Generates Vue 3 Single File Components (SFC) with Composition API
+ * (<script setup>) from BehaviorSpecs.
+ * Maps abstract operations to Vue refs and template directives.
+ */
+
+declare class VueRenderer implements ComponentRenderer {
+    readonly framework = "vue";
+    render(spec: BehaviorSpec, options?: ComponentRenderOptions): GeneratedComponent;
+}
+
+/**
+ * Svelte 5 Component Renderer
+ *
+ * Generates Svelte 5 components with runes ($state, $derived, $effect)
+ * from BehaviorSpecs.
+ * Maps abstract operations to direct state mutation and Svelte template syntax.
+ */
+
+declare class SvelteRenderer implements ComponentRenderer {
+    readonly framework = "svelte";
+    render(spec: BehaviorSpec, options?: ComponentRenderOptions): GeneratedComponent;
+}
+
+export { AbstractOperation, BehaviorSpec, CompileResponse, ComponentRenderOptions, ComponentRenderer, Diagnostic, GeneratedComponent, GeneratedTest, InputFormat, OperationDiff, PlaywrightRenderer, ReactRenderer, SemanticCache, SemanticJSON, SvelteRenderer, TestRenderOptions, TestRenderer, TriggerDiff, VueRenderer, canonicalizeOp, detectFormat, diffBehaviors, extractOperations, generateCacheKey, jsonToSemanticNode, validateSemanticJSON };

package/dist/index.js

@@ -0,0 +1,32 @@
+import {
+  CompilationService,
+  PlaywrightRenderer,
+  ReactRenderer,
+  SemanticCache,
+  SvelteRenderer,
+  VueRenderer,
+  canonicalizeOp,
+  detectFormat,
+  diffBehaviors,
+  extractOperations,
+  generateCacheKey,
+  jsonToSemanticNode,
+  validateSemanticJSON
+} from "./chunk-ODJIDVMN.js";
+import "./chunk-HMLY7DHA.js";
+export {
+  CompilationService,
+  PlaywrightRenderer,
+  ReactRenderer,
+  SemanticCache,
+  SvelteRenderer,
+  VueRenderer,
+  canonicalizeOp,
+  detectFormat,
+  diffBehaviors,
+  extractOperations,
+  generateCacheKey,
+  jsonToSemanticNode,
+  validateSemanticJSON
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/semantic-adapter-7HTMTO75-MFFBR7K3.js

@@ -0,0 +1,12 @@
+import {
+  SemanticParserAdapter,
+  convertSemanticASTToAOT,
+  createSemanticAdapter
+} from "./chunk-CY26COTT.js";
+import "./chunk-HMLY7DHA.js";
+export {
+  SemanticParserAdapter,
+  convertSemanticASTToAOT,
+  createSemanticAdapter
+};
+//# sourceMappingURL=semantic-adapter-7HTMTO75-MFFBR7K3.js.map

package/dist/semantic-adapter-7HTMTO75-MFFBR7K3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}