open-index/open-npm huggingface dataset:
npm package: @ismail-elkorchi/bytefold
Description: Multi-format archive reader/writer with agent-grade safety for Node, Deno, and Bun
Latest version: 0.8.1

# bytefold

Multi-format archive reader and writer with safety profiles for Node 24+, Deno, Bun, and Web.

## What it is

`bytefold` opens archives, audits safety conditions, and streams entry data with typed error/report contracts.

## Install

```sh
npm install @ismail-elkorchi/bytefold
deno add jsr:@ismail-elkorchi/bytefold
```

## Quickstart

```ts
import { readFile } from "node:fs/promises";
import { openArchive } from "@ismail-elkorchi/bytefold";

const input = await readFile("./archive.zip");
const reader = await openArchive(input, { profile: "agent" });
const report = await reader.audit({ profile: "agent" });
if (!report.ok) throw new Error("archive audit failed");

await reader.assertSafe({ profile: "agent" });
for await (const entry of reader.entries()) {
  if (entry.isDirectory || entry.isSymlink) continue;
  const data = await new Response(await entry.open()).arrayBuffer();
  console.log(entry.name, data.byteLength);
}
```

## Options reference

- [Options reference](https://github.com/Ismail-elkorchi/bytefold/blob/main/docs/reference/options.md)

## When not to use

- You only need a platform-specific native wrapper.
- You need CommonJS entrypoints.
- You need interactive archive browsing UI features.

## When to use

- You need a single API across runtimes for ZIP/TAR and layered compression formats.
- You need explicit safety profiles for untrusted inputs.
- You need deterministic audits and normalization.

## Compatibility

- Module system: ESM-only.
- Runtimes: Node `>=24`, current Deno, current Bun, modern browsers (web entrypoint).
- Web entrypoint means `@ismail-elkorchi/bytefold/web` (browser runtime with `Uint8Array`/`Blob`/`ReadableStream`/HTTPS URL inputs).
- The quickstart snippet above is Node-oriented; Deno/Bun can pass `Uint8Array` from their runtime file APIs.

## Links

- [Docs index](https://github.com/Ismail-elkorchi/bytefold/blob/main/docs/index.md)
- Reference:
  - [SPEC](https://github.com/Ismail-elkorchi/bytefold/blob/main/SPEC.md)
  - [Security policy](https://github.com/Ismail-elkorchi/bytefold/blob/main/SECURITY.md)
  - [Reference index](https://github.com/Ismail-elkorchi/bytefold/blob/main/docs/reference/index.md)
- How-to:
  - [How-to index](https://github.com/Ismail-elkorchi/bytefold/blob/main/docs/how-to/index.md)
  - [Audit before extract](https://github.com/Ismail-elkorchi/bytefold/blob/main/docs/how-to/audit-before-extract.md)
  - [Contributing](https://github.com/Ismail-elkorchi/bytefold/blob/main/CONTRIBUTING.md)
- Explanation: [ARCHITECTURE](https://github.com/Ismail-elkorchi/bytefold/blob/main/ARCHITECTURE.md)

## Verification

```sh
npm run examples:run
npm run check:fast
npm run check
```
npm package: @ismail-elkorchi/css-parser
Description: Deterministic CSS parser for automation workflows across Node, Deno, Bun, and modern browsers.
Latest version: 0.1.1

# @ismail-elkorchi/css-parser

Deterministic CSS parsing and selector utilities for automation across Node, Deno, Bun, and modern browsers.

No runtime dependencies: this package ships with zero runtime dependencies.

## When To Use

- You need deterministic CSS parse/serialize output.
- You need selector querying without browser-engine side effects.
- You need explicit resource budgets for untrusted stylesheets.

## When Not To Use

- You need browser layout/cascade computation.
- You need stylesheet sanitization and policy enforcement in one step.
- You need script or DOM runtime semantics.

## Install

```bash
npm install @ismail-elkorchi/css-parser
```

```bash
deno add jsr:@ismail-elkorchi/css-parser
```

## Import

```ts
import { parse } from "@ismail-elkorchi/css-parser";
```

```txt
import { parse } from "jsr:@ismail-elkorchi/css-parser";
```

## Copy/Paste Examples

### Example 1: Parse CSS

```ts
import { parse } from "@ismail-elkorchi/css-parser";

const tree = parse(".card { color: red; }");
console.log(tree.kind);
```

### Example 2: Parse streaming input

```ts
import { parseStream } from "@ismail-elkorchi/css-parser";

const stream = new ReadableStream({
  start(controller) {
    controller.enqueue(new TextEncoder().encode(".a{display:block}"));
    controller.close();
  }
});

const tree = await parseStream(stream, { budgets: { maxInputBytes: 4096, maxBufferedBytes: 512 } });
console.log(tree.kind);
```

### Example 3: Query selectors

```ts
import { compileSelectorList, querySelectorAll } from "@ismail-elkorchi/css-parser";

const selector = compileSelectorList(".card");
console.log(selector.supported, querySelectorAll(selector, { kind: "document", children: [] }).length);
```

### Example 4: Extract render signals

```ts
import { extractRenderSignals, parse } from "@ismail-elkorchi/css-parser";

const tree = parse(".card { color: red; }");
console.log(extractRenderSignals(tree).length >= 0);
```

Run packaged examples:

```bash
npm run examples:run
```

## Compatibility

Runtime compatibility matrix:

| Runtime | Status |
| --- | --- |
| Node.js | Supported |
| Deno | Supported |
| Bun | Supported |
| Browser (evergreen) | Supported |

## Security and Safety Notes

Parsing is not sanitization. For untrusted input:
- configure strict budgets,
- handle `BudgetExceededError` explicitly,
- apply separate policy checks before execution or rendering.

## Documentation

- [Docs index](./docs/index.md)
- [First parse success tutorial](./docs/tutorial/first-parse.md)
- [Options reference](./docs/reference/options.md)
npm package: @ismail-elkorchi/html-parser
Description: Deterministic HTML parser for Node, Deno, Bun, and modern browsers.
Latest version: 0.1.1

# @ismail-elkorchi/html-parser

Deterministic HTML parsing for automation workflows that need stable output across Node, Deno, Bun, and modern browsers.

No runtime dependencies: this package ships with zero runtime dependencies.

## When To Use

- You need deterministic parse and serialize output.
- You need explicit resource budgets for untrusted input.
- You need consistent behavior across Node, Deno, Bun, and browser smoke paths.

## When Not To Use

- You need HTML sanitization.
- You need a full browser engine with script execution.
- You need DOM mutation semantics beyond deterministic parse utilities.

## Install

```bash
npm install @ismail-elkorchi/html-parser
```

```bash
deno add jsr:@ismail-elkorchi/html-parser
```

## Import

```ts
import { parse } from "@ismail-elkorchi/html-parser";
```

```txt
import { parse } from "jsr:@ismail-elkorchi/html-parser";
```

## Copy/Paste Examples

### Example 1: Parse a document

```ts
import { parse } from "@ismail-elkorchi/html-parser";

const tree = parse("<main><h1>Hello</h1></main>");
console.log(tree.kind);
```

### Example 2: Parse streaming bytes

```ts
import { parseStream } from "@ismail-elkorchi/html-parser";

const stream = new ReadableStream({
  start(controller) {
    controller.enqueue(new TextEncoder().encode("<p>streamed</p>"));
    controller.close();
  }
});

const tree = await parseStream(stream, { budgets: { maxInputBytes: 4096, maxBufferedBytes: 512 } });
console.log(tree.kind);
```

### Example 3: Extract visible text

```ts
import { parse, visibleText } from "@ismail-elkorchi/html-parser";

const tree = parse("<article><h1>Title</h1><p>Hello world.</p></article>");
console.log(visibleText(tree).trim());
```

### Example 4: Compute and apply a patch plan

```ts
import { applyPatchPlan, computePatch } from "@ismail-elkorchi/html-parser";

const plan = computePatch("<p>Draft</p>", []);
const patched = applyPatchPlan("<p>Draft</p>", plan);
console.log(patched);
```

Run packaged examples:

```bash
npm run examples:run
```

## Compatibility

Runtime compatibility matrix:

| Runtime | Status |
| --- | --- |
| Node.js | Supported |
| Deno | Supported |
| Bun | Supported |
| Browser (evergreen) | Supported |

## Security and Safety Notes

Parsing is not sanitization. For untrusted input:
- set strict budgets,
- handle `BudgetExceededError` explicitly,
- sanitize separately before rendering.

## Documentation

- [Docs index](./docs/index.md)
- [First parse success tutorial](./docs/tutorial/first-parse.md)
- [Options reference](./docs/reference/options.md)