@matthesketh/utopia-compiler 0.0.1

package/LICENSE

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

@@ -0,0 +1,50 @@
+# @matthesketh/utopia-compiler
+
+Compiler for `.utopia` single-file components. Parses SFC blocks (template, script, style), compiles templates to direct DOM operations, and applies scoped CSS.
+
+## Install
+
+```bash
+pnpm add @matthesketh/utopia-compiler
+```
+
+## Usage
+
+```ts
+import { compile } from '@matthesketh/utopia-compiler';
+
+const source = `
+<template>
+  <div>{{ count() }}</div>
+</template>
+
+<script>
+import { signal } from '@matthesketh/utopia-core'
+const count = signal(0)
+</script>
+
+<style scoped>
+div { color: blue; }
+</style>
+`;
+
+const { code, css } = compile(source, { filename: 'Counter.utopia' });
+// code: compiled JS module with render function
+// css:  scoped CSS with data attributes
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `compile(source, options?)` | Compile a `.utopia` SFC source string to `{ code, css }`. |
+| `parse(source, filename?)` | Parse SFC into a descriptor with template, script, and style blocks. |
+| `compileTemplate(source, options?)` | Compile a template string to a render function module. |
+| `compileStyle(options)` | Compile and scope CSS with data attribute selectors. |
+| `generateScopeId(filename)` | Generate a deterministic scope ID from a filename. |
+
+See [docs/architecture.md](../../docs/architecture.md) for the full compilation pipeline.
+
+## License
+
+MIT