open-index/open-npm huggingface dataset:
npm package: @luzzle/cli
Description: cli to interact with a luzzle archive
Author: eleith
Latest version: 0.0.136

# @luzzle/cli 💻

A terminal companion for the human side of Luzzle. 

## What it's for 🛠️

* **Manual Management**: Quickly add, edit, or validate pieces without leaving the terminal.
* **Schema Support**: Uses your archive's schemas to provide smart prompts for new records.
* **Sanity Checks**: Validates your entire archive to ensure every piece is in the right place and follows its schema.
npm package: @luzzle/core
Description: luzzle's core
Author: eleith
Latest version: 0.0.56

# @luzzle/core 🫀

The foundational implementation of the Luzzle specification. It solves the inherent challenges of managing large-scale digital records using plain text.

## Challenges Solved 🏗️

* **Consistency**: Enforces structure across thousands of records using JSON schemas.
* **Organization**: Standardizes where files and attachments (`.assets/`) live within an archive.
* **Scale**: Maps thousands of text files into a high-performance SQLite index, enabling complex queries and fast searching without slow filesystem traversal.
* **Portability**: Provides a unified Storage abstraction (Local, WebDAV) so your data remains accessible anywhere.

## How it works 🚂

Core treats your filesystem as the primary database. It parses Markdown, validates frontmatter, and maintains a derivative SQLite cache for application-layer performance.
npm package: @luzzle/lsp
Description: LSP proxy for YAML frontmatter validation in Luzzle markdown files
Author: eleith
Latest version: 0.0.1

# @luzzle/lsp 🧠

An LSP proxy that brings schema-aware validation, autocompletion, and
diagnostics to the YAML frontmatter inside your Luzzle Markdown files.

## How It Works 🏗️

The proxy sits between your editor and `yaml-language-server`. It intercepts
documents, masks the Markdown body with whitespace (preserving coordinates 1:1),
rewrites the language to YAML, and injects your archive's JSON schemas. The
result: full schema validation and completions in your frontmatter, zero noise
from the Markdown body.

## Prerequisites 📦

- **Node.js** >= 20
- **yaml-language-server** — install via Mason (`:MasonInstall
  yaml-language-server`) or npm (`npm i -g yaml-language-server`)
- **marksman** (recommended) — handles Markdown features like links and
  headings alongside this proxy

## Install 🚀

```bash
npm install @luzzle/lsp
```

## Neovim Setup ⚙️

Add the following to your LSP config (e.g., `plugins/lsp.lua` or wherever you
configure your language servers).

### Neovim 0.11+ (Native LSP)

```lua
vim.lsp.config('luzzle_lsp', {
  cmd = { 'luzzle-lsp', '--stdio' },
  filetypes = { 'markdown' },
  root_markers = { '.luzzle' },
})

vim.lsp.enable({ 'marksman', 'luzzle_lsp' })
```

The `.luzzle` root marker ensures the server only activates inside Luzzle
archives — markdown files outside an archive won't trigger schema validation.

## Schema Discovery 🧩

The proxy reads JSON schemas from `.luzzle/schemas/` in your archive root.
Each schema file maps to a piece type:

- `.luzzle/schemas/books.json` → validates `*.books.md`
- `.luzzle/schemas/films.json` → validates `*.films.md`

## Debugging 🔍

Enable debug logging to stderr:

```bash
LUZZLE_LSP_DEBUG=1 luzzle-lsp --stdio
```

## CLI 💻

```bash
luzzle-lsp --stdio     Start the proxy (default)
luzzle-lsp --version   Print version
luzzle-lsp --help      Print usage
```
npm package: @luzzle/web.tools
Description: cli to prepare luzzle archive for the web
Author: eleith
Latest version: 0.0.123

# @luzzle/web.tools 🧰

The automated utility belt for the Luzzle Web stack. 

## What it's for 🏗️

This package is used by the Web Explorer and Builder to transform a raw archive into a high-performance web application. It handles:
* **Database Preparation**: Generating optimized web-specific SQLite tables.
* **Transforms**: A pipeline of content transforms including image optimization, open graph generation, syntax highlighting, palette extraction, and attachment processing.
npm package: @luzzle/web.utils
Description: misc scripts for working with luzzle related files and projects
Author: eleith
Latest version: 0.0.32

# @luzzle/web.utils 🛠️

The connective tissue of the Luzzle Web ecosystem. 

## Overview 🧩

This package provides shared logic and types used across the Explorer, Tools, and Builder. It ensures that configuration schemas and asset resolution remain consistent across the entire web stack.