jsonc-effect 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 C. Spencer Beggs
+
+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,49 @@
+# jsonc-effect
+
+[![npm version](https://img.shields.io/npm/v/jsonc-effect)](https://www.npmjs.com/package/jsonc-effect)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
+
+Pure [Effect](https://effect.website) JSONC (JSON with Comments) parser with no external parser dependencies. Scanner, parser, AST, and formatting are all implemented natively.
+
+## Features
+
+- **Effect-native** -- typed errors, Schema integration, and composable pipelines
+- **Zero parser dependencies** -- `effect` is the sole runtime dependency
+- **Schema integration** -- parse JSONC strings directly into validated types
+- **Full toolchain** -- scanner, parser, AST navigation, visitor stream, formatting, and modification
+- **Safe by default** -- returns `unknown` (not `any`) and `Option` (not `undefined`)
+
+## Installation
+
+```bash
+npm install jsonc-effect effect
+```
+
+## Quick Start
+
+```typescript
+import { parse } from "jsonc-effect"
+import { Effect } from "effect"
+
+const result = Effect.runSync(
+  parse('{ "key": 42, /* comment */ }')
+)
+// => { key: 42 }
+```
+
+## FAQ
+
+### Why does this module exist?
+
+If you just need to parse JSONC into a JavaScript object, use [jsonc-parser](https://github.com/microsoft/node-jsonc-parser) or [Bun's native JSONC support](https://bun.sh/docs/api/utils#bunfile-json). They are faster and have no dependencies.
+
+This library is for Effect-based programs that need deeper introspection and editing of JSONC documents: typed parse errors you can `catchTag`, Schema pipelines that validate JSONC strings into domain types, AST navigation, document modification and SAX-style visitor streams that are composable in Effect pipelines.
+
+## Documentation
+
+For API reference, advanced usage, and examples, see [docs](./docs/README.md).
+
+## License
+
+[MIT](./LICENSE)