@shapeshift-labs/frontier-lang-compiler 0.2.16 → 0.2.17

package/README.md

@@ -9,6 +9,18 @@ const result = compileFrontierSource(source, { target: 'typescript' });
 if (result.ok) console.log(result.output);
 ```
 
+Emit code with declaration-level source-map sidecars for semantic review and merge admission:
+
+```js
+import { emitForTargetWithSourceMap } from '@shapeshift-labs/frontier-lang-compiler';
+
+const { code, sourceMap, ast } = emitForTargetWithSourceMap(document, 'javascript', {
+  sourcePath: 'todo.frontier',
+  targetPath: 'todo.js',
+  semanticIndexId: 'semantic_index_todo'
+});
+```
+
 Resolve target-specific capability bindings without hardcoding one runtime into the source graph:
 
 ```js

package/dist/index.d.ts

@@ -21,11 +21,11 @@ import type {
   SourceSpan
 } from '@shapeshift-labs/frontier-lang-kernel';
 import type { Diagnostic } from '@shapeshift-labs/frontier-lang-checker';
-import type { EmitTypeScriptOptions, TypeScriptAstModule } from '@shapeshift-labs/frontier-lang-typescript';
-import type { EmitJavaScriptOptions, JavaScriptAstModule } from '@shapeshift-labs/frontier-lang-javascript';
-import type { EmitRustOptions, RustAstModule } from '@shapeshift-labs/frontier-lang-rust';
-import type { EmitPythonOptions, PythonAstModule } from '@shapeshift-labs/frontier-lang-python';
-import type { CAstHeader, EmitCHeaderOptions } from '@shapeshift-labs/frontier-lang-c';
+import type { EmitTypeScriptOptions, TypeScriptAstModule, TypeScriptDocumentSourceMapResult, TypeScriptGeneratedSourceMapResult } from '@shapeshift-labs/frontier-lang-typescript';
+import type { EmitJavaScriptOptions, EmitJavaScriptWithSourceMapResult, JavaScriptAstModule, JavaScriptSourceMapResult } from '@shapeshift-labs/frontier-lang-javascript';
+import type { EmitRustOptions, EmitRustWithSourceMapResult, RustAstModule, RustSourceMapResult } from '@shapeshift-labs/frontier-lang-rust';
+import type { EmitPythonOptions, EmitPythonWithSourceMapResult, PythonAstModule, PythonSourceMapResult } from '@shapeshift-labs/frontier-lang-python';
+import type { CAstHeader, CSourceMapResult, EmitCHeaderOptions, EmitCHeaderWithSourceMapResult } from '@shapeshift-labs/frontier-lang-c';
 
 export type FrontierCompileTarget = 'typescript' | 'javascript' | 'rust' | 'python' | 'c';
 
@@ -43,6 +43,20 @@ export type FrontierTargetAst =
   | PythonAstModule
   | CAstHeader;
 
+export type FrontierTargetSourceMapResult =
+  | TypeScriptGeneratedSourceMapResult
+  | JavaScriptSourceMapResult
+  | RustSourceMapResult
+  | PythonSourceMapResult
+  | CSourceMapResult;
+
+export type FrontierTargetDocumentSourceMapResult =
+  | TypeScriptDocumentSourceMapResult
+  | EmitJavaScriptWithSourceMapResult
+  | EmitRustWithSourceMapResult
+  | EmitPythonWithSourceMapResult
+  | EmitCHeaderWithSourceMapResult;
+
 export interface FrontierCompileOptions {
   readonly target?: FrontierCompileTarget | 'ts' | 'js' | 'rs' | 'py' | 'h';
   readonly fileName?: string;
@@ -1180,6 +1194,8 @@ export declare function compileFrontierSource(source: string, options?: Frontier
 export declare function compileFrontierDocument(document: FrontierLangDocument, options?: FrontierCompileOptions): FrontierCompileResult;
 export declare function projectFrontierAst(document: FrontierLangDocument, target?: FrontierCompileOptions['target'], options?: FrontierCompileEmitOptions): FrontierTargetAst;
 export declare function renderTargetAst(ast: FrontierTargetAst, target?: FrontierCompileOptions['target']): string;
+export declare function renderTargetAstWithSourceMap(ast: FrontierTargetAst, target?: FrontierCompileOptions['target'], options?: FrontierCompileEmitOptions): FrontierTargetSourceMapResult;
+export declare function emitForTargetWithSourceMap(document: FrontierLangDocument, target?: FrontierCompileOptions['target'], options?: FrontierCompileEmitOptions): FrontierTargetDocumentSourceMapResult;
 export declare function resolveCapabilityAdapters(document: FrontierLangDocument, target?: FrontierCompileOptions['target'], options?: { readonly platform?: string }): readonly CapabilityResolution[];
 export declare function summarizeNativeImportLosses(losses?: readonly NativeAstLossRecord[], options?: NativeImportLossSummaryOptions): NativeImportLossSummary;
 export declare function classifyNativeImportReadiness(losses?: readonly NativeAstLossRecord[], options?: NativeImportLossSummaryOptions): NativeImportReadinessClassification;

package/dist/index.js

@@ -15,11 +15,11 @@ import {
 } from '@shapeshift-labs/frontier-lang-kernel';
 import { parseFrontierFile, parseFrontierSource } from '@shapeshift-labs/frontier-lang-parser';
 import { checkDocument } from '@shapeshift-labs/frontier-lang-checker';
-import { renderTypeScriptAst, toTypeScriptAst } from '@shapeshift-labs/frontier-lang-typescript';
-import { renderJavaScriptAst, toJavaScriptAst } from '@shapeshift-labs/frontier-lang-javascript';
-import { renderRustAst, toRustAst } from '@shapeshift-labs/frontier-lang-rust';
-import { renderPythonAst, toPythonAst } from '@shapeshift-labs/frontier-lang-python';
-import { renderCAst, toCAst } from '@shapeshift-labs/frontier-lang-c';
+import { renderTypeScriptAst, renderTypeScriptAstWithSourceMap, toTypeScriptAst } from '@shapeshift-labs/frontier-lang-typescript';
+import { renderJavaScriptAst, renderJavaScriptAstWithSourceMap, toJavaScriptAst } from '@shapeshift-labs/frontier-lang-javascript';
+import { renderRustAst, renderRustAstWithSourceMap, toRustAst } from '@shapeshift-labs/frontier-lang-rust';
+import { renderPythonAst, renderPythonAstWithSourceMap, toPythonAst } from '@shapeshift-labs/frontier-lang-python';
+import { renderCAst, renderCAstWithSourceMap, toCAst } from '@shapeshift-labs/frontier-lang-c';
 
 export const FrontierCompileTargets = Object.freeze([
   'typescript',
@@ -45,6 +45,14 @@ const renderers = Object.freeze({
   c: renderCAst
 });
 
+const sourceMapRenderers = Object.freeze({
+  typescript: renderTypeScriptAstWithSourceMap,
+  javascript: renderJavaScriptAstWithSourceMap,
+  rust: renderRustAstWithSourceMap,
+  python: renderPythonAstWithSourceMap,
+  c: renderCAstWithSourceMap
+});
+
 const canonicalTargets = Object.freeze({
   ts: 'typescript',
   js: 'javascript',
@@ -256,6 +264,12 @@ export function renderTargetAst(ast, target = 'typescript') {
   return renderer(ast);
 }
 
+export function renderTargetAstWithSourceMap(ast, target = 'typescript', options = {}) {
+  const normalized = normalizeCompileTarget(target);
+  const renderer = sourceMapRenderers[normalized];
+  return renderer(ast, options);
+}
+
 export function resolveCapabilityAdapters(document, target = 'typescript', options = {}) {
   const normalized = normalizeCompileTarget(target);
   const platform = options.platform;
@@ -4567,6 +4581,16 @@ export function emitForTarget(document, target = 'typescript', options = {}) {
   return renderTargetAst(projectFrontierAst(document, target, options), target);
 }
 
+export function emitForTargetWithSourceMap(document, target = 'typescript', options = {}) {
+  const normalized = normalizeCompileTarget(target);
+  const ast = projectFrontierAst(document, normalized, options);
+  const result = renderTargetAstWithSourceMap(ast, normalized, {
+    sourceMapId: options.sourceMapId ?? `sourcemap_${idFragment(document.id)}_${normalized}`,
+    ...options
+  });
+  return { ...result, ast };
+}
+
 function createJavaScriptSyntaxImporterAdapter(options) {
   return {
     id: options.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-lang-compiler",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "description": "Compiler facade for Frontier Lang source documents and language projection adapters.",
   "type": "module",
   "main": "./dist/index.js",
@@ -56,13 +56,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@shapeshift-labs/frontier-lang-c": "0.2.4",
+    "@shapeshift-labs/frontier-lang-c": "0.2.5",
     "@shapeshift-labs/frontier-lang-checker": "0.3.4",
-    "@shapeshift-labs/frontier-lang-javascript": "0.2.4",
+    "@shapeshift-labs/frontier-lang-javascript": "0.2.5",
     "@shapeshift-labs/frontier-lang-kernel": "0.3.4",
     "@shapeshift-labs/frontier-lang-parser": "0.3.4",
-    "@shapeshift-labs/frontier-lang-python": "0.2.4",
-    "@shapeshift-labs/frontier-lang-rust": "0.2.4",
+    "@shapeshift-labs/frontier-lang-python": "0.2.5",
+    "@shapeshift-labs/frontier-lang-rust": "0.2.5",
     "@shapeshift-labs/frontier-lang-typescript": "0.3.5"
   },
   "devDependencies": {