feat: add Nix flake and improve installation options (#51)

- Add flake.nix for Nix package manager integration
- Document npx usage options in README
- Add prepare script to ensure build runs before publishing

Author: noamsto

README.md

@@ -28,6 +28,16 @@ Via npm:
 npm install -g @mistweaverco/kulala-fmt
 ```
 
+You can also run it directly without installation using npx:
+
+```sh
+# From npm registry
+npx @mistweaverco/kulala-fmt format file.http
+
+# Directly from GitHub
+npx github:mistweaverco/kulala-fmt format file.http
+```
+
 ## Usage
 
 kulala-fmt can `format` and `check` `.http` and `.rest` files.

flake.lock

@@ -0,0 +1,50 @@
+#NOTE: This is quite bad way to do this, but until Nix have a proper way to package bun projects it works. See https://github.com/NixOS/nixpkgs/issues/255890
+{
+  description = "A formatter for the Kulala language";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
+
+    flake-parts.url = "github:hercules-ci/flake-parts";
+    flake-parts.inputs.nixpkgs-lib.follows = "nixpkgs";
+  };
+
+  outputs = inputs @ {
+    self,
+    flake-parts,
+    ...
+  }:
+    flake-parts.lib.mkFlake {inherit inputs;} {
+      systems = ["x86_64-linux" "aarch64-linux" "x86_64-darwin" "aarch64-darwin"];
+
+      perSystem = {pkgs, ...}: let
+        # Create a simple wrapper script that uses npx to run kulala-fmt
+        kulala-fmt = pkgs.writeShellApplication {
+          name = "kulala-fmt";
+          runtimeInputs = [pkgs.nodejs];
+          text = ''
+            # Run kulala-fmt using npx
+            exec npx github:mistweaverco/kulala-fmt "$@"
+          '';
+        };
+      in {
+        packages = {
+          default = kulala-fmt;
+          kulala-fmt = kulala-fmt;
+        };
+
+        devShells.default = pkgs.mkShell {
+          buildInputs = [
+            pkgs.nodejs
+            pkgs.bun
+          ];
+
+          shellHook = ''
+            echo "Kulala formatter development environment"
+            echo "Run 'bun install' to install dependencies"
+            echo "Run 'bun run build' to build the project"
+          '';
+        };
+      };
+    };
+}

flake.nix

@@ -4,7 +4,8 @@
   "type": "module",
   "scripts": {
     "build": "rollup -c",
-    "lint": "eslint ."
+    "lint": "eslint .",
+    "prepare": "rollup -c"
   },
   "bin": {
     "kulala-fmt": "dist/cli.cjs"