scon-notation 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QuijoteShin
+
+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

@@ -0,0 +1,91 @@
+# scon
+
+**SCON — Schema-Compact Object Notation for JavaScript**
+
+Human-readable serialization with structural dedup. Smaller than JSON, optional WASM acceleration, zero config.
+
+[![npm](https://img.shields.io/npm/v/scon-notation.svg)](https://www.npmjs.com/package/scon-notation)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Install
+
+```bash
+npm install scon-notation
+```
+
+WASM acceleration is included as optional dependency and loads automatically when available. To explicitly exclude it:
+
+```bash
+npm install scon-notation --no-optional
+```
+
+## Quick Start
+
+```js
+import SCON from 'scon-notation';
+
+// Encode
+const data = { name: 'scon', version: 1, features: { dedup: true } };
+const sconStr = SCON.encode(data);
+// name: scon
+// version: 1
+// features:
+//  dedup: true
+
+// Decode
+const parsed = SCON.decode(sconStr);
+
+// JSON-style aliases
+const str = SCON.stringify(data);
+const obj = SCON.parse(sconStr);
+```
+
+## Features
+
+- **WASM-accelerated**: automatically loads Rust tape decoder via WebAssembly, falls back to pure JS
+- **Structural dedup**: xxHash128 fingerprinting detects repeated subtrees — 59-66% payload reduction on OpenAPI specs
+- **Schema subsystem**: registry with cycle detection, deep merge, dot-notation overrides
+- **Validation**: configurable validation modes
+- **Minifier**: bidirectional minify/expand
+- **JSON-compatible API**: `SCON.parse()` / `SCON.stringify()` aliases
+
+## API
+
+```js
+import SCON, { Encoder, Decoder, Minifier, Validator, SchemaRegistry, TreeHash } from 'scon-notation';
+
+// Encode / Decode
+SCON.encode(data)
+SCON.encode(data, { indent: 2 })
+SCON.encode(data, { autoExtract: true })  // structural dedup
+SCON.decode(sconString)
+
+// Minify / Expand
+SCON.minify(sconString)
+SCON.expand(minifiedString, { indent: 2 })
+
+// Validate
+SCON.validate(data, { mode: 'strict' })
+
+// WASM readiness (optional — all operations work without it)
+const hasWasm = await SCON.ready();
+```
+
+## Performance
+
+| Format | Bytes | Ratio | Gzip |
+|--------|-------|-------|------|
+| JSON | 90,886 | 1.00x | 4,632 |
+| SCON | 26,347 | 0.29x | 3,969 |
+| SCON (minified) | 20,211 | 0.22x | 3,818 |
+
+OpenAPI 3.1 spec, 71 endpoints. Full methodology: [DOI 10.5281/zenodo.14733092](https://doi.org/10.5281/zenodo.14733092)
+
+## Also available
+
+- **Rust**: `cargo add scon` — [crates.io/crates/scon](https://crates.io/crates/scon)
+- **PHP**: `composer require scon/scon` — [packagist.org/packages/scon/scon](https://packagist.org/packages/scon/scon)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "scon-notation",
+  "version": "1.0.0",
+  "description": "SCON — Schema-Compact Object Notation: human-readable serialization with structural dedup and optional WASM acceleration",
+  "type": "module",
+  "main": "src/scon.js",
+  "exports": {
+    ".": "./src/scon.js",
+    "./encoder": "./src/encoder.js",
+    "./decoder": "./src/decoder.js",
+    "./minifier": "./src/minifier.js",
+    "./validator": "./src/validator.js",
+    "./schema-registry": "./src/schema-registry.js",
+    "./tree-hash": "./src/tree-hash.js"
+  },
+  "files": [
+    "src/",
+    "LICENSE",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "scon-wasm": "1.0.0",
+    "hash-wasm": "^4.11.0"
+  },
+  "keywords": [
+    "serialization",
+    "json-alternative",
+    "schema",
+    "dedup",
+    "parser",
+    "scon",
+    "compact",
+    "wasm"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/QuijoteShin/scon-js"
+  },
+  "homepage": "https://github.com/QuijoteShin/scon-js",
+  "author": "QuijoteShin",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}