typewritingclass-compiler 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# typewritingclass-compiler
+
+Rust-powered compiler and Vite plugin for Typewriting Class. Statically analyzes TypeScript source files, extracts CSS at build time, and replaces utility calls with generated class names — producing zero-runtime CSS output.
+
+## Installation
+
+```bash
+bun add -d typewritingclass-compiler
+```
+
+## Vite Plugin
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite'
+import twcPlugin from 'typewritingclass-compiler'
+
+export default defineConfig({
+  plugins: [twcPlugin()],
+})
+```
+
+Then import the virtual CSS module:
+
+```ts
+import 'virtual:twc.css'
+```
+
+## Options
+
+```ts
+twcPlugin({
+  strict: true,  // Error on dynamic values not wrapped with dynamic() (default: true)
+  theme: {       // Custom theme input
+    colors: { brand: { 500: '#6366f1' } },
+  },
+})
+```
+
+## How it works
+
+1. **Static analysis** — the Rust extractor scans TS/JS files for `cx()`, `when()`, and utility calls
+2. **CSS generation** — extracted rules are compiled into deterministic class names and CSS declarations
+3. **Code transform** — utility call sites are replaced with the generated class name strings
+4. **Virtual module** — `virtual:twc.css` aggregates all extracted CSS, respecting `@layer` ordering
+5. **Dynamic fallback** — values that can't be statically resolved fall back to runtime CSS custom properties
+
+## Strict mode
+
+Strict mode (default) requires dynamic values to be explicitly wrapped with `dynamic()`. This makes the boundary between static and runtime CSS explicit. Set `strict: false` to allow implicit dynamic values.
+
+## Exports
+
+| Export | Description |
+|---|---|
+| `default` | Vite plugin factory |
+| `nativeTransform` | Core transform function (Rust via NAPI) |
+| `generateCss` | CSS aggregation utility |
+| `ThemeInput` | Theme configuration type |
+| `TransformOutput` | Transform result type |
+| `ExtractedRule` | Individual extracted rule type |
+| `Diagnostic` | Compiler diagnostic type |

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "typewritingclass-compiler",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "files": [
+    "src"
+  ],
+  "napi": {
+    "name": "typewritingclass-compiler-native",
+    "triples": {}
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0"
+  },
+  "dependencies": {
+    "magic-string": "^0.30.21",
+    "typewritingclass": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.0"
+  },
+  "scripts": {
+    "build:native": "napi build --release",
+    "build:native:debug": "napi build"
+  }
+}

package/src/css.rs

@@ -0,0 +1,32 @@
+use crate::style_rule::StyleRule;
+
+/// Render a single rule to CSS text (without @layer wrapper)
+pub fn render_rule(class_name: &str, rule: &StyleRule) -> String {
+    let decls: String = rule
+        .declarations
+        .iter()
+        .map(|(prop, val)| format!("  {}: {};", prop, val))
+        .collect::<Vec<_>>()
+        .join("\n");
+
+    let mut selector = format!(".{}", class_name);
+    for s in &rule.selectors {
+        selector.push_str(s);
+    }
+
+    let mut css = format!("{} {{\n{}\n}}", selector, decls);
+
+    for mq in &rule.media_queries {
+        css = format!("@media {} {{\n{}\n}}", mq, css);
+    }
+
+    css
+}
+
+/// Join multiple CSS rules into a single stylesheet.
+pub fn wrap_in_layer(rules_css: &[String]) -> String {
+    if rules_css.is_empty() {
+        return String::new();
+    }
+    rules_css.join("\n\n")
+}