fastyaml-rs 0.1.4

package/.prettierignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+coverage/
+*.node
+target/
+Cargo.lock
+package-lock.json

package/.prettierrc.json

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/README.md

@@ -0,0 +1,253 @@
+# fastyaml-rs
+
+[![npm](https://img.shields.io/npm/v/fastyaml-rs)](https://www.npmjs.com/package/fastyaml-rs)
+[![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue)](../LICENSE-MIT)
+[![Node.js](https://img.shields.io/badge/node-20+-green.svg)](https://nodejs.org/)
+
+**High-performance YAML 1.2.2 parser for Node.js, powered by Rust.**
+
+Drop-in replacement for js-yaml with **5-10x faster** parsing through Rust's `yaml-rust2` library. Full YAML 1.2.2 Core Schema compliance with TypeScript definitions included.
+
+> **YAML 1.2.2 Compliance** — Unlike js-yaml (YAML 1.1 by default), `fastyaml-rs` follows the modern YAML 1.2.2 specification. This means `yes/no/on/off` are strings, not booleans, and octal numbers require `0o` prefix.
+
+## Installation
+
+```bash
+# npm
+npm install fastyaml-rs
+
+# yarn
+yarn add fastyaml-rs
+
+# pnpm
+pnpm add fastyaml-rs
+```
+
+**Requirements:** Node.js 20+. TypeScript definitions included.
+
+## Quick Start
+
+```typescript
+import { safeLoad, safeDump } from 'fastyaml-rs';
+
+// Parse YAML
+const data = safeLoad(`
+name: fast-yaml
+version: 0.1.0
+features:
+  - fast
+  - safe
+  - yaml-1.2.2
+`);
+
+console.log(data);
+// { name: 'fast-yaml', version: '0.1.0', features: ['fast', 'safe', 'yaml-1.2.2'] }
+
+// Serialize to YAML
+const yamlStr = safeDump(data);
+console.log(yamlStr);
+```
+
+> **Migrating from js-yaml?** The API is compatible — just change your import!
+
+## API Reference
+
+### Parsing
+
+```typescript
+import { safeLoad, safeLoadAll } from 'fastyaml-rs';
+
+// Parse single document
+const doc = safeLoad('key: value');
+// { key: 'value' }
+
+// Parse multiple documents
+const docs = safeLoadAll(`
+---
+first: 1
+---
+second: 2
+`);
+// [{ first: 1 }, { second: 2 }]
+```
+
+### Serialization
+
+```typescript
+import { safeDump, safeDumpAll } from 'fastyaml-rs';
+
+// Dump single document
+const yaml = safeDump({ name: 'test', count: 42 });
+// 'name: test\ncount: 42\n'
+
+// Dump with options
+const sorted = safeDump(data, { sortKeys: true });
+
+// Dump multiple documents
+const multiDoc = safeDumpAll([{ a: 1 }, { b: 2 }]);
+// '---\na: 1\n---\nb: 2\n'
+```
+
+### Options
+
+```typescript
+interface DumpOptions {
+  sortKeys?: boolean; // Sort object keys alphabetically (default: false)
+  allowUnicode?: boolean; // Allow unicode characters (default: true)
+}
+```
+
+### Aliases
+
+For js-yaml compatibility, `load` and `dump` are provided as aliases:
+
+```typescript
+import { load, dump } from 'fastyaml-rs';
+
+const data = load('key: value');
+const yaml = dump(data);
+```
+
+## YAML 1.2.2 Differences
+
+`fastyaml-rs` implements **YAML 1.2.2 Core Schema**, which differs from js-yaml's default YAML 1.1:
+
+| Feature        | js-yaml (YAML 1.1) | fastyaml-rs (YAML 1.2.2) |
+| -------------- | ------------------ | ------------------------ |
+| `yes/no`       | `true/false`       | `"yes"/"no"` (strings)   |
+| `on/off`       | `true/false`       | `"on"/"off"` (strings)   |
+| `014` (octal)  | `12`               | `14` (decimal)           |
+| `0o14` (octal) | Error              | `12`                     |
+
+### Examples
+
+```typescript
+import { safeLoad } from 'fastyaml-rs';
+
+// Booleans — only true/false
+safeLoad('true'); // true
+safeLoad('false'); // false
+safeLoad('yes'); // "yes" (string!)
+safeLoad('no'); // "no" (string!)
+
+// Octal numbers — require 0o prefix
+safeLoad('0o14'); // 12 (octal)
+safeLoad('014'); // 14 (decimal, NOT octal!)
+
+// Special floats
+safeLoad('.inf'); // Infinity
+safeLoad('-.inf'); // -Infinity
+safeLoad('.nan'); // NaN
+
+// Null values
+safeLoad('~'); // null
+safeLoad('null'); // null
+```
+
+## Supported Types
+
+| YAML Type              | JavaScript Type |
+| ---------------------- | --------------- |
+| `null`, `~`            | `null`          |
+| `true`, `false`        | `boolean`       |
+| `123`, `0x1F`, `0o17`  | `number`        |
+| `1.23`, `.inf`, `.nan` | `number`        |
+| `"string"`, `'string'` | `string`        |
+| `[a, b, c]`            | `Array`         |
+| `{a: 1, b: 2}`         | `Object`        |
+
+## Security
+
+Input validation is enforced to prevent denial-of-service attacks:
+
+| Limit          | Default |
+| -------------- | ------- |
+| Max input size | 100 MB  |
+
+## Performance
+
+Benchmarks on typical YAML workloads show **5-10x speedup** over js-yaml for large files:
+
+| File Size     | js-yaml | fastyaml-rs | Speedup  |
+| ------------- | ------- | ----------- | -------- |
+| Small (100B)  | 15 μs   | 5 μs        | **3x**   |
+| Medium (2KB)  | 200 μs  | 50 μs       | **4x**   |
+| Large (100KB) | 15 ms   | 2 ms        | **7.5x** |
+
+Run benchmarks yourself:
+
+```bash
+npm run bench
+```
+
+## Platform Support
+
+Pre-built binaries are available for:
+
+| Platform      | Architecture |
+| ------------- | ------------ |
+| Linux (glibc) | x64, ARM64   |
+| Linux (musl)  | x64          |
+| macOS         | x64, ARM64   |
+| Windows       | x64, ARM64   |
+
+## Development
+
+### Prerequisites
+
+- Node.js >= 20
+- Rust >= 1.88.0
+- NAPI-RS CLI (`npm install -g @napi-rs/cli`)
+
+### Build from Source
+
+```bash
+# Clone repository
+git clone https://github.com/bug-ops/fast-yaml.git
+cd fast-yaml/nodejs
+
+# Install dependencies
+npm install
+
+# Build debug version
+npm run build:debug
+
+# Build release version
+npm run build
+
+# Run tests
+npm test
+
+# Run benchmarks
+npm run bench
+```
+
+### Scripts
+
+| Script                | Description                  |
+| --------------------- | ---------------------------- |
+| `npm run build`       | Build release native module  |
+| `npm run build:debug` | Build debug native module    |
+| `npm test`            | Run test suite               |
+| `npm run bench`       | Run benchmarks               |
+| `npm run format`      | Format code with Prettier    |
+| `npm run typecheck`   | Run TypeScript type checking |
+
+## Technology Stack
+
+- **YAML Parser**: [yaml-rust2](https://github.com/Ethiraric/yaml-rust2) — Rust YAML 1.2.2 parser
+- **Node.js Bindings**: [NAPI-RS](https://napi.rs/) — Zero-cost Node.js bindings
+- **Test Framework**: [Vitest](https://vitest.dev/) — Fast test runner
+
+## Related Packages
+
+- [fastyaml-rs (Python)](https://pypi.org/project/fastyaml-rs/) — Python bindings for the same Rust core
+
+## License
+
+Licensed under either of:
+
+- Apache License, Version 2.0 ([LICENSE-APACHE](../LICENSE-APACHE))
+- MIT license ([LICENSE-MIT](../LICENSE-MIT))
+
+at your option.

package/coverage/base.css

@@ -0,0 +1,224 @@
+body, html {
+  margin:0; padding: 0;
+  height: 100%;
+}
+body {
+    font-family: Helvetica Neue, Helvetica, Arial;
+    font-size: 14px;
+    color:#333;
+}
+.small { font-size: 12px; }
+*, *:after, *:before {
+  -webkit-box-sizing:border-box;
+     -moz-box-sizing:border-box;
+          box-sizing:border-box;
+  }
+h1 { font-size: 20px; margin: 0;}
+h2 { font-size: 14px; }
+pre {
+    font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
+    margin: 0;
+    padding: 0;
+    -moz-tab-size: 2;
+    -o-tab-size:  2;
+    tab-size: 2;
+}
+a { color:#0074D9; text-decoration:none; }
+a:hover { text-decoration:underline; }
+.strong { font-weight: bold; }
+.space-top1 { padding: 10px 0 0 0; }
+.pad2y { padding: 20px 0; }
+.pad1y { padding: 10px 0; }
+.pad2x { padding: 0 20px; }
+.pad2 { padding: 20px; }
+.pad1 { padding: 10px; }
+.space-left2 { padding-left:55px; }
+.space-right2 { padding-right:20px; }
+.center { text-align:center; }
+.clearfix { display:block; }
+.clearfix:after {
+  content:'';
+  display:block;
+  height:0;
+  clear:both;
+  visibility:hidden;
+  }
+.fl { float: left; }
+@media only screen and (max-width:640px) {
+  .col3 { width:100%; max-width:100%; }
+  .hide-mobile { display:none!important; }
+}
+
+.quiet {
+  color: #7f7f7f;
+  color: rgba(0,0,0,0.5);
+}
+.quiet a { opacity: 0.7; }
+
+.fraction {
+  font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+  font-size: 10px;
+  color: #555;
+  background: #E8E8E8;
+  padding: 4px 5px;
+  border-radius: 3px;
+  vertical-align: middle;
+}
+
+div.path a:link, div.path a:visited { color: #333; }
+table.coverage {
+  border-collapse: collapse;
+  margin: 10px 0 0 0;
+  padding: 0;
+}
+
+table.coverage td {
+  margin: 0;
+  padding: 0;
+  vertical-align: top;
+}
+table.coverage td.line-count {
+    text-align: right;
+    padding: 0 5px 0 20px;
+}
+table.coverage td.line-coverage {
+    text-align: right;
+    padding-right: 10px;
+    min-width:20px;
+}
+
+table.coverage td span.cline-any {
+    display: inline-block;
+    padding: 0 5px;
+    width: 100%;
+}
+.missing-if-branch {
+    display: inline-block;
+    margin-right: 5px;
+    border-radius: 3px;
+    position: relative;
+    padding: 0 4px;
+    background: #333;
+    color: yellow;
+}
+
+.skip-if-branch {
+    display: none;
+    margin-right: 10px;
+    position: relative;
+    padding: 0 4px;
+    background: #ccc;
+    color: white;
+}
+.missing-if-branch .typ, .skip-if-branch .typ {
+    color: inherit !important;
+}
+.coverage-summary {
+  border-collapse: collapse;
+  width: 100%;
+}
+.coverage-summary tr { border-bottom: 1px solid #bbb; }
+.keyline-all { border: 1px solid #ddd; }
+.coverage-summary td, .coverage-summary th { padding: 10px; }
+.coverage-summary tbody { border: 1px solid #bbb; }
+.coverage-summary td { border-right: 1px solid #bbb; }
+.coverage-summary td:last-child { border-right: none; }
+.coverage-summary th {
+  text-align: left;
+  font-weight: normal;
+  white-space: nowrap;
+}
+.coverage-summary th.file { border-right: none !important; }
+.coverage-summary th.pct { }
+.coverage-summary th.pic,
+.coverage-summary th.abs,
+.coverage-summary td.pct,
+.coverage-summary td.abs { text-align: right; }
+.coverage-summary td.file { white-space: nowrap;  }
+.coverage-summary td.pic { min-width: 120px !important;  }
+.coverage-summary tfoot td { }
+
+.coverage-summary .sorter {
+    height: 10px;
+    width: 7px;
+    display: inline-block;
+    margin-left: 0.5em;
+    background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
+}
+.coverage-summary .sorted .sorter {
+    background-position: 0 -20px;
+}
+.coverage-summary .sorted-desc .sorter {
+    background-position: 0 -10px;
+}
+.status-line {  height: 10px; }
+/* yellow */
+.cbranch-no { background: yellow !important; color: #111; }
+/* dark red */
+.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
+.low .chart { border:1px solid #C21F39 }
+.highlighted,
+.highlighted .cstat-no, .highlighted .fstat-no, .highlighted .cbranch-no{
+  background: #C21F39 !important;
+}
+/* medium red */
+.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
+/* light red */
+.low, .cline-no { background:#FCE1E5 }
+/* light green */
+.high, .cline-yes { background:rgb(230,245,208) }
+/* medium green */
+.cstat-yes { background:rgb(161,215,106) }
+/* dark green */
+.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
+.high .chart { border:1px solid rgb(77,146,33) }
+/* dark yellow (gold) */
+.status-line.medium, .medium .cover-fill { background: #f9cd0b; }
+.medium .chart { border:1px solid #f9cd0b; }
+/* light yellow */
+.medium { background: #fff4c2; }
+
+.cstat-skip { background: #ddd; color: #111; }
+.fstat-skip { background: #ddd; color: #111 !important; }
+.cbranch-skip { background: #ddd !important; color: #111; }
+
+span.cline-neutral { background: #eaeaea; }
+
+.coverage-summary td.empty {
+    opacity: .5;
+    padding-top: 4px;
+    padding-bottom: 4px;
+    line-height: 1;
+    color: #888;
+}
+
+.cover-fill, .cover-empty {
+  display:inline-block;
+  height: 12px;
+}
+.chart {
+  line-height: 0;
+}
+.cover-empty {
+    background: white;
+}
+.cover-full {
+    border-right: none !important;
+}
+pre.prettyprint {
+    border: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+}
+.com { color: #999 !important; }
+.ignore-none { color: #999; font-weight: normal; }
+
+.wrapper {
+  min-height: 100%;
+  height: auto !important;
+  height: 100%;
+  margin: 0 auto -48px;
+}
+.footer, .push {
+  height: 48px;
+}

package/coverage/block-navigation.js

@@ -0,0 +1,87 @@
+/* eslint-disable */
+var jumpToCode = (function init() {
+    // Classes of code we would like to highlight in the file view
+    var missingCoverageClasses = ['.cbranch-no', '.cstat-no', '.fstat-no'];
+
+    // Elements to highlight in the file listing view
+    var fileListingElements = ['td.pct.low'];
+
+    // We don't want to select elements that are direct descendants of another match
+    var notSelector = ':not(' + missingCoverageClasses.join('):not(') + ') > '; // becomes `:not(a):not(b) > `
+
+    // Selector that finds elements on the page to which we can jump
+    var selector =
+        fileListingElements.join(', ') +
+        ', ' +
+        notSelector +
+        missingCoverageClasses.join(', ' + notSelector); // becomes `:not(a):not(b) > a, :not(a):not(b) > b`
+
+    // The NodeList of matching elements
+    var missingCoverageElements = document.querySelectorAll(selector);
+
+    var currentIndex;
+
+    function toggleClass(index) {
+        missingCoverageElements
+            .item(currentIndex)
+            .classList.remove('highlighted');
+        missingCoverageElements.item(index).classList.add('highlighted');
+    }
+
+    function makeCurrent(index) {
+        toggleClass(index);
+        currentIndex = index;
+        missingCoverageElements.item(index).scrollIntoView({
+            behavior: 'smooth',
+            block: 'center',
+            inline: 'center'
+        });
+    }
+
+    function goToPrevious() {
+        var nextIndex = 0;
+        if (typeof currentIndex !== 'number' || currentIndex === 0) {
+            nextIndex = missingCoverageElements.length - 1;
+        } else if (missingCoverageElements.length > 1) {
+            nextIndex = currentIndex - 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    function goToNext() {
+        var nextIndex = 0;
+
+        if (
+            typeof currentIndex === 'number' &&
+            currentIndex < missingCoverageElements.length - 1
+        ) {
+            nextIndex = currentIndex + 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    return function jump(event) {
+        if (
+            document.getElementById('fileSearch') === document.activeElement &&
+            document.activeElement != null
+        ) {
+            // if we're currently focused on the search input, we don't want to navigate
+            return;
+        }
+
+        switch (event.which) {
+            case 78: // n
+            case 74: // j
+                goToNext();
+                break;
+            case 66: // b
+            case 75: // k
+            case 80: // p
+                goToPrevious();
+                break;
+        }
+    };
+})();
+window.addEventListener('keydown', jumpToCode);

package/coverage/index.html

@@ -0,0 +1,101 @@
+
+<!doctype html>
+<html lang="en">
+
+<head>
+    <title>Code coverage report for All files</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="prettify.css" />
+    <link rel="stylesheet" href="base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+    
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1>All files</h1>
+        <div class='clearfix'>
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">Unknown% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>0/0</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">Unknown% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/0</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">Unknown% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>0/0</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">Unknown% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>0/0</span>
+            </div>
+        
+            
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line medium'></div>
+    <div class="pad1">
+<table class="coverage-summary">
+<thead>
+<tr>
+   <th data-col="file" data-fmt="html" data-html="true" class="file">File</th>
+   <th data-col="pic" data-type="number" data-fmt="html" data-html="true" class="pic"></th>
+   <th data-col="statements" data-type="number" data-fmt="pct" class="pct">Statements</th>
+   <th data-col="statements_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="branches" data-type="number" data-fmt="pct" class="pct">Branches</th>
+   <th data-col="branches_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="functions" data-type="number" data-fmt="pct" class="pct">Functions</th>
+   <th data-col="functions_raw" data-type="number" data-fmt="html" class="abs"></th>
+   <th data-col="lines" data-type="number" data-fmt="pct" class="pct">Lines</th>
+   <th data-col="lines_raw" data-type="number" data-fmt="html" class="abs"></th>
+</tr>
+</thead>
+<tbody></tbody>
+</table>
+</div>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2025-12-13T15:10:41.642Z
+            </div>
+        <script src="prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="sorter.js"></script>
+        <script src="block-navigation.js"></script>
+    </body>
+</html>
+