tjs-lang 0.2.7 → 0.2.8

package/dist/src/lang/emitters/js.d.ts

@@ -17,6 +17,33 @@
  *     params: { name: { type: 'string', required: true, example: 'world' } },
  *     returns: { type: 'string' }
  *   }
+ *
+ * TODO: Self-contained output (no runtime dependency)
+ * =====================================================
+ * Currently, transpiled code references `globalThis.__tjs` for:
+ *   - __tjs.pushStack() / popStack() - debug stack traces
+ *   - __tjs.typeError() - monadic error creation
+ *   - __tjs.Is() / IsNot() - structural equality (when == / != used)
+ *
+ * This requires either:
+ *   1. The runtime to be installed via installRuntime()
+ *   2. A stub to be provided (e.g., playground's inline stub)
+ *
+ * The ideal is that TJS produces completely independent code that only needs
+ * things it semantically needs (like fetch for HTTP calls). The runtime
+ * functions above are ~30 lines and could be inlined when used:
+ *
+ *   - typeError: Create a simple Error with extra properties
+ *   - pushStack/popStack: Could be no-ops in production, or inline array ops
+ *   - Is/IsNot: ~20 lines for deep structural equality
+ *
+ * Options to explore:
+ *   1. Inline minimal runtime when needed (adds ~1KB unminified per output)
+ *   2. Add transpile option: { standalone: true } to emit self-contained code
+ *   3. Tree-shake: only inline the specific functions actually referenced
+ *
+ * See also: demo/src/tjs-playground.ts which has a manual __tjs stub that
+ * must stay in sync with the runtime - a symptom of this leaky abstraction.
  */
 import type { TypeDescriptor, ParameterDescriptor } from '../types';
 export interface TJSTranspileOptions {
@@ -77,8 +104,13 @@ export interface TJSTranspileResult {
     testCount?: number;
     /** Test results (when runTests is true or 'only') */
     testResults?: TestResult[];
-    /** WASM blocks extracted from source (need to be compiled before execution) */
-    wasmBlocks?: import('../parser').WasmBlock[];
+    /** WASM compilation results (for debugging/inspection) */
+    wasmCompiled?: {
+        id: string;
+        success: boolean;
+        error?: string;
+        byteLength?: number;
+    }[];
 }
 export interface TJSTypeInfo {
     /** Function name */

package/dist/src/lang/index.d.ts

@@ -34,7 +34,7 @@ export { lint, type LintResult, type LintDiagnostic, type LintOptions, } from '.
 export { generateDocs, generateDocsMarkdown, type DocResult, type DocItem, type FunctionTypeInfo, type ParamTypeInfo, } from './docs';
 export { extractTests, assertFunction, expectFunction, testUtils, type ExtractedTest, type ExtractedMock, type TestExtractionResult, } from './tests';
 export { runtime, installRuntime, isError, error, typeOf, checkType, validateArgs, wrap, emitRuntimeWrapper, TJS_VERSION, type TJSError, } from './runtime';
-export { compileToWasm, instantiateWasm, registerWasmBlock, compileWasmBlocks, compileWasmBlocksForIframe, generateWasmInstantiationCode, type WasmCompileResult, type CompiledWasmData, } from './wasm';
+export { compileToWasm, instantiateWasm, registerWasmBlock, compileWasmBlocks, type WasmCompileResult, } from './wasm';
 export type { WasmBlock } from './parser';
 export { Eval, SafeFunction, type EvalOptions, type SafeFunctionOptions, } from './eval';
 export { hashSource, hashSourceSync, type CacheEntry, type CachedTranspileResult, type CachedTJSResult, type CacheStats, } from './metadata-cache';