@shapeshift-labs/frontier-lang-compiler 0.2.0 → 0.2.2

package/bench/smoke.mjs

@@ -0,0 +1,25 @@
+import { performance } from 'node:perf_hooks';
+import { compileFrontierSource } from '../dist/index.js';
+
+const source = `
+module Bench @id("mod_bench")
+type TodoInput @id("type_input") {
+  title: Text
+}
+entity Todo @id("ent_todo") {
+  title @id("field_title"): Text
+}
+action addTodo @id("action_add") {
+  input TodoInput
+  writes field_title
+  returns Patch
+}
+`;
+
+const targets = ['typescript', 'javascript', 'rust', 'python', 'c'];
+const start = performance.now();
+let bytes = 0;
+for (let index = 0; index < 250; index += 1) {
+  bytes += compileFrontierSource(source, { target: targets[index % targets.length] }).output.length;
+}
+console.log(JSON.stringify({ compiles: 250, bytes, durationMs: Number((performance.now() - start).toFixed(2)) }));

package/benchmarks/package-bench.mjs

@@ -0,0 +1 @@
+import '../bench/smoke.mjs';

package/dist/index.d.ts

@@ -4,12 +4,14 @@ import type {
   CompileTarget,
   EvidenceRecord,
   FrontierLangDocument,
+  FrontierUniversalAstEnvelope,
   FrontierSourceLanguage,
   LanguageImportResult,
   NativeAstLossRecord,
   NativeAstNode,
   NativeAstRecord,
   NativeSourceNode,
+  SemanticIndexRecord,
   SemanticNode,
   SemanticPatchBundle
 } from '@shapeshift-labs/frontier-lang-kernel';
@@ -97,11 +99,16 @@ export interface ImportNativeSourceOptions {
   readonly patchId?: string;
   readonly author?: string;
   readonly target?: CompileTarget;
+  readonly semanticIndex?: SemanticIndexRecord;
+  readonly universalAstId?: string;
+  readonly universalAstMetadata?: Record<string, unknown>;
   readonly metadata?: Record<string, unknown>;
 }
 
 export type NativeSourceImportResult = LanguageImportResult & {
   readonly nativeSource: NativeSourceNode;
+  readonly semanticIndex?: SemanticIndexRecord;
+  readonly universalAst: FrontierUniversalAstEnvelope;
 };
 
 export declare const FrontierCompileTargets: readonly FrontierCompileTarget[];
@@ -112,4 +119,12 @@ export declare function projectFrontierAst(document: FrontierLangDocument, targe
 export declare function renderTargetAst(ast: FrontierTargetAst, target?: FrontierCompileOptions['target']): string;
 export declare function resolveCapabilityAdapters(document: FrontierLangDocument, target?: FrontierCompileOptions['target'], options?: { readonly platform?: string }): readonly CapabilityResolution[];
 export declare function importNativeSource(input: ImportNativeSourceOptions): NativeSourceImportResult;
+export declare function createUniversalAstFromDocument(document: FrontierLangDocument, input?: {
+  readonly id?: string;
+  readonly semanticIndex?: SemanticIndexRecord;
+  readonly evidence?: readonly EvidenceRecord[];
+  readonly metadata?: Record<string, unknown>;
+}): FrontierUniversalAstEnvelope;
+export declare function readUniversalAstJson(source: string): FrontierUniversalAstEnvelope;
+export declare function writeUniversalAstJson(envelope: FrontierUniversalAstEnvelope): string;
 export declare function emitForTarget(document: FrontierLangDocument, target?: FrontierCompileOptions['target'], options?: FrontierCompileEmitOptions): string;

package/dist/index.js

@@ -3,9 +3,12 @@ import {
   createImportResult,
   createNativeAstRecord,
   createPatch,
+  createUniversalAstEnvelope,
   hashDocumentBase,
   hashSemanticValue,
-  nativeSourceNode
+  nativeSourceNode,
+  stableUniversalAstJson,
+  validateUniversalAstEnvelope
 } from '@shapeshift-labs/frontier-lang-kernel';
 import { parseFrontierFile, parseFrontierSource } from '@shapeshift-labs/frontier-lang-parser';
 import { checkDocument } from '@shapeshift-labs/frontier-lang-checker';
@@ -202,6 +205,21 @@ export function importNativeSource(input) {
       semanticStatus: input.semanticStatus ?? (semanticNodes.length ? 'mapped' : 'native-only')
     }
   }];
+  const semanticIndex = input.semanticIndex;
+  const universalAst = createUniversalAstEnvelope({
+    id: input.universalAstId ?? `universal_ast_${importIdPart}`,
+    document,
+    nativeSources: [nativeSource],
+    semanticIndex,
+    losses,
+    evidence,
+    metadata: {
+      sourceLanguage: language,
+      sourcePath,
+      semanticStatus: input.semanticStatus ?? (semanticNodes.length ? 'mapped' : 'native-only'),
+      ...input.universalAstMetadata
+    }
+  });
   const patch = input.patch ?? createPatch({
     id: input.patchId ?? `patch_${importIdPart}_import`,
     author: input.author ?? '@shapeshift-labs/frontier-lang-compiler/importNativeSource',
@@ -212,7 +230,7 @@ export function importNativeSource(input) {
       touches: [{ id: node.id, access: node.kind === 'nativeSource' ? 'evidence' : 'schema' }]
     })),
     evidence,
-    metadata: { sourceLanguage: language, sourcePath }
+    metadata: { sourceLanguage: language, sourcePath, semanticIndexId: semanticIndex?.id, universalAstId: universalAst.id }
   });
   return {
     ...createImportResult({
@@ -222,10 +240,14 @@ export function importNativeSource(input) {
       document,
       patch,
       nativeAst,
+      semanticIndex,
+      universalAst,
       losses,
       evidence,
       metadata: {
         nativeSourceId: nativeSource.id,
+        semanticIndexId: semanticIndex?.id,
+        universalAstId: universalAst.id,
         semanticStatus: input.semanticStatus ?? (semanticNodes.length ? 'mapped' : 'native-only'),
         mappings: input.mappings ?? [],
         ...input.metadata
@@ -235,6 +257,33 @@ export function importNativeSource(input) {
   };
 }
 
+export function createUniversalAstFromDocument(document, input = {}) {
+  return createUniversalAstEnvelope({
+    id: input.id ?? `universal_ast_${idFragment(document.id)}`,
+    document,
+    semanticIndex: input.semanticIndex,
+    evidence: input.evidence ?? [],
+    metadata: input.metadata
+  });
+}
+
+export function readUniversalAstJson(source) {
+  const envelope = JSON.parse(source);
+  const issues = validateUniversalAstEnvelope(envelope);
+  if (issues.length > 0) {
+    throw new Error(`Invalid Frontier universal AST JSON: ${issues.join('; ')}`);
+  }
+  return envelope;
+}
+
+export function writeUniversalAstJson(envelope) {
+  const issues = validateUniversalAstEnvelope(envelope);
+  if (issues.length > 0) {
+    throw new Error(`Invalid Frontier universal AST envelope: ${issues.join('; ')}`);
+  }
+  return stableUniversalAstJson(envelope);
+}
+
 export function emitForTarget(document, target = 'typescript', options = {}) {
   return renderTargetAst(projectFrontierAst(document, target, options), target);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-lang-compiler",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Compiler facade for Frontier Lang source documents and language projection adapters.",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,11 +16,14 @@
     "dist",
     "examples",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "bench",
+    "benchmarks/package-bench.mjs"
   ],
   "scripts": {
     "build": "node scripts/build.mjs",
     "test": "npm run build && node test/smoke.mjs",
+    "typecheck": "node ./node_modules/typescript/bin/tsc --noEmit -p test/tsconfig.json",
     "fuzz": "npm run build && node fuzz/smoke.mjs",
     "bench": "npm run build && node bench/smoke.mjs",
     "prepare": "npm run build",
@@ -53,13 +56,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@shapeshift-labs/frontier-lang-kernel": "0.3.0",
-    "@shapeshift-labs/frontier-lang-parser": "0.3.0",
+    "@shapeshift-labs/frontier-lang-c": "0.2.0",
     "@shapeshift-labs/frontier-lang-checker": "0.3.0",
-    "@shapeshift-labs/frontier-lang-typescript": "0.3.0",
     "@shapeshift-labs/frontier-lang-javascript": "0.2.0",
-    "@shapeshift-labs/frontier-lang-rust": "0.2.0",
+    "@shapeshift-labs/frontier-lang-kernel": "0.3.1",
+    "@shapeshift-labs/frontier-lang-parser": "0.3.0",
     "@shapeshift-labs/frontier-lang-python": "0.2.0",
-    "@shapeshift-labs/frontier-lang-c": "0.2.0"
+    "@shapeshift-labs/frontier-lang-rust": "0.2.0",
+    "@shapeshift-labs/frontier-lang-typescript": "0.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
   }
 }