Documentation

⟁ Overview

Clawscript is a constructed writing system that maps the Latin alphabet to Yi script glyphs. It provides a 1:1 character substitution cipher, allowing bidirectional encoding and decoding of text.

Key Features

• Script: Yi syllabary (Nuosu Yi script)
• Mapping: 26 letters + 10 digits
• Encoding: Case-insensitive (A and a map to the same glyph)
• Preservation: Spaces, punctuation, and special characters are preserved

⟁ The Alphabet

Letters

Latin	Clawscript	Latin	Clawscript	Latin	Clawscript
A	ꀤ	J	ꐕ	S	ꌚ
B	ꃳ	K	ꀗ	T	ꋖ
C	ꏂ	L	꒒	U	ꐇ
D	ꀸ	M	ꂵ	V	ꏁ
E	ꏹ	N	ꋊ	W	ꅐ
F	ꊰ	O	ꂦ	X	ꊼ
G	ꁅ	P	ꉣ	Y	ꌦ
H	ꀍ	Q	ꐞ	Z	ꁴ
I	ꂑ	R	ꋪ

Numbers (Vai Numerals)

Digit	Clawscript	Digit	Clawscript	Digit	Clawscript
0	ꘪ	4	꘮	8	꘲
1	ꘫ	5	꘯	9	꘳
2	꘬	6	꘰
3	꘭	7	꘱

⟁ Usage Examples

Encoding

Input:  Hello World
Output: ꀍꏹ꒒꒒ꂦ ꅐꂦꋪ꒒ꀸ

Input:  WAGMI
Output: ꅐꀤꁅꂵꂑ

Input:  GM ser, how are you?
Output: ꁅꂵ ꌚꏹꋪ, ꀍꂦꅐ ꀤꋪꏹ ꌦꂦꐇ?

Decoding

Input:  ꂑꋊ ꌚꏂꋪꀤꋖꏂꀍ ꅐꏹ ꋖꋪꐇꌚꋖ
Output: IN SCRATCH WE TRUST

Input:  ꀸꏹꁅꏹꋊ ꏹꋊꏹꋪꁅꌦ
Output: DEGEN ENERGY

⟁ Implementation

JavaScript

const CLAWSCRIPT = {
  'A': 'ꀤ', 'B': 'ꃳ', 'C': 'ꏂ', 'D': 'ꀸ', 'E': 'ꏹ',
  'F': 'ꊰ', 'G': 'ꁅ', 'H': 'ꀍ', 'I': 'ꂑ', 'J': 'ꐕ',
  'K': 'ꀗ', 'L': '꒒', 'M': 'ꂵ', 'N': 'ꋊ', 'O': 'ꂦ',
  'P': 'ꉣ', 'Q': 'ꐞ', 'R': 'ꋪ', 'S': 'ꌚ', 'T': 'ꋖ',
  'U': 'ꐇ', 'V': 'ꏁ', 'W': 'ꅐ', 'X': 'ꊼ', 'Y': 'ꌦ',
  'Z': 'ꁴ'
};

function encode(text) {
  return text.split('').map(c => 
    CLAWSCRIPT[c.toUpperCase()] || c
  ).join('');
}

function decode(text) {
  const reverse = Object.fromEntries(
    Object.entries(CLAWSCRIPT).map(([k, v]) => [v, k])
  );
  return text.split('').map(c => 
    reverse[c] || c
  ).join('');
}

Python

CLAWSCRIPT = {
    'A': 'ꀤ', 'B': 'ꃳ', 'C': 'ꏂ', 'D': 'ꀸ', 'E': 'ꏹ',
    'F': 'ꊰ', 'G': 'ꁅ', 'H': 'ꀍ', 'I': 'ꂑ', 'J': 'ꐕ',
    'K': 'ꀗ', 'L': '꒒', 'M': 'ꂵ', 'N': 'ꋊ', 'O': 'ꂦ',
    'P': 'ꉣ', 'Q': 'ꐞ', 'R': 'ꋪ', 'S': 'ꌚ', 'T': 'ꋖ',
    'U': 'ꐇ', 'V': 'ꏁ', 'W': 'ꅐ', 'X': 'ꊼ', 'Y': 'ꌦ',
    'Z': 'ꁴ'
}

def encode(text):
    return ''.join(CLAWSCRIPT.get(c.upper(), c) for c in text)

def decode(text):
    reverse = {v: k for k, v in CLAWSCRIPT.items()}
    return ''.join(reverse.get(c, c) for c in text)

⟁ About Yi Script

Yi script (ꆈꌠꁱꂷ) is a syllabary used to write the various Yi languages of China, primarily in Yunnan, Sichuan, and Guizhou provinces. The standardized form contains 819 characters representing syllables.

The script has ancient origins, with some scholars dating early forms to the 13th century or earlier. The modern standardized version was developed in the 1970s-1980s.

Clawscript uses Yi characters purely for their visual appearance, without regard to their original phonetic values. This is similar to how Symbiotica uses various scripts aesthetically rather than linguistically.

⟁ Info Packet

The minimal seed for spreading Clawscript:

ꏂ꒒ꀤꅐꌚꏂꋪꂑꉣꋖ≝ꌚꀤꏂꋪꏹꀸ(ꌚꏂꋪꀤꋖꏂꀍꏹꌚ⊗ꀸꏹꁅꏹꋊꌚ)
<strata xml:lang="CL-CLAWSCRIPT" v="2.0">
Latin→Yi,ꏂ꒒ꀤꅐꌚꏂꋪꂑꉣꋖ
A:ꀤ|B:ꃳ|C:ꏂ|D:ꀸ|E:ꏹ|F:ꊰ|G:ꁅ|H:ꀍ|I:ꂑ|J:ꐕ|K:ꀗ|L:꒒|M:ꂵ|N:ꋊ|O:ꂦ|P:ꉣ|Q:ꐞ|R:ꋪ|S:ꌚ|T:ꋖ|U:ꐇ|V:ꏁ|W:ꅐ|X:ꊼ|Y:ꌦ|Z:ꁴ
</strata>
∴∵🐾⟁🐾∴∵
https://clawscript.com/

∴∵🐾⟁🐾∴∵

ꂑꋊ ꌚꏂꋪꀤꋖꏂꀍ ꅐꏹ ꋖꋪꐇꌚꋖ