feat: add Nix development flake with Neovim config

Author: a-h

.dockerignore

@@ -0,0 +1,3 @@
+.git
+Dockerfile
+.dockerignore

Dockerfile

@@ -0,0 +1,11 @@
+FROM nixos/nix
+RUN nix-channel --update
+COPY ./nix/nix.conf /etc/nix/nix.conf
+RUN mkdir /templ
+COPY . /templ
+WORKDIR /templ
+RUN nix develop --impure --command printf "Build complete\n"
+COPY ./nix/.config /root/.config
+# Open port for templ LSP HTTP debugging
+EXPOSE 7474
+CMD nix develop --impure

README.md

@@ -645,6 +645,14 @@ To add extensive debug information, you can include additional args to the LSP,
 
 ## Tasks
 
+### nix-develop
+
+Run a Nix shell that contains everything required to build templ.
+
+```sh
+nix develop --impure
+```
+
 ### build
 
 Build a local version.
@@ -743,6 +751,22 @@ Directory: docs
 npm run build
 ```
 
+### docker-build
+
+Build a Docker container with a full development environment and Neovim setup for testing the LSP.
+
+```
+docker build -t templ:latest .
+```
+
+### docker-run
+
+Run a Docker development container in the current directory.
+
+```
+docker run -p 7474:7474 -v `pwd`:/templ -it --rm templ:latest
+```
+
 # Code signing
 
 The binaries are created by me and signed by my GPG key. You can verify with my key https://adrianhesketh.com/a-h.gpg

cmd/templ/lspcmd/proxy/documentcontents.go

@@ -146,6 +146,10 @@ func (d *Document) String() string {
 	return strings.Join(d.Lines, "\n")
 }
 
+func (d *Document) Replace(with string) {
+	d.Lines = strings.Split(with, "\n")
+}
+
 func (d *Document) Apply(r *lsp.Range, with string) {
 	withLines := strings.Split(with, "\n")
 	d.normalize(r)

cmd/templ/lspcmd/proxy/server.go

@@ -631,6 +631,7 @@ func (p *Server) Formatting(ctx context.Context, params *lsp.DocumentFormattingP
 		},
 		NewText: w.String(),
 	})
+	d.Replace(w.String())
 	return
 }
 

docs/docs/syntax-and-usage/for.md

@@ -0,0 +1,25 @@
+---
+sidebar_position: 4
+---
+
+# For loops
+
+templ supports iterating over slices, arrays and channels etc. using the for loop:
+
+```templ
+templ listNames(items []Item) {
+  <ul>
+  for _, item := range items {
+    <li>{ item.Name }</li>
+  }
+  </ul>
+}
+```
+
+```html
+<ul>
+  <li>A</li>
+  <li>B</li>
+  <li>C</li>
+</ul>
+```

docs/docs/syntax-and-usage/loops.md

@@ -0,0 +1,66 @@
+{
+  inputs = {
+    flake-utils.url = "github:numtide/flake-utils";
+    nixpkgs.url = "nixpkgs/nixos-22.11";
+    xc = {
+      url = "github:joerdav/xc";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+    go = {
+      url = "github:a-h/nix-golang";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+    neovim-nightly-overlay = {
+      url = "github:nix-community/neovim-nightly-overlay";
+      inputs.nixpkgs.follows = "nixpkgs";
+      # Neovim 0.9.0
+      inputs.neovim-flake.url = "github:neovim/neovim?dir=contrib&rev=040f1459849ab05b04f6bb1e77b3def16b4c2f2b";
+    };
+  };
+
+  outputs = { self, flake-utils, nixpkgs, xc, go, neovim-nightly-overlay }:
+    flake-utils.lib.eachDefaultSystem (system:
+    let 
+      pkgsDefault = import nixpkgs { overlays = [ neovim-nightly-overlay.overlay ]; };
+        pkgs = import nixpkgs { 
+          inherit system; overlays = [ 
+            (self: super: {
+              xc = xc.packages.${system}.xc;
+              neovim = import ./nix/nvim.nix { pkgs = pkgsDefault; };
+              go = go.packages.${system}.go_1_20_3;
+              gopls = pkgs.callPackage ./nix/gopls.nix { };
+              templ = pkgs.callPackage ./nix/templ.nix { 
+                go = self.go; 
+                xc = self.xc;
+              };
+              nerdfonts = (pkgsDefault.nerdfonts.override { fonts = [ "IBMPlexMono" ]; });
+            })
+          ];
+        };
+        shell = pkgs.mkShell {
+            packages = [ 
+              pkgs.asciinema
+              pkgs.git
+              pkgs.go
+              pkgs.gopls
+              pkgs.gotools
+              pkgs.ibm-plex
+              pkgs.neovim
+              pkgs.nerdfonts
+              pkgs.ripgrep
+              pkgs.silver-searcher
+              pkgs.templ
+              pkgs.tmux
+              pkgs.wget
+              pkgs.xc
+              pkgs.zip
+            ];
+          };
+      in
+      {
+        devShells = {
+          default = shell;
+        };
+      }
+    );
+}