fix: migrate module paths to dappco.re

README.md

@@ -4,7 +4,7 @@
 
 # go-html
 
-HLCRF DOM compositor with grammar pipeline integration for server-side HTML generation and optional WASM client rendering. Provides a type-safe node tree (El, Text, Raw, If, Each, Switch, Entitled), a five-slot Header/Left/Content/Right/Footer layout compositor with deterministic `data-block` path IDs and ARIA roles, a responsive multi-variant wrapper, a server-side grammar pipeline (StripTags, GrammarImprint via go-i18n reversal, CompareVariants), a build-time Web Component codegen CLI, and a WASM module (2.90 MB raw, 842 KB gzip) exposing `renderToString()`.
+HLCRF DOM compositor with grammar pipeline integration for server-side HTML generation and optional WASM client rendering. Provides a type-safe node tree (El, Text, Raw, If, Each, Switch, Entitled, AriaLabel, AltText), a five-slot Header/Left/Content/Right/Footer layout compositor with deterministic `data-block` path IDs and ARIA roles, a responsive multi-variant wrapper, a server-side grammar pipeline (StripTags, GrammarImprint via go-i18n reversal, CompareVariants), a build-time Web Component codegen CLI, and a WASM module (2.90 MB raw, 842 KB gzip) exposing `renderToString()`.
 
 **Module**: `forge.lthn.ai/core/go-html`
 **Licence**: EUPL-1.2

bench_test.go

@@ -1,7 +1,6 @@
 package html
 
 import (
-	"fmt"
 	"testing"
 
 	i18n "dappco.re/go/core/i18n"
@@ -100,7 +99,7 @@ func BenchmarkImprint_Small(b *testing.B) {
 func BenchmarkImprint_Large(b *testing.B) {
 	items := make([]string, 20)
 	for i := range items {
-		items[i] = fmt.Sprintf("Item %d was created successfully", i)
+		items[i] = "Item " + itoaText(i) + " was created successfully"
 	}
 	page := NewLayout("HLCRF").
 		H(El("h1", Text("Building project"))).
@@ -207,7 +206,7 @@ func BenchmarkLayout_Nested(b *testing.B) {
 func BenchmarkLayout_ManySlotChildren(b *testing.B) {
 	nodes := make([]Node, 50)
 	for i := range nodes {
-		nodes[i] = El("p", Raw(fmt.Sprintf("paragraph %d", i)))
+		nodes[i] = El("p", Raw("paragraph "+itoaText(i)))
 	}
 	layout := NewLayout("HLCRF").
 		H(Raw("header")).
@@ -242,7 +241,7 @@ func benchEach(b *testing.B, n int) {
 		items[i] = i
 	}
 	node := Each(items, func(i int) Node {
-		return El("li", Raw(fmt.Sprintf("item-%d", i)))
+		return El("li", Raw("item-"+itoaText(i)))
 	})
 	ctx := NewContext()
 

cmd/codegen/main.go

@@ -1,43 +1,181 @@
-// Package main provides a build-time CLI for generating Web Component JS bundles.
-// Reads a JSON slot map from stdin, writes the generated JS to stdout.
+//go:build !js
+
+// Package main provides a build-time CLI for generating Web Component bundles.
+// Reads a JSON slot map from stdin, writes the generated JS or TypeScript to stdout.
 //
 // Usage:
 //
 //	echo '{"H":"nav-bar","C":"main-content"}' | go run ./cmd/codegen/ > components.js
+//	echo '{"H":"nav-bar","C":"main-content"}' | go run ./cmd/codegen/ -types > components.d.ts
+//	echo '{"H":"nav-bar","C":"main-content"}' | go run ./cmd/codegen/ -watch -input slots.json -output components.js
 package main
 
 import (
-	"encoding/json"
+	"context"
+	"errors"
+	"flag"
 	goio "io"
 	"os"
+	"os/signal"
+	"time"
 
+	core "dappco.re/go/core"
 	"dappco.re/go/core/html/codegen"
+	coreio "dappco.re/go/core/io"
 	log "dappco.re/go/core/log"
 )
 
-func run(r goio.Reader, w goio.Writer) error {
+func generate(data []byte, emitTypes bool) (string, error) {
+	var slots map[string]string
+	if result := core.JSONUnmarshal(data, &slots); !result.OK {
+		err, _ := result.Value.(error)
+		return "", log.E("codegen", "invalid JSON", err)
+	}
+
+	if emitTypes {
+		return codegen.GenerateTypeScriptDefinitions(slots), nil
+	}
+
+	out, err := codegen.GenerateBundle(slots)
+	if err != nil {
+		return "", log.E("codegen", "generate bundle", err)
+	}
+	return out, nil
+}
+
+func run(r goio.Reader, w goio.Writer, emitTypes bool) error {
 	data, err := goio.ReadAll(r)
 	if err != nil {
 		return log.E("codegen", "reading stdin", err)
 	}
 
-	var slots map[string]string
-	if err := json.Unmarshal(data, &slots); err != nil {
-		return log.E("codegen", "invalid JSON", err)
+	out, err := generate(data, emitTypes)
+	if err != nil {
+		return err
 	}
 
-	js, err := codegen.GenerateBundle(slots)
+	_, err = goio.WriteString(w, out)
+	if err != nil {
+		return log.E("codegen", "writing output", err)
+	}
+	return nil
+}
+
+func runDaemon(ctx context.Context, inputPath, outputPath string, emitTypes bool, pollInterval time.Duration) error {
+	if inputPath == "" {
+		return log.E("codegen", "watch mode requires -input", nil)
+	}
+	if outputPath == "" {
+		return log.E("codegen", "watch mode requires -output", nil)
+	}
+	if pollInterval <= 0 {
+		pollInterval = 250 * time.Millisecond
+	}
+
+	var lastInput []byte
+	for {
+		input, err := readLocalFile(inputPath)
+		if err != nil {
+			return log.E("codegen", "reading input file", err)
+		}
+
+		if !sameBytes(input, lastInput) {
+			out, err := generate(input, emitTypes)
+			if err != nil {
+				return err
+			}
+			if err := writeLocalFile(outputPath, out); err != nil {
+				return log.E("codegen", "writing output file", err)
+			}
+			lastInput = append(lastInput[:0], input...)
+		}
+
+		select {
+		case <-ctx.Done():
+			if errors.Is(ctx.Err(), context.Canceled) {
+				return nil
+			}
+			return ctx.Err()
+		case <-time.After(pollInterval):
+		}
+	}
+}
+
+func readLocalFile(path string) ([]byte, error) {
+	f, err := coreio.Local.Open(path)
+	if err != nil {
+		return nil, err
+	}
+	defer func() {
+		_ = f.Close()
+	}()
+
+	return goio.ReadAll(f)
+}
+
+func writeLocalFile(path, content string) error {
+	f, err := coreio.Local.Create(path)
 	if err != nil {
 		return err
 	}
+	defer func() {
+		_ = f.Close()
+	}()
 
-	_, err = goio.WriteString(w, js)
+	_, err = goio.WriteString(f, content)
 	return err
 }
 
+func sameBytes(a, b []byte) bool {
+	if len(a) != len(b) {
+		return false
+	}
+	for i := range len(a) {
+		if a[i] != b[i] {
+			return false
+		}
+	}
+	return true
+}
+
 func main() {
-	if err := run(os.Stdin, os.Stdout); err != nil {
-		log.Error("codegen failed", "err", err)
+	emitWatch := flag.Bool("watch", false, "poll input and rewrite output when the JSON changes")
+	inputPath := flag.String("input", "", "path to the JSON slot map used by -watch")
+	outputPath := flag.String("output", "", "path to the generated bundle written by -watch")
+	emitTypes := flag.Bool("types", false, "emit TypeScript declarations instead of JavaScript")
+	pollInterval := flag.Duration("poll", 250*time.Millisecond, "poll interval used by -watch")
+	flag.Parse()
+
+	if *emitWatch {
+		ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt)
+		defer stop()
+
+		if err := runDaemon(ctx, *inputPath, *outputPath, *emitTypes, *pollInterval); err != nil {
+			log.Error("codegen failed", "scope", "codegen.main", "err", err)
+			os.Exit(1)
+		}
+		return
+	}
+
+	stdin, err := coreio.Local.Open("/dev/stdin")
+	if err != nil {
+		log.Error("failed to open stdin", "scope", "codegen.main", "err", log.E("codegen.main", "open stdin", err))
+		os.Exit(1)
+	}
+
+	stdout, err := coreio.Local.Create("/dev/stdout")
+	if err != nil {
+		_ = stdin.Close()
+		log.Error("failed to open stdout", "scope", "codegen.main", "err", log.E("codegen.main", "open stdout", err))
+		os.Exit(1)
+	}
+	defer func() {
+		_ = stdin.Close()
+		_ = stdout.Close()
+	}()
+
+	if err := run(stdin, stdout, *emitTypes); err != nil {
+		log.Error("codegen failed", "scope", "codegen.main", "err", err)
 		os.Exit(1)
 	}
 }