@neuralfog/elemix-template-formatter 0.9.0-dev.17

package/CHANGELOG.md

@@ -0,0 +1,148 @@
+# Changelog
+
+All notable changes to elemix and its companion packages are documented here. They
+share one version and release together, so they share one changelog. The format
+follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and this project adheres to [Semantic Versioning](https://semver.org/) when it suits me 😂😂😂.
+
+> The [Roadmap](https://github.com/neuralfog/elemix/blob/main/ROADMAP.md) is the full
+> log of development.
+
+## [0.9.0-dev.17] - 2026-07-10
+
+### Added
+
+- Formatter: new `@neuralfog/elemix-template-formatter` (`etf`) - a native formatter for the HTML inside `tpl`` templates
+
+### Changed
+
+- Compiler: the emitted registration call is now `$__defineComponent`, completing the `$__` prefixing of runtime imports
+
+## [0.9.0-dev.16] - 2026-07-09
+
+### Fixed
+
+- Analyzer: `#`/aliased imports from tsconfig `paths` now resolve, so an aliased component import no longer reads as a missing module
+
+## [0.9.0-dev.15] - 2026-07-09
+
+### Changed
+
+- Compiler/Runtime: every runtime function the compiled output imports is now `$__` prefixed (`$__template`, `$__setText`, `$__state` etc) so it can't clash with a user's own module-scope names
+
+## [0.9.0-dev.14] - 2026-07-08
+
+### Added
+
+- Runtime: new `match` directive - exhaustive pattern matching for templates. Works on string unions, enums, and tagged object unions (each branch gets the narrowed value)
+- Analyzer: flags a missing case, a wrong case, or a non-finite value (like a plain `string`). Use `choose` for open conditions
+
+### Changed
+
+- Compiler: primitive `#state` backing fields are now prefixed (`#__count`) so they can't clash with your own private properties
+
+## [0.9.0-dev.13] - 2026-07-07
+
+### Added
+
+- Runtime: `createApp(root?)` bootstrap with chainable `.config({ … })` / `.mount(target?)`; app-wide config lives on `window.__elemix__` (the root and both calls are optional, so `createApp().config({ … })` is valid)
+- Runtime: automatic cloaking - elemix adopts a `[data-cloak], :not(:defined) { visibility: hidden }` stylesheet so elements don't flash before they upgrade and mount, with no per-app CSS; `config({ cloak: '…' })` replaces the rule with a custom CSS string
+- Runtime: `config({ shadow: false })` makes components render to light DOM by default (shadow DOM stays the default otherwise)
+- Compiler: new `#shadow` hint forces a shadow root even under a light-DOM default; it is mutually exclusive with `#no-shadow`, and using both on one component is a compile error
+- Analyzer: reports `#shadow` and `#no-shadow` on the same component as an error
+
+### Changed
+
+- Storybook: ditched lit - `@neuralfog/elemix-storybook` and the storybook config now run on `@storybook/html-vite` instead of `@storybook/web-components-vite`, dropping lit-html from the dependency tree entirely (elemix always rendered plain string/Node, so lit was never used)
+
+## [0.9.0-dev.12] - 2026-06-30
+
+### Fixed
+
+- Runtime: custom events (`@my-event`) now work; `_event` falls back to `addEventListener` when there is no `on*` property
+
+## [0.9.0-dev.11] - 2026-06-30
+
+### Fixed
+
+- Compiler: multi-root conditional branches now render every root (only the first was kept before)
+
+## [0.9.0-dev.10] - 2026-06-30
+
+### Fixed
+
+- Compiler: helper templates are now inlined inside a method-form `template()` (the splice pre-pass previously only saw the `template = () =>` arrow field, so helpers in a method template were left as runtime calls returning uncompiled `tpl` and threw)
+- Compiler: a helper call nested inside another template (e.g. a `${cond ? tpl\`…${this.row(x)}…\` : tpl\`\`}` branch) is now inlined; the splice recurses into nested template holes instead of copying them verbatim
+
+## [0.9.0-dev.9] - 2026-06-30
+
+### Fixed
+
+- Compiler: a `template()` method now lowers to `view()` like the `template = () =>` arrow field; previously only the arrow field was compiled, so the method form was left uncompiled and threw at runtime
+
+## [0.9.0-dev.8] - 2026-06-24
+
+### Added
+
+- `@neuralfog/elemix-analyzer` - static analysis tool for elemix
+
+## [0.9.0-dev.7] - 2026-06-22
+
+### Changed
+
+- WASM package ships its own README
+
+## [0.9.0-dev.6] - 2026-06-22
+
+### Added
+
+- Prebuilt binaries attached to every GitHub release
+
+## [0.9.0-dev.5] - 2026-06-22
+
+### Fixed
+
+- Compiler hint detection in the Vite plugin
+
+## [0.9.0-dev.4] - 2026-06-22
+
+### Added
+
+- Compiler hints: `#component`/`#tag`/`#form`/`#no-shadow`/`#styles`/`#state`/`#effect` + lifecycle `#before-mount`/`#mount`/`#dispose`
+- Reactive primitives in component `#state` (`count = 0` stays reactive)
+- Component inheritance - hooks/effects chain through `super`, stylesheets merge
+- Collections in reactive state (`Set`/`Map`/`WeakSet`/`WeakMap`), classes in state, `raw()` helper
+- Source maps back to the original source
+- Inlined compiler diagnostics with `--strict`; CLI version banner
+
+### Changed
+
+- Performance optimisations
+
+### Fixed
+
+- Nested arrays in deep state, template-less pragma components, statements before `return`, dangling `Cargo.lock`
+
+## [0.9.0-dev.3] - 2026-06-16
+
+### Added
+
+- Comment pragmas, effects, source maps
+
+## [0.9.0-dev.2] - 2026-06-15
+
+### Added
+
+- Compiler hints
+
+## [0.9.0-dev.1] - 2026-06-14
+
+### Added
+
+- Optimisations
+
+## [0.9.0-dev.0] - 2026-06-14
+
+### Added
+
+- Initial release: compiled renderer

package/README.md

@@ -0,0 +1,27 @@
+# 🎀 Elemix Template Formatter ⚠️ **Experimental**
+
+A native formatter for the HTML inside ``tpl`...` `` tagged template literals in [Elemix](https://www.npmjs.com/package/@neuralfog/elemix) components. It reformats just the template markup and leaves every `${…}` hole and all surrounding TypeScript byte-for-byte untouched.
+
+This package ships a **prebuilt static binary** — no Rust toolchain required. Installing pulls in exactly one platform binary via `optionalDependencies`:
+
+| Platform | Package |
+| --- | --- |
+| linux x64 | `@neuralfog/elemix-template-formatter-linux-x64` |
+| linux arm64 | `@neuralfog/elemix-template-formatter-linux-arm64` |
+| macOS x64 | `@neuralfog/elemix-template-formatter-darwin-x64` |
+| macOS arm64 | `@neuralfog/elemix-template-formatter-darwin-arm64` |
+| Windows x64 | `@neuralfog/elemix-template-formatter-win32-x64` |
+| Windows arm64 | `@neuralfog/elemix-template-formatter-win32-arm64` |
+
+## Usage
+
+Installs two equivalent commands — `etf` (short) and `elemix-template-formatter`:
+
+```sh
+etf --dirs src            # lint: print a diff, exit 1 if anything is unformatted
+etf --dirs src --write    # fix: rewrite files in place
+etf --stdin               # format stdin to stdout, silently (editor format-on-save)
+etf --lsp                 # emit formatting diagnostics as JSON (editor squiggles)
+```
+
+Exits non-zero when a file needs formatting, so it drops straight into CI.

package/bin/elemix-template-formatter.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// Launcher: resolve the prebuilt binary for this host from the matching platform
+// package (installed via optionalDependencies) and exec it, forwarding argv and
+// the exit code untouched.
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+
+const require = createRequire(import.meta.url);
+const ext = process.platform === 'win32' ? '.exe' : '';
+const pkg = `@neuralfog/elemix-template-formatter-${process.platform}-${process.arch}`;
+
+let bin;
+try {
+    // Resolve the package.json (always present, no exports gate) and sit the
+    // binary next to it - the binary itself has no extension, so it cannot be
+    // require.resolve'd directly.
+    bin = join(
+        dirname(require.resolve(`${pkg}/package.json`)),
+        `elemix-template-formatter${ext}`,
+    );
+} catch {
+    console.error(
+        `elemix-template-formatter: no prebuilt binary for ${process.platform}-${process.arch} ` +
+            `(missing optional dependency ${pkg}).`,
+    );
+    process.exit(1);
+}
+
+const { status, error } = spawnSync(bin, process.argv.slice(2), {
+    stdio: 'inherit',
+});
+if (error) {
+    console.error(
+        `elemix-template-formatter: failed to launch ${bin}: ${error.message}`,
+    );
+    process.exit(1);
+}
+process.exit(status ?? 1);

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@neuralfog/elemix-template-formatter",
+  "version": "0.9.0-dev.17",
+  "description": "HTML template formatter for Elemix tpl`` literals (etf)",
+  "license": "MIT",
+  "author": "brownhounds",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neuralfog/elemix.git"
+  },
+  "type": "module",
+  "bin": {
+    "etf": "bin/elemix-template-formatter.mjs",
+    "elemix-template-formatter": "bin/elemix-template-formatter.mjs"
+  },
+  "files": [
+    "bin/elemix-template-formatter.mjs",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "optionalDependencies": {
+    "@neuralfog/elemix-template-formatter-linux-x64": "0.9.0-dev.17",
+    "@neuralfog/elemix-template-formatter-linux-arm64": "0.9.0-dev.17",
+    "@neuralfog/elemix-template-formatter-darwin-x64": "0.9.0-dev.17",
+    "@neuralfog/elemix-template-formatter-darwin-arm64": "0.9.0-dev.17",
+    "@neuralfog/elemix-template-formatter-win32-x64": "0.9.0-dev.17",
+    "@neuralfog/elemix-template-formatter-win32-arm64": "0.9.0-dev.17"
+  }
+}