Metadata-Version: 2.4
Name: chlang
Version: 3.31.3
Summary: φ-lang v6 + φC engine + CR38 notebook renderer: chessboard-coordinate handwriting notebooks (.ram/.gθ), Rot24 fold geometry, point-blob codec, street/map rendering, chlang Board/HyperBoard binding
Author: Cerie Raman
License: MIT
Keywords: phi-lang,chess,capability,engine,philang,cr38,notebook,handwriting
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: C
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: python-chess>=1.999
Provides-Extra: shape
Requires-Dist: matplotlib>=3.5; extra == "shape"
Requires-Dist: numpy>=1.20; extra == "shape"
Provides-Extra: cr38-render
Requires-Dist: Pillow>=9.0; extra == "cr38-render"

# chlang — φ-lang v6 + φC engine + CR38 notebook renderer

`chlang` is the φ-lang v6 execution stack: 17,715 atoms, 10,292 skill
phrases, 44 language builders, the hypergeometry chain (block cube →
board cube → 4D membrane cube → lattice → brick), and the φC C
compiler.

## Dictionary (v3.31.0+)

Ships the full word→atom dictionary (`v6.dict`, `v6_phrase.dict`,
`v6_kw.dict`): **17,717 atoms, 10,339 phrases, 220 keywords** load at
import. Encode/decode round-trip is **lossless across all modes**
(v3.31.3 — standard, lossless, compact, and phrase compression):

```python
import chlang
chlang.v6_stats()          # {'atoms': 17717, 'phrases': 10339, ...}
from chlang.v6_phrase import atom_for, encode, decode
atom_for("deploy")         # 'dpl'
decode(encode("build an android apk with flutter"))  # exact round-trip
decode(encode("SMS Security: guard the APK!", lossless=True))  # exact
```

## Skills (v3.31.0+)

Ships 413 ported skill shapes from the Hermes skill store as chlang
`.phi_skill` files, **plus 38 domain class files with all 413
registered as callable phrase functions**:

```python
import chlang
chlang.skill_count()            # 413
chlang.skill_get("sms-security")

import chlang.mesh_skill as ms
ms.build_mesh().project_skills()   # 413 skills projected
ms.navigate("sms guard android")   # -> sms-guard-android-build
```

Every skill is also a runnable script in 42 languages (C, Dart, Swift,
Java, Python…):

```python
from chlang.phi_script import run_script
run_script("prn sms_security_ok", "c")      # runs
run_script("prn sms_security_ok", "dart")   # runs (Android-ready)
```

## Shape (v3.30.1+)

Render chlang's own shape — 12.67 board-cubes (608 boards, 38,918 blocks):

```bash
pip install "chlang[shape]"
chlang shape --info        # numbers only
chlang shape               # interactive 3D window
chlang shape --png out.png # headless PNG
```

## CR38 — notebook format renderer

CR38 is a handwriting notebook format whose geometry is a chessboard:

- `.ram` — one board — SQLite, 64 cells
- `.gθ` — one free block — SQLite, single writable square
- `.md` — world index — reference graph across boards/blocks

## Install

```bash
pip install chlang            # core
pip install "chlang[shape]"   # + 3D shape renderer
```

## Hypergeometry scale chain

```
block → block cube (6) → board cube (3,072 blocks / 48 boards)
→ membrane cube (4D, 384 boards) → lattice (1M boards)
→ half brick (8M) → full brick cube (27M boards)
```
