@csszyx/core 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 csszyx contributors
+
+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

@@ -1,113 +1,83 @@
-# <p align="center">🌊 @csszyx/core</p>
+# @csszyx/core
 
-<p align="center">
-  <img src="https://img.shields.io/badge/WASM-Powered-624de3?style=for-the-badge&logo=webassembly" alt="WASM Powered" />
-  <img src="https://img.shields.io/badge/Rust-Core-dea584?style=for-the-badge&logo=rust" alt="Rust Core" />
-  <img src="https://img.shields.io/badge/TypeScript-Ready-3178c6?style=for-the-badge&logo=typescript" alt="TypeScript Ready" />
-</p>
+> Rust/WASM core for csszyx -- encoder, checksum, collision detection, and recovery tokens.
 
----
+Compiled to WebAssembly, this package provides the performance-critical operations for the csszyx ecosystem. It runs in Node.js, browsers, and edge environments.
 
-## ✨ The Engine of csszyx
-
-`@csszyx/core` is a high-performance, precision-engineered Rust core for the **csszyx** ecosystem. Compiled to WebAssembly, it brings near-native performance to Node.js, Browsers, and Edge environments.
-
-### 🔥 Why Core?
-
-- **Blazing Speed**: Offloads performance-critical operations (Hashing, Transformation, Encoding) to optimized Rust.
-- **Universal Integrity**: Ensures bit-perfect mangle map consistency between SSR and hydration.
-- **Security-First**: Uses SHA-256 and Base62 for tamper-proof tokens and collision-free variable names.
-- **Zero Dependencies**: Lightweight WASM binary with no external runtimes required.
-
----
-
-## 🚀 Quick Start
+## Installation
 
 ```bash
 pnpm add @csszyx/core
 ```
 
-### Initialization
+## Initialization
 
 ```typescript
-import { init } from '@csszyx/core';
+import { init } from "@csszyx/core";
 
-async function bootstrap() {
-    await init();
-    // Core is ready to flow 🌊
-}
+await init();
 ```
 
----
+## Modules
 
-## 🛠 Modules
-
-### 🗺️ Mangle Map Integrity
+### Mangle Map Integrity
 
 Deterministic SHA-256 checksums to synchronize server-side class names with client-side hydration.
 
 ```typescript
-import { compute_mangle_checksum, verify_mangle_checksum } from '@csszyx/core';
+import { compute_mangle_checksum, verify_mangle_checksum } from "@csszyx/core";
 
-const mangleMap = { 'p-4': 'z', 'm-2': 'y' };
+const mangleMap = { "p-4": "z", "m-2": "y" };
 const checksum = compute_mangle_checksum(mangleMap);
-// Results in a deterministic 16-char hex hash
+// Returns a deterministic 16-char hex hash
 ```
 
-### 🎭 Transformer
+### Transformer
 
-Universal conversion of object-based Tailwind syntax into optimized class strings.
+Converts object-based Tailwind syntax into class strings.
 
 ```typescript
-import { transform_sz } from '@csszyx/core';
+import { transform_sz } from "@csszyx/core";
 
-// Supports: Negatives, Opacity, Nesting, Integers
 transform_sz({
-    m: -4,
-    bg: 'blue-500/20',
-    hover: { scale: 110 }
+  m: -4,
+  bg: "blue-500/20",
+  hover: { scale: 110 },
 });
 // "-m-4 bg-blue-500/20 hover:scale-110"
 ```
 
-### 🔢 Tiered Encoder
+### Tiered Encoder
 
-The world's smallest CSS-compliant class name generator.
+CSS-compliant class name generator using reversed tier encoding (z -> y -> x).
 
-| Tier | Range | Format | Example |
-| :--- | :--- | :--- | :--- |
-| **Tier 1** | 0 - 51 | \[z-aZ-A\] | `z`, `y`, `x` |
-| **Tier 2** | 52 - 571 | \[z-aZ-A\]\[9-0\] | `z9`, `y8` |
-| **Tier 3** | 572 - 3275 | \[z-aZ-A\]{2} | `zz`, `zy` |
+| Tier   | Range      | Format            | Example       |
+| :----- | :--------- | :---------------- | :------------ |
+| Tier 1 | 0 - 51     | \[z-aZ-A\]        | `z`, `y`, `x` |
+| Tier 2 | 52 - 571   | \[z-aZ-A\]\[9-0\] | `z9`, `y8`    |
+| Tier 3 | 572 - 3275 | \[z-aZ-A\]{2}     | `zz`, `zy`    |
 
-### 🛡️ Collision Detector
+### Collision Detector
 
 Dual-hash resolution strategy for unique CSS variable names.
 
 ```typescript
-import { WasmCollisionDetector } from '@csszyx/core';
+import { WasmCollisionDetector } from "@csszyx/core";
 
 const detector = new WasmCollisionDetector();
-const varId = detector.add('#ff0000'); // "--v-a1b2c3"
+const varId = detector.add("#ff0000"); // "--v-a1b2c3"
 ```
 
----
-
-## ⚡ Performance Matrix
-
-Benchmarks performed on Apple M2 (WASM Node v20 target)
-
-| Operation | WASM (Rust) | Pure JS (Legacy) | Improvement |
-| :--- | :--- | :--- | :--- |
-| **Integrity Check** | < 1ms | ~15ms | **15x faster** |
-| **ID Encoding** | ~5ns | ~50ns | **10x faster** |
-| **Token Auth** | ~25ns | ~250ns | **10x faster** |
-| **Transformer** | Optimized | Variable | Stable 🌊 |
+## Performance
 
-> **Tech Tip**: WASM excels in consistency. Unlike JS which relies on JIT optimization, WASM provides deterministic, high-speed execution from the very first call.
+Benchmarks on Apple M2 (WASM, Node v20):
 
----
+| Operation       | WASM (Rust) | Pure JS | Speedup |
+| :-------------- | :---------- | :------ | :------ |
+| Integrity Check | < 1ms       | ~15ms   | 15x     |
+| ID Encoding     | ~5ns        | ~50ns   | 10x     |
+| Token Auth      | ~25ns       | ~250ns  | 10x     |
 
-## 📄 License
+## License
 
-MIT © 2026 csszyx Team
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "WASM core for csszyx",
   "keywords": [
     "csszyx",
@@ -33,14 +33,14 @@
     "pkg",
     "pkg-node"
   ],
+  "devDependencies": {
+    "vitest": "^1.2.0"
+  },
   "scripts": {
     "build": "wasm-pack build --target bundler --out-dir pkg && wasm-pack build --target nodejs --out-dir pkg-node && rm -f pkg/.gitignore pkg-node/.gitignore",
     "build:test": "wasm-pack build --target nodejs --out-dir pkg-node",
     "test": "npm run build:test && vitest run",
     "test:watch": "vitest",
     "clean": "rm -rf pkg pkg-node target"
-  },
-  "devDependencies": {
-    "vitest": "^1.2.0"
   }
-}
+}

package/pkg/README.md

@@ -1,113 +1,83 @@
-# <p align="center">🌊 @csszyx/core</p>
+# @csszyx/core
 
-<p align="center">
-  <img src="https://img.shields.io/badge/WASM-Powered-624de3?style=for-the-badge&logo=webassembly" alt="WASM Powered" />
-  <img src="https://img.shields.io/badge/Rust-Core-dea584?style=for-the-badge&logo=rust" alt="Rust Core" />
-  <img src="https://img.shields.io/badge/TypeScript-Ready-3178c6?style=for-the-badge&logo=typescript" alt="TypeScript Ready" />
-</p>
+> Rust/WASM core for csszyx -- encoder, checksum, collision detection, and recovery tokens.
 
----
+Compiled to WebAssembly, this package provides the performance-critical operations for the csszyx ecosystem. It runs in Node.js, browsers, and edge environments.
 
-## ✨ The Engine of csszyx
-
-`@csszyx/core` is a high-performance, precision-engineered Rust core for the **csszyx** ecosystem. Compiled to WebAssembly, it brings near-native performance to Node.js, Browsers, and Edge environments.
-
-### 🔥 Why Core?
-
-- **Blazing Speed**: Offloads performance-critical operations (Hashing, Transformation, Encoding) to optimized Rust.
-- **Universal Integrity**: Ensures bit-perfect mangle map consistency between SSR and hydration.
-- **Security-First**: Uses SHA-256 and Base62 for tamper-proof tokens and collision-free variable names.
-- **Zero Dependencies**: Lightweight WASM binary with no external runtimes required.
-
----
-
-## 🚀 Quick Start
+## Installation
 
 ```bash
 pnpm add @csszyx/core
 ```
 
-### Initialization
+## Initialization
 
 ```typescript
-import { init } from '@csszyx/core';
+import { init } from "@csszyx/core";
 
-async function bootstrap() {
-    await init();
-    // Core is ready to flow 🌊
-}
+await init();
 ```
 
----
+## Modules
 
-## 🛠 Modules
-
-### 🗺️ Mangle Map Integrity
+### Mangle Map Integrity
 
 Deterministic SHA-256 checksums to synchronize server-side class names with client-side hydration.
 
 ```typescript
-import { compute_mangle_checksum, verify_mangle_checksum } from '@csszyx/core';
+import { compute_mangle_checksum, verify_mangle_checksum } from "@csszyx/core";
 
-const mangleMap = { 'p-4': 'z', 'm-2': 'y' };
+const mangleMap = { "p-4": "z", "m-2": "y" };
 const checksum = compute_mangle_checksum(mangleMap);
-// Results in a deterministic 16-char hex hash
+// Returns a deterministic 16-char hex hash
 ```
 
-### 🎭 Transformer
+### Transformer
 
-Universal conversion of object-based Tailwind syntax into optimized class strings.
+Converts object-based Tailwind syntax into class strings.
 
 ```typescript
-import { transform_sz } from '@csszyx/core';
+import { transform_sz } from "@csszyx/core";
 
-// Supports: Negatives, Opacity, Nesting, Integers
 transform_sz({
-    m: -4,
-    bg: 'blue-500/20',
-    hover: { scale: 110 }
+  m: -4,
+  bg: "blue-500/20",
+  hover: { scale: 110 },
 });
 // "-m-4 bg-blue-500/20 hover:scale-110"
 ```
 
-### 🔢 Tiered Encoder
+### Tiered Encoder
 
-The world's smallest CSS-compliant class name generator.
+CSS-compliant class name generator using reversed tier encoding (z -> y -> x).
 
-| Tier | Range | Format | Example |
-| :--- | :--- | :--- | :--- |
-| **Tier 1** | 0 - 51 | \[z-aZ-A\] | `z`, `y`, `x` |
-| **Tier 2** | 52 - 571 | \[z-aZ-A\]\[9-0\] | `z9`, `y8` |
-| **Tier 3** | 572 - 3275 | \[z-aZ-A\]{2} | `zz`, `zy` |
+| Tier   | Range      | Format            | Example       |
+| :----- | :--------- | :---------------- | :------------ |
+| Tier 1 | 0 - 51     | \[z-aZ-A\]        | `z`, `y`, `x` |
+| Tier 2 | 52 - 571   | \[z-aZ-A\]\[9-0\] | `z9`, `y8`    |
+| Tier 3 | 572 - 3275 | \[z-aZ-A\]{2}     | `zz`, `zy`    |
 
-### 🛡️ Collision Detector
+### Collision Detector
 
 Dual-hash resolution strategy for unique CSS variable names.
 
 ```typescript
-import { WasmCollisionDetector } from '@csszyx/core';
+import { WasmCollisionDetector } from "@csszyx/core";
 
 const detector = new WasmCollisionDetector();
-const varId = detector.add('#ff0000'); // "--v-a1b2c3"
+const varId = detector.add("#ff0000"); // "--v-a1b2c3"
 ```
 
----
-
-## ⚡ Performance Matrix
-
-Benchmarks performed on Apple M2 (WASM Node v20 target)
-
-| Operation | WASM (Rust) | Pure JS (Legacy) | Improvement |
-| :--- | :--- | :--- | :--- |
-| **Integrity Check** | < 1ms | ~15ms | **15x faster** |
-| **ID Encoding** | ~5ns | ~50ns | **10x faster** |
-| **Token Auth** | ~25ns | ~250ns | **10x faster** |
-| **Transformer** | Optimized | Variable | Stable 🌊 |
+## Performance
 
-> **Tech Tip**: WASM excels in consistency. Unlike JS which relies on JIT optimization, WASM provides deterministic, high-speed execution from the very first call.
+Benchmarks on Apple M2 (WASM, Node v20):
 
----
+| Operation       | WASM (Rust) | Pure JS | Speedup |
+| :-------------- | :---------- | :------ | :------ |
+| Integrity Check | < 1ms       | ~15ms   | 15x     |
+| ID Encoding     | ~5ns        | ~50ns   | 10x     |
+| Token Auth      | ~25ns       | ~250ns  | 10x     |
 
-## 📄 License
+## License
 
-MIT © 2026 csszyx Team
+MIT

package/pkg/csszyx_core.d.ts

@@ -79,20 +79,10 @@ export class WasmCollisionDetector {
  *
  * # Examples
  *
- * ```
- * use csszyx_core::mangle::{compute_mangle_checksum, MangleMap};
- * use std::collections::HashMap;
- *
- * let mut map = HashMap::new();
- * map.insert("p-4".to_string(), "a".to_string());
- * map.insert("bg-red-500".to_string(), "b".to_string());
- *
- * let checksum = compute_mangle_checksum(&map);
- * assert_eq!(checksum.len(), 16);
- *
- * // Same map produces same checksum
- * let checksum2 = compute_mangle_checksum(&map);
- * assert_eq!(checksum, checksum2);
+ * ```ignore
+ * // This function is wasm_bindgen — call from JS, not Rust directly.
+ * // Use compute_checksum_internal() for pure-Rust usage.
+ * let checksum = compute_mangle_checksum(js_map);
  * ```
  */
 export function compute_mangle_checksum(map: any): string;

package/pkg/csszyx_core_bg.js

@@ -113,20 +113,10 @@ if (Symbol.dispose) WasmCollisionDetector.prototype[Symbol.dispose] = WasmCollis
  *
  * # Examples
  *
- * ```
- * use csszyx_core::mangle::{compute_mangle_checksum, MangleMap};
- * use std::collections::HashMap;
- *
- * let mut map = HashMap::new();
- * map.insert("p-4".to_string(), "a".to_string());
- * map.insert("bg-red-500".to_string(), "b".to_string());
- *
- * let checksum = compute_mangle_checksum(&map);
- * assert_eq!(checksum.len(), 16);
- *
- * // Same map produces same checksum
- * let checksum2 = compute_mangle_checksum(&map);
- * assert_eq!(checksum, checksum2);
+ * ```ignore
+ * // This function is wasm_bindgen — call from JS, not Rust directly.
+ * // Use compute_checksum_internal() for pure-Rust usage.
+ * let checksum = compute_mangle_checksum(js_map);
  * ```
  * @param {any} map
  * @returns {string}

package/pkg-node/README.md

@@ -1,113 +1,83 @@
-# <p align="center">🌊 @csszyx/core</p>
+# @csszyx/core
 
-<p align="center">
-  <img src="https://img.shields.io/badge/WASM-Powered-624de3?style=for-the-badge&logo=webassembly" alt="WASM Powered" />
-  <img src="https://img.shields.io/badge/Rust-Core-dea584?style=for-the-badge&logo=rust" alt="Rust Core" />
-  <img src="https://img.shields.io/badge/TypeScript-Ready-3178c6?style=for-the-badge&logo=typescript" alt="TypeScript Ready" />
-</p>
+> Rust/WASM core for csszyx -- encoder, checksum, collision detection, and recovery tokens.
 
----
+Compiled to WebAssembly, this package provides the performance-critical operations for the csszyx ecosystem. It runs in Node.js, browsers, and edge environments.
 
-## ✨ The Engine of csszyx
-
-`@csszyx/core` is a high-performance, precision-engineered Rust core for the **csszyx** ecosystem. Compiled to WebAssembly, it brings near-native performance to Node.js, Browsers, and Edge environments.
-
-### 🔥 Why Core?
-
-- **Blazing Speed**: Offloads performance-critical operations (Hashing, Transformation, Encoding) to optimized Rust.
-- **Universal Integrity**: Ensures bit-perfect mangle map consistency between SSR and hydration.
-- **Security-First**: Uses SHA-256 and Base62 for tamper-proof tokens and collision-free variable names.
-- **Zero Dependencies**: Lightweight WASM binary with no external runtimes required.
-
----
-
-## 🚀 Quick Start
+## Installation
 
 ```bash
 pnpm add @csszyx/core
 ```
 
-### Initialization
+## Initialization
 
 ```typescript
-import { init } from '@csszyx/core';
+import { init } from "@csszyx/core";
 
-async function bootstrap() {
-    await init();
-    // Core is ready to flow 🌊
-}
+await init();
 ```
 
----
+## Modules
 
-## 🛠 Modules
-
-### 🗺️ Mangle Map Integrity
+### Mangle Map Integrity
 
 Deterministic SHA-256 checksums to synchronize server-side class names with client-side hydration.
 
 ```typescript
-import { compute_mangle_checksum, verify_mangle_checksum } from '@csszyx/core';
+import { compute_mangle_checksum, verify_mangle_checksum } from "@csszyx/core";
 
-const mangleMap = { 'p-4': 'z', 'm-2': 'y' };
+const mangleMap = { "p-4": "z", "m-2": "y" };
 const checksum = compute_mangle_checksum(mangleMap);
-// Results in a deterministic 16-char hex hash
+// Returns a deterministic 16-char hex hash
 ```
 
-### 🎭 Transformer
+### Transformer
 
-Universal conversion of object-based Tailwind syntax into optimized class strings.
+Converts object-based Tailwind syntax into class strings.
 
 ```typescript
-import { transform_sz } from '@csszyx/core';
+import { transform_sz } from "@csszyx/core";
 
-// Supports: Negatives, Opacity, Nesting, Integers
 transform_sz({
-    m: -4,
-    bg: 'blue-500/20',
-    hover: { scale: 110 }
+  m: -4,
+  bg: "blue-500/20",
+  hover: { scale: 110 },
 });
 // "-m-4 bg-blue-500/20 hover:scale-110"
 ```
 
-### 🔢 Tiered Encoder
+### Tiered Encoder
 
-The world's smallest CSS-compliant class name generator.
+CSS-compliant class name generator using reversed tier encoding (z -> y -> x).
 
-| Tier | Range | Format | Example |
-| :--- | :--- | :--- | :--- |
-| **Tier 1** | 0 - 51 | \[z-aZ-A\] | `z`, `y`, `x` |
-| **Tier 2** | 52 - 571 | \[z-aZ-A\]\[9-0\] | `z9`, `y8` |
-| **Tier 3** | 572 - 3275 | \[z-aZ-A\]{2} | `zz`, `zy` |
+| Tier   | Range      | Format            | Example       |
+| :----- | :--------- | :---------------- | :------------ |
+| Tier 1 | 0 - 51     | \[z-aZ-A\]        | `z`, `y`, `x` |
+| Tier 2 | 52 - 571   | \[z-aZ-A\]\[9-0\] | `z9`, `y8`    |
+| Tier 3 | 572 - 3275 | \[z-aZ-A\]{2}     | `zz`, `zy`    |
 
-### 🛡️ Collision Detector
+### Collision Detector
 
 Dual-hash resolution strategy for unique CSS variable names.
 
 ```typescript
-import { WasmCollisionDetector } from '@csszyx/core';
+import { WasmCollisionDetector } from "@csszyx/core";
 
 const detector = new WasmCollisionDetector();
-const varId = detector.add('#ff0000'); // "--v-a1b2c3"
+const varId = detector.add("#ff0000"); // "--v-a1b2c3"
 ```
 
----
-
-## ⚡ Performance Matrix
-
-Benchmarks performed on Apple M2 (WASM Node v20 target)
-
-| Operation | WASM (Rust) | Pure JS (Legacy) | Improvement |
-| :--- | :--- | :--- | :--- |
-| **Integrity Check** | < 1ms | ~15ms | **15x faster** |
-| **ID Encoding** | ~5ns | ~50ns | **10x faster** |
-| **Token Auth** | ~25ns | ~250ns | **10x faster** |
-| **Transformer** | Optimized | Variable | Stable 🌊 |
+## Performance
 
-> **Tech Tip**: WASM excels in consistency. Unlike JS which relies on JIT optimization, WASM provides deterministic, high-speed execution from the very first call.
+Benchmarks on Apple M2 (WASM, Node v20):
 
----
+| Operation       | WASM (Rust) | Pure JS | Speedup |
+| :-------------- | :---------- | :------ | :------ |
+| Integrity Check | < 1ms       | ~15ms   | 15x     |
+| ID Encoding     | ~5ns        | ~50ns   | 10x     |
+| Token Auth      | ~25ns       | ~250ns  | 10x     |
 
-## 📄 License
+## License
 
-MIT © 2026 csszyx Team
+MIT

package/pkg-node/csszyx_core.d.ts

@@ -79,20 +79,10 @@ export class WasmCollisionDetector {
  *
  * # Examples
  *
- * ```
- * use csszyx_core::mangle::{compute_mangle_checksum, MangleMap};
- * use std::collections::HashMap;
- *
- * let mut map = HashMap::new();
- * map.insert("p-4".to_string(), "a".to_string());
- * map.insert("bg-red-500".to_string(), "b".to_string());
- *
- * let checksum = compute_mangle_checksum(&map);
- * assert_eq!(checksum.len(), 16);
- *
- * // Same map produces same checksum
- * let checksum2 = compute_mangle_checksum(&map);
- * assert_eq!(checksum, checksum2);
+ * ```ignore
+ * // This function is wasm_bindgen — call from JS, not Rust directly.
+ * // Use compute_checksum_internal() for pure-Rust usage.
+ * let checksum = compute_mangle_checksum(js_map);
  * ```
  */
 export function compute_mangle_checksum(map: any): string;

package/pkg-node/csszyx_core.js

@@ -116,20 +116,10 @@ exports.WasmCollisionDetector = WasmCollisionDetector;
  *
  * # Examples
  *
- * ```
- * use csszyx_core::mangle::{compute_mangle_checksum, MangleMap};
- * use std::collections::HashMap;
- *
- * let mut map = HashMap::new();
- * map.insert("p-4".to_string(), "a".to_string());
- * map.insert("bg-red-500".to_string(), "b".to_string());
- *
- * let checksum = compute_mangle_checksum(&map);
- * assert_eq!(checksum.len(), 16);
- *
- * // Same map produces same checksum
- * let checksum2 = compute_mangle_checksum(&map);
- * assert_eq!(checksum, checksum2);
+ * ```ignore
+ * // This function is wasm_bindgen — call from JS, not Rust directly.
+ * // Use compute_checksum_internal() for pure-Rust usage.
+ * let checksum = compute_mangle_checksum(js_map);
  * ```
  * @param {any} map
  * @returns {string}