yeptris 0.0.0-stage → 0.6.54

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 leptris contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,51 @@
-# Temporary Holding Version
+# yeptris
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+YAML for JavaScript at [libyeptris](https://github.com/leptris/yeptris)
+speed — the engine compiled to WebAssembly (ES module, no fallback).
+
+Part of the yeptris program: *the best (multiple dimensions)
+YAML/JSON parser/builder ever* — conformance, performance,
+safety/hardening, API surfaces, transport correctness, and trust,
+held simultaneously, in C, Ruby, Rust, and JS. This binding is the
+thinnest surface (the WASM module); the recorder bulk-drain and
+iterparse are planned next (the engine's PLAN.md, "The best-ever
+program").
+
+```js
+import { load, dump } from "yeptris";
+
+const doc = await load("name: yeptris\nlangs:\n- c\n- rust\n");
+// { name: "yeptris", langs: ["c", "rust"] }
+
+const yaml = await dump({ name: "yeptris", langs: ["c", "rust"] });
+// the engine's canonical, byte-stable YAML
+```
+
+- `load(yaml)` — parse to a JavaScript value (malformed input throws
+  `YamlError` with line/column).
+- `loadJSON(yaml)` — the engine's canonical JSON string.
+- `dump(json)` — JSON text (or any JSON-serializable value) to
+  canonical YAML; JSON is a subset of YAML 1.2 flow, so the one parse
+  engine takes it.
+
+The same model as [teptris-wasm](https://github.com/leptris/teptris-wasm):
+a contained C bridge (`src/yeptris_wasm.c`) over the engine's
+buffer-lifetime contract, compiled by `build.sh` (emcc) from the
+sibling engine checkout, surfaced as an ES module.
+
+## Build and test
+
+```sh
+./build.sh            # ENGINESRC=../yeptris/src by default
+node --test test/test.mjs
+```
+
+CI builds the engine tag and runs the same on every push and PR.
+
+## Releasing
+
+`npm publish` runs through the dispatch-only workflow (Trusted
+Publishing — configure `leptris/yeptris-ts` + `release.yml` as the
+package's publisher on npmjs). The first publish is manual; after
+that, dispatch **Release** and the dist build + publish + GitHub
+release run as one train.

package/dist/yeptris.mjs

@@ -0,0 +1,16 @@
+
+var Module = (() => {
+  var _scriptDir = import.meta.url;
+  
+  return (
+async function(moduleArg = {}) {
+
+var Module=moduleArg;var readyPromiseResolve,readyPromiseReject;Module["ready"]=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject});var moduleOverrides=Object.assign({},Module);var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};var ENVIRONMENT_IS_WEB=typeof window=="object";var ENVIRONMENT_IS_WORKER=typeof importScripts=="function";var ENVIRONMENT_IS_NODE=typeof process=="object"&&typeof process.versions=="object"&&typeof process.versions.node=="string";var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var read_,readAsync,readBinary;if(ENVIRONMENT_IS_NODE){const{createRequire:createRequire}=await import("module");var require=createRequire(import.meta.url);var fs=require("fs");var nodePath=require("path");if(ENVIRONMENT_IS_WORKER){scriptDirectory=nodePath.dirname(scriptDirectory)+"/"}else{scriptDirectory=require("url").fileURLToPath(new URL("./",import.meta.url))}read_=(filename,binary)=>{filename=isFileURI(filename)?new URL(filename):nodePath.normalize(filename);return fs.readFileSync(filename,binary?undefined:"utf8")};readBinary=filename=>{var ret=read_(filename,true);if(!ret.buffer){ret=new Uint8Array(ret)}return ret};readAsync=(filename,onload,onerror,binary=true)=>{filename=isFileURI(filename)?new URL(filename):nodePath.normalize(filename);fs.readFile(filename,binary?undefined:"utf8",(err,data)=>{if(err)onerror(err);else onload(binary?data.buffer:data)})};if(!Module["thisProgram"]&&process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow};Module["inspect"]=()=>"[Emscripten Module object]"}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){if(ENVIRONMENT_IS_WORKER){scriptDirectory=self.location.href}else if(typeof document!="undefined"&&document.currentScript){scriptDirectory=document.currentScript.src}if(_scriptDir){scriptDirectory=_scriptDir}if(scriptDirectory.indexOf("blob:")!==0){scriptDirectory=scriptDirectory.substr(0,scriptDirectory.replace(/[?#].*/,"").lastIndexOf("/")+1)}else{scriptDirectory=""}{read_=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.send(null);return xhr.responseText};if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=(url,onload,onerror)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){onload(xhr.response);return}onerror()};xhr.onerror=onerror;xhr.send(null)}}}else{}var out=Module["print"]||console.log.bind(console);var err=Module["printErr"]||console.error.bind(console);Object.assign(Module,moduleOverrides);moduleOverrides=null;if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["quit"])quit_=Module["quit"];var wasmBinary;if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(typeof WebAssembly!="object"){abort("no native wasm support detected")}var wasmMemory;var ABORT=false;var EXITSTATUS;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAP64,HEAPU64,HEAPF64;function updateMemoryViews(){var b=wasmMemory.buffer;Module["HEAP8"]=HEAP8=new Int8Array(b);Module["HEAP16"]=HEAP16=new Int16Array(b);Module["HEAPU8"]=HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);Module["HEAP32"]=HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);Module["HEAPF64"]=HEAPF64=new Float64Array(b);Module["HEAP64"]=HEAP64=new BigInt64Array(b);Module["HEAPU64"]=HEAPU64=new BigUint64Array(b)}var __ATPRERUN__=[];var __ATINIT__=[];var __ATPOSTRUN__=[];var runtimeInitialized=false;function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(__ATPRERUN__)}function initRuntime(){runtimeInitialized=true;callRuntimeCallbacks(__ATINIT__)}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(__ATPOSTRUN__)}function addOnPreRun(cb){__ATPRERUN__.unshift(cb)}function addOnInit(cb){__ATINIT__.unshift(cb)}function addOnPostRun(cb){__ATPOSTRUN__.unshift(cb)}var runDependencies=0;var runDependencyWatcher=null;var dependenciesFulfilled=null;function addRunDependency(id){runDependencies++;if(Module["monitorRunDependencies"]){Module["monitorRunDependencies"](runDependencies)}}function removeRunDependency(id){runDependencies--;if(Module["monitorRunDependencies"]){Module["monitorRunDependencies"](runDependencies)}if(runDependencies==0){if(runDependencyWatcher!==null){clearInterval(runDependencyWatcher);runDependencyWatcher=null}if(dependenciesFulfilled){var callback=dependenciesFulfilled;dependenciesFulfilled=null;callback()}}}function abort(what){if(Module["onAbort"]){Module["onAbort"](what)}what="Aborted("+what+")";err(what);ABORT=true;EXITSTATUS=1;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject(e);throw e}var dataURIPrefix="data:application/octet-stream;base64,";var isDataURI=filename=>filename.startsWith(dataURIPrefix);var isFileURI=filename=>filename.startsWith("file://");var wasmBinaryFile;if(Module["locateFile"]){wasmBinaryFile="yeptris.wasm";if(!isDataURI(wasmBinaryFile)){wasmBinaryFile=locateFile(wasmBinaryFile)}}else{wasmBinaryFile=new URL("yeptris.wasm",import.meta.url).href}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}function getBinaryPromise(binaryFile){if(!wasmBinary&&(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER)){if(typeof fetch=="function"){return fetch(binaryFile,{credentials:"same-origin"}).then(response=>{if(!response["ok"]){throw"failed to load wasm binary file at '"+binaryFile+"'"}return response["arrayBuffer"]()}).catch(()=>getBinarySync(binaryFile))}}return Promise.resolve().then(()=>getBinarySync(binaryFile))}function instantiateArrayBuffer(binaryFile,imports,receiver){return getBinaryPromise(binaryFile).then(binary=>WebAssembly.instantiate(binary,imports)).then(instance=>instance).then(receiver,reason=>{err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)})}function instantiateAsync(binary,binaryFile,imports,callback){if(!binary&&typeof WebAssembly.instantiateStreaming=="function"&&!isDataURI(binaryFile)&&!ENVIRONMENT_IS_NODE&&typeof fetch=="function"){return fetch(binaryFile,{credentials:"same-origin"}).then(response=>{var result=WebAssembly.instantiateStreaming(response,imports);return result.then(callback,function(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation");return instantiateArrayBuffer(binaryFile,imports,callback)})})}return instantiateArrayBuffer(binaryFile,imports,callback)}function createWasm(){var info={"a":wasmImports};function receiveInstance(instance,module){wasmExports=instance.exports;wasmMemory=wasmExports["g"];updateMemoryViews();addOnInit(wasmExports["h"]);removeRunDependency("wasm-instantiate");return wasmExports}addRunDependency("wasm-instantiate");function receiveInstantiationResult(result){receiveInstance(result["instance"])}if(Module["instantiateWasm"]){try{return Module["instantiateWasm"](info,receiveInstance)}catch(e){err(`Module.instantiateWasm callback failed with error: ${e}`);readyPromiseReject(e)}}instantiateAsync(wasmBinary,wasmBinaryFile,info,receiveInstantiationResult).catch(readyPromiseReject);return{}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var noExitRuntime=Module["noExitRuntime"]||true;var getHeapMax=()=>2147483648;var growMemory=size=>{var b=wasmMemory.buffer;var pages=(size-b.byteLength+65535)/65536;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}var alignUp=(x,multiple)=>x+(multiple-x%multiple)%multiple;for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignUp(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var ENV={};var getExecutableName=()=>thisProgram||"./this.program";var getEnvStrings=()=>{if(!getEnvStrings.strings){var lang=(typeof navigator=="object"&&navigator.languages&&navigator.languages[0]||"C").replace("-","_")+".UTF-8";var env={"USER":"web_user","LOGNAME":"web_user","PATH":"/","PWD":"/","HOME":"/home/web_user","LANG":lang,"_":getExecutableName()};for(var x in ENV){if(ENV[x]===undefined)delete env[x];else env[x]=ENV[x]}var strings=[];for(var x in env){strings.push(`${x}=${env[x]}`)}getEnvStrings.strings=strings}return getEnvStrings.strings};var stringToAscii=(str,buffer)=>{for(var i=0;i<str.length;++i){HEAP8[buffer++>>0]=str.charCodeAt(i)}HEAP8[buffer>>0]=0};var UTF8Decoder=typeof TextDecoder!="undefined"?new TextDecoder("utf8"):undefined;var UTF8ArrayToString=(heapOrArray,idx,maxBytesToRead)=>{var endIdx=idx+maxBytesToRead;var endPtr=idx;while(heapOrArray[endPtr]&&!(endPtr>=endIdx))++endPtr;if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx<endPtr){var u0=heapOrArray[idx++];if(!(u0&128)){str+=String.fromCharCode(u0);continue}var u1=heapOrArray[idx++]&63;if((u0&224)==192){str+=String.fromCharCode((u0&31)<<6|u1);continue}var u2=heapOrArray[idx++]&63;if((u0&240)==224){u0=(u0&15)<<12|u1<<6|u2}else{u0=(u0&7)<<18|u1<<12|u2<<6|heapOrArray[idx++]&63}if(u0<65536){str+=String.fromCharCode(u0)}else{var ch=u0-65536;str+=String.fromCharCode(55296|ch>>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead):"";var SYSCALLS={varargs:undefined,get(){var ret=HEAP32[+SYSCALLS.varargs>>2];SYSCALLS.varargs+=4;return ret},getp(){return SYSCALLS.get()},getStr(ptr){var ret=UTF8ToString(ptr);return ret}};var _environ_get=(__environ,environ_buf)=>{var bufSize=0;getEnvStrings().forEach((string,i)=>{var ptr=environ_buf+bufSize;HEAPU32[__environ+i*4>>2]=ptr;stringToAscii(string,ptr);bufSize+=string.length+1});return 0};var _environ_sizes_get=(penviron_count,penviron_buf_size)=>{var strings=getEnvStrings();HEAPU32[penviron_count>>2]=strings.length;var bufSize=0;strings.forEach(string=>bufSize+=string.length+1);HEAPU32[penviron_buf_size>>2]=bufSize;return 0};var _fd_close=fd=>52;var MAX_INT53=9007199254740992;var MIN_INT53=-9007199254740992;var bigintToI53Checked=num=>num<MIN_INT53||num>MAX_INT53?NaN:Number(num);function _fd_seek(fd,offset,whence,newOffset){offset=bigintToI53Checked(offset);return 70}var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer,0));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i<iovcnt;i++){var ptr=HEAPU32[iov>>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j<len;j++){printChar(fd,HEAPU8[ptr+j])}num+=len}HEAPU32[pnum>>2]=num;return 0};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i<str.length;++i){var u=str.charCodeAt(i);if(u>=55296&&u<=57343){var u1=str.charCodeAt(++i);u=65536+((u&1023)<<10)|u1&1023}if(u<=127){if(outIdx>=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i<str.length;++i){var c=str.charCodeAt(i);if(c<=127){len++}else if(c<=2047){len+=2}else if(c>=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var wasmImports={b:_emscripten_resize_heap,e:_environ_get,f:_environ_sizes_get,d:_fd_close,c:_fd_seek,a:_fd_write};var wasmExports=createWasm();var ___wasm_call_ctors=()=>(___wasm_call_ctors=wasmExports["h"])();var _yeptris_wasm_load=Module["_yeptris_wasm_load"]=(a0,a1)=>(_yeptris_wasm_load=Module["_yeptris_wasm_load"]=wasmExports["i"])(a0,a1);var _yeptris_wasm_dump=Module["_yeptris_wasm_dump"]=(a0,a1)=>(_yeptris_wasm_dump=Module["_yeptris_wasm_dump"]=wasmExports["j"])(a0,a1);var _yeptris_wasm_last_error=Module["_yeptris_wasm_last_error"]=()=>(_yeptris_wasm_last_error=Module["_yeptris_wasm_last_error"]=wasmExports["k"])();var _yeptris_wasm_last_error_line=Module["_yeptris_wasm_last_error_line"]=()=>(_yeptris_wasm_last_error_line=Module["_yeptris_wasm_last_error_line"]=wasmExports["l"])();var _yeptris_wasm_last_error_column=Module["_yeptris_wasm_last_error_column"]=()=>(_yeptris_wasm_last_error_column=Module["_yeptris_wasm_last_error_column"]=wasmExports["m"])();var _yeptris_wasm_out=Module["_yeptris_wasm_out"]=()=>(_yeptris_wasm_out=Module["_yeptris_wasm_out"]=wasmExports["n"])();var _yeptris_wasm_out_len=Module["_yeptris_wasm_out_len"]=()=>(_yeptris_wasm_out_len=Module["_yeptris_wasm_out_len"]=wasmExports["o"])();var _yeptris_wasm_out_free=Module["_yeptris_wasm_out_free"]=()=>(_yeptris_wasm_out_free=Module["_yeptris_wasm_out_free"]=wasmExports["p"])();var _yeptris_wasm_free=Module["_yeptris_wasm_free"]=a0=>(_yeptris_wasm_free=Module["_yeptris_wasm_free"]=wasmExports["q"])(a0);var _yeptris_wasm_version=Module["_yeptris_wasm_version"]=()=>(_yeptris_wasm_version=Module["_yeptris_wasm_version"]=wasmExports["r"])();var _malloc=Module["_malloc"]=a0=>(_malloc=Module["_malloc"]=wasmExports["t"])(a0);var ___errno_location=()=>(___errno_location=wasmExports["__errno_location"])();Module["UTF8ToString"]=UTF8ToString;Module["stringToUTF8"]=stringToUTF8;Module["lengthBytesUTF8"]=lengthBytesUTF8;var calledRun;dependenciesFulfilled=function runCaller(){if(!calledRun)run();if(!calledRun)dependenciesFulfilled=runCaller};function run(){if(runDependencies>0){return}preRun();if(runDependencies>0){return}function doRun(){if(calledRun)return;calledRun=true;Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve(Module);if(Module["onRuntimeInitialized"])Module["onRuntimeInitialized"]();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(function(){setTimeout(function(){Module["setStatus"]("")},1);doRun()},1)}else{doRun()}}if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].pop()()}}run();
+
+
+  return moduleArg.ready
+}
+);
+})();
+;
+export default Module;

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "yeptris",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.6.54",
+  "description": "YAML for JavaScript at libyeptris speed (WebAssembly, no fallback)",
+  "type": "module",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "./build.sh",
+    "test": "node --test test/test.mjs"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leptris/yeptris-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/leptris/yeptris-ts/issues"
+  },
+  "homepage": "https://github.com/leptris/yeptris-ts#readme"
+}

package/src/index.d.ts

@@ -0,0 +1,23 @@
+// Type declarations for yeptris (the wasm binding).
+export declare class YamlError extends Error {
+  line: number;
+  column: number;
+}
+
+/** Parse YAML text and return the document as a JavaScript value
+ * (the engine's canonical JSON, JSON.parse'd). Throws YamlError with
+ * line/column on malformed input. */
+export declare function load(yaml: string): Promise<unknown>;
+
+/** Parse YAML text and return the engine's canonical JSON string. */
+export declare function loadJSON(yaml: string): Promise<string>;
+
+/** Convert JSON text (or any JSON-serializable value) to the engine's
+ * canonical, byte-stable YAML. */
+export declare function dump(json: string | unknown): Promise<string>;
+
+/** The libyeptris version string. */
+export declare function version(): Promise<string>;
+
+/** The wasm module instance the package caches (diagnostics). */
+export declare function wasmModule(): Promise<Record<string, unknown>>;

package/src/index.js

@@ -0,0 +1,116 @@
+// The public surface: YAML <-> JSON at libyeptris speed.
+// Engine FFI through ../dist/yeptris.mjs (built by build.sh).
+
+function cstr(mod, s) {
+  const bytes = mod.lengthBytesUTF8(s) + 1;
+  const ptr = mod._malloc(bytes);
+  mod.stringToUTF8(s, ptr, bytes);
+  return [ptr, bytes - 1]; // bytes - 1: the NUL is ours, not the input's
+}
+
+function freeCstr(mod, ptr) {
+  mod._yeptris_wasm_free(ptr);
+}
+
+class YamlError extends Error {
+  constructor(message, line, column) {
+    super(line ? `${message} (line ${line}, column ${column})` : message);
+    this.name = "YamlError";
+    this.line = line;
+    this.column = column;
+  }
+}
+
+function run(mod, fn, input) {
+  const [ptr, len] = cstr(mod, input);
+  try {
+    // len is the UTF-8 byte count: input.length counts UTF-16 code
+    // units, which is strictly shorter than the wire bytes for any
+    // non-ASCII text (é is 1 unit / 2 bytes) — every such document
+    // parsed truncated
+    const st = fn(ptr, len);
+    if (st !== 0) {
+      const msg = mod.UTF8ToString(mod._yeptris_wasm_last_error());
+      throw new YamlError(
+        msg,
+        mod._yeptris_wasm_last_error_line(),
+        mod._yeptris_wasm_last_error_column());
+    }
+    const out = mod.UTF8ToString(mod._yeptris_wasm_out(), mod._yeptris_wasm_out_len());
+    return out;
+  } finally {
+    freeCstr(mod, ptr);
+    // the C side mallocs the output per call and nothing else freed
+    // it — without this a long-running process grows the wasm heap by
+    // one output per call
+    mod._yeptris_wasm_out_free();
+  }
+}
+
+let cached = null;
+
+async function mod() {
+  if (cached) return cached;
+  const factory = (await import("../dist/yeptris.mjs")).default;
+  const m = await factory();
+  // Fail loudly on a stale or truncated dist: a module missing the
+  // engine's exports would otherwise answer every call with empty
+  // strings and consumed bytes at microsecond speed (yeptris-ts#4 —
+  // the published 0.1.0 measured 121k loads/s on 205 KB, i.e. no
+  // parse at all).
+  for (const fn of [
+    "_yeptris_wasm_load",
+    "_yeptris_wasm_dump",
+    "_yeptris_wasm_out",
+    "_yeptris_wasm_out_len",
+    "_yeptris_wasm_out_free",
+    "_yeptris_wasm_last_error",
+    "_yeptris_wasm_free",
+    "_malloc",
+  ]) {
+    if (typeof m[fn] !== "function") {
+      throw new Error(
+        `yeptris: dist/yeptris.mjs is missing the wasm export ${fn} — ` +
+          "rebuild with build.sh (stale or mismatched artifact)",
+      );
+    }
+  }
+  cached = m;
+  return cached;
+}
+
+/** Parse YAML text and return the document as a JavaScript value
+ * (the engine's canonical JSON, JSON.parse'd). Throws YamlError with
+ * line/column on malformed input. */
+export async function load(yaml) {
+  const m = await mod();
+  return JSON.parse(run(m, m._yeptris_wasm_load, yaml));
+}
+
+/** Parse YAML text and return the engine's canonical JSON string. */
+export async function loadJSON(yaml) {
+  const m = await mod();
+  return run(m, m._yeptris_wasm_load, yaml);
+}
+
+/** Convert JSON text (or any JSON-serializable value) to the engine's
+ * canonical, byte-stable YAML. JSON is a subset of YAML 1.2 flow, so
+ * the one parse engine takes it. */
+export async function dump(json) {
+  const m = await mod();
+  const text = typeof json === "string" ? json : JSON.stringify(json);
+  return run(m, m._yeptris_wasm_dump, text);
+}
+
+/** The libyeptris version string. */
+export async function version() {
+  const m = await mod();
+  return m.UTF8ToString(m._yeptris_wasm_version());
+}
+
+/** The wasm module instance this package caches (diagnostics:
+ * heap/memory inspection, the engine's raw exports). The load/dump
+ * calls all share this one instance. */
+export async function wasmModule() {
+  return mod();
+}

package/src/yeptris_wasm.c

@@ -0,0 +1,109 @@
+/* The wasm surface: one contained bridge over the zero-copy core.
+ * Input bytes are copied INTO the wasm heap; the document's views live
+ * inside the heap for the duration of the call; the answers (JSON from
+ * YAML, YAML from JSON) leave before the document is freed. The host
+ * never holds a heap pointer past the call — the C buffer-lifetime
+ * contract stays internal. */
+#include <emscripten/emscripten.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include "yeptris/dom.h"
+#include "yeptris/emit.h"
+#include "yeptris/error.h"
+#include "yeptris/json.h"
+#include "yeptris/parse.h"
+#include "yeptris/version.h"
+
+static char *g_out;
+static size_t g_out_len;
+
+static char last_error[256];
+static int last_error_line;
+static int last_error_column;
+
+static void capture_error(void) {
+    uint32_t line = 0;
+    uint32_t col = 0;
+    const char *msg = yeptris_last_error(&line, &col);
+    snprintf(last_error, sizeof last_error, "%s", msg ? msg : "parse failed");
+    last_error_line = (int)line;
+    last_error_column = (int)col;
+}
+
+/* YAML in -> canonical JSON out (yeptris_serialize_json). */
+EMSCRIPTEN_KEEPALIVE
+int yeptris_wasm_load(const char *data, size_t len) {
+    YeptrisStatus st = YEPTRIS_OK;
+    YeptrisDocument doc = yeptris_parse(data, len, &st);
+    if (doc == NULL || st != YEPTRIS_OK) {
+        capture_error();
+        return (int)st;
+    }
+    size_t out_len = 0;
+    char *out = yeptris_serialize_json(doc, &out_len);
+    yeptris_document_free(doc);
+    if (out == NULL) {
+        snprintf(last_error, sizeof last_error, "serialization failed");
+        last_error_line = 0;
+        last_error_column = 0;
+        return YEPTRIS_ERROR_MEMORY;
+    }
+    g_out = out;
+    g_out_len = out_len;
+    return YEPTRIS_OK;
+}
+
+/* JSON in -> canonical YAML out (JSON is a subset of YAML 1.2 flow, so
+ * the one parse engine takes it; the emitter's canonical form is
+ * byte-stable across round trips). */
+EMSCRIPTEN_KEEPALIVE
+int yeptris_wasm_dump(const char *data, size_t len) {
+    YeptrisStatus st = YEPTRIS_OK;
+    YeptrisDocument doc = yeptris_parse(data, len, &st);
+    if (doc == NULL || st != YEPTRIS_OK) {
+        capture_error();
+        return (int)st;
+    }
+    size_t out_len = 0;
+    char *out = yeptris_serialize(doc, &out_len);
+    yeptris_document_free(doc);
+    if (out == NULL) {
+        snprintf(last_error, sizeof last_error, "serialization failed");
+        last_error_line = 0;
+        last_error_column = 0;
+        return YEPTRIS_ERROR_MEMORY;
+    }
+    g_out = out;
+    g_out_len = out_len;
+    return YEPTRIS_OK;
+}
+
+EMSCRIPTEN_KEEPALIVE
+const char *yeptris_wasm_last_error(void) { return last_error; }
+
+EMSCRIPTEN_KEEPALIVE
+int yeptris_wasm_last_error_line(void) { return last_error_line; }
+
+EMSCRIPTEN_KEEPALIVE
+int yeptris_wasm_last_error_column(void) { return last_error_column; }
+
+EMSCRIPTEN_KEEPALIVE
+const char *yeptris_wasm_out(void) { return g_out; }
+
+EMSCRIPTEN_KEEPALIVE
+int yeptris_wasm_out_len(void) { return (int)g_out_len; }
+
+EMSCRIPTEN_KEEPALIVE
+void yeptris_wasm_out_free(void) {
+    yeptris_free(g_out);
+    g_out = NULL;
+    g_out_len = 0;
+}
+
+EMSCRIPTEN_KEEPALIVE
+void yeptris_wasm_free(void *p) { yeptris_free(p); }
+
+EMSCRIPTEN_KEEPALIVE
+const char *yeptris_wasm_version(void) { return yeptris_version(); }