include caveat

improve build-time tags collection
* works better with types * works with Vite hot reload!
2024-11-10 10:08:34 -05:00 · 2024-11-10 10:06:14 -05:00 · 2024-11-10 10:04:51 -05:00 · 2024-11-10 09:08:34 -05:00 · 2024-11-10 09:08:23 -05:00 · 2024-11-07 22:04:25 -05:00
14 changed files with 421 additions and 1649 deletions
@@ -17,6 +17,8 @@
 	},
 	"devDependencies": {
 		"@preact/preset-vite": "^2.5.0",
+		"@types/node": "^22.9.0",
+		"tsx": "^4.19.2",
 		"typescript": "^5.3.3",
 		"vite": "^5.4.10"
 	}
@@ -32,13 +32,19 @@ importers:
    devDependencies:
      '@preact/preset-vite':
        specifier: ^2.5.0
-        version: 2.9.1(@babel/core@7.26.0)(preact@10.24.3)(vite@5.4.10)
+        version: 2.9.1(@babel/core@7.26.0)(preact@10.24.3)(vite@5.4.10(@types/node@22.9.0))
+      '@types/node':
+        specifier: ^22.9.0
+        version: 22.9.0
+      tsx:
+        specifier: ^4.19.2
+        version: 4.19.2
      typescript:
        specifier: ^5.3.3
        version: 5.6.3
      vite:
        specifier: ^5.4.10
-        version: 5.4.10
+        version: 5.4.10(@types/node@22.9.0)

 packages:

@@ -199,138 +205,282 @@ packages:
    cpu: [ppc64]
    os: [aix]

+  '@esbuild/aix-ppc64@0.23.1':
+    resolution: {integrity: sha512-6VhYk1diRqrhBAqpJEdjASR/+WVRtfjpqKuNw11cLiaWpAT/Uu+nokB+UJnevzy/P9C/ty6AOe0dwueMrGh/iQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
  '@esbuild/android-arm64@0.21.5':
    resolution: {integrity: sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==}
    engines: {node: '>=12'}
    cpu: [arm64]
    os: [android]

+  '@esbuild/android-arm64@0.23.1':
+    resolution: {integrity: sha512-xw50ipykXcLstLeWH7WRdQuysJqejuAGPd30vd1i5zSyKK3WE+ijzHmLKxdiCMtH1pHz78rOg0BKSYOSB/2Khw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
  '@esbuild/android-arm@0.21.5':
    resolution: {integrity: sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==}
    engines: {node: '>=12'}
    cpu: [arm]
    os: [android]

+  '@esbuild/android-arm@0.23.1':
+    resolution: {integrity: sha512-uz6/tEy2IFm9RYOyvKl88zdzZfwEfKZmnX9Cj1BHjeSGNuGLuMD1kR8y5bteYmwqKm1tj8m4cb/aKEorr6fHWQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
  '@esbuild/android-x64@0.21.5':
    resolution: {integrity: sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [android]

+  '@esbuild/android-x64@0.23.1':
+    resolution: {integrity: sha512-nlN9B69St9BwUoB+jkyU090bru8L0NA3yFvAd7k8dNsVH8bi9a8cUAUSEcEEgTp2z3dbEDGJGfP6VUnkQnlReg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
  '@esbuild/darwin-arm64@0.21.5':
    resolution: {integrity: sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==}
    engines: {node: '>=12'}
    cpu: [arm64]
    os: [darwin]

+  '@esbuild/darwin-arm64@0.23.1':
+    resolution: {integrity: sha512-YsS2e3Wtgnw7Wq53XXBLcV6JhRsEq8hkfg91ESVadIrzr9wO6jJDMZnCQbHm1Guc5t/CdDiFSSfWP58FNuvT3Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
  '@esbuild/darwin-x64@0.21.5':
    resolution: {integrity: sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [darwin]

+  '@esbuild/darwin-x64@0.23.1':
+    resolution: {integrity: sha512-aClqdgTDVPSEGgoCS8QDG37Gu8yc9lTHNAQlsztQ6ENetKEO//b8y31MMu2ZaPbn4kVsIABzVLXYLhCGekGDqw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
  '@esbuild/freebsd-arm64@0.21.5':
    resolution: {integrity: sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==}
    engines: {node: '>=12'}
    cpu: [arm64]
    os: [freebsd]

+  '@esbuild/freebsd-arm64@0.23.1':
+    resolution: {integrity: sha512-h1k6yS8/pN/NHlMl5+v4XPfikhJulk4G+tKGFIOwURBSFzE8bixw1ebjluLOjfwtLqY0kewfjLSrO6tN2MgIhA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
  '@esbuild/freebsd-x64@0.21.5':
    resolution: {integrity: sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [freebsd]

+  '@esbuild/freebsd-x64@0.23.1':
+    resolution: {integrity: sha512-lK1eJeyk1ZX8UklqFd/3A60UuZ/6UVfGT2LuGo3Wp4/z7eRTRYY+0xOu2kpClP+vMTi9wKOfXi2vjUpO1Ro76g==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
  '@esbuild/linux-arm64@0.21.5':
    resolution: {integrity: sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==}
    engines: {node: '>=12'}
    cpu: [arm64]
    os: [linux]

+  '@esbuild/linux-arm64@0.23.1':
+    resolution: {integrity: sha512-/93bf2yxencYDnItMYV/v116zff6UyTjo4EtEQjUBeGiVpMmffDNUyD9UN2zV+V3LRV3/on4xdZ26NKzn6754g==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
  '@esbuild/linux-arm@0.21.5':
    resolution: {integrity: sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==}
    engines: {node: '>=12'}
    cpu: [arm]
    os: [linux]

+  '@esbuild/linux-arm@0.23.1':
+    resolution: {integrity: sha512-CXXkzgn+dXAPs3WBwE+Kvnrf4WECwBdfjfeYHpMeVxWE0EceB6vhWGShs6wi0IYEqMSIzdOF1XjQ/Mkm5d7ZdQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
  '@esbuild/linux-ia32@0.21.5':
    resolution: {integrity: sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==}
    engines: {node: '>=12'}
    cpu: [ia32]
    os: [linux]

+  '@esbuild/linux-ia32@0.23.1':
+    resolution: {integrity: sha512-VTN4EuOHwXEkXzX5nTvVY4s7E/Krz7COC8xkftbbKRYAl96vPiUssGkeMELQMOnLOJ8k3BY1+ZY52tttZnHcXQ==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
  '@esbuild/linux-loong64@0.21.5':
    resolution: {integrity: sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==}
    engines: {node: '>=12'}
    cpu: [loong64]
    os: [linux]

+  '@esbuild/linux-loong64@0.23.1':
+    resolution: {integrity: sha512-Vx09LzEoBa5zDnieH8LSMRToj7ir/Jeq0Gu6qJ/1GcBq9GkfoEAoXvLiW1U9J1qE/Y/Oyaq33w5p2ZWrNNHNEw==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
  '@esbuild/linux-mips64el@0.21.5':
    resolution: {integrity: sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==}
    engines: {node: '>=12'}
    cpu: [mips64el]
    os: [linux]

+  '@esbuild/linux-mips64el@0.23.1':
+    resolution: {integrity: sha512-nrFzzMQ7W4WRLNUOU5dlWAqa6yVeI0P78WKGUo7lg2HShq/yx+UYkeNSE0SSfSure0SqgnsxPvmAUu/vu0E+3Q==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
  '@esbuild/linux-ppc64@0.21.5':
    resolution: {integrity: sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==}
    engines: {node: '>=12'}
    cpu: [ppc64]
    os: [linux]

+  '@esbuild/linux-ppc64@0.23.1':
+    resolution: {integrity: sha512-dKN8fgVqd0vUIjxuJI6P/9SSSe/mB9rvA98CSH2sJnlZ/OCZWO1DJvxj8jvKTfYUdGfcq2dDxoKaC6bHuTlgcw==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
  '@esbuild/linux-riscv64@0.21.5':
    resolution: {integrity: sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==}
    engines: {node: '>=12'}
    cpu: [riscv64]
    os: [linux]

+  '@esbuild/linux-riscv64@0.23.1':
+    resolution: {integrity: sha512-5AV4Pzp80fhHL83JM6LoA6pTQVWgB1HovMBsLQ9OZWLDqVY8MVobBXNSmAJi//Csh6tcY7e7Lny2Hg1tElMjIA==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
  '@esbuild/linux-s390x@0.21.5':
    resolution: {integrity: sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==}
    engines: {node: '>=12'}
    cpu: [s390x]
    os: [linux]

+  '@esbuild/linux-s390x@0.23.1':
+    resolution: {integrity: sha512-9ygs73tuFCe6f6m/Tb+9LtYxWR4c9yg7zjt2cYkjDbDpV/xVn+68cQxMXCjUpYwEkze2RcU/rMnfIXNRFmSoDw==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
  '@esbuild/linux-x64@0.21.5':
    resolution: {integrity: sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [linux]

+  '@esbuild/linux-x64@0.23.1':
+    resolution: {integrity: sha512-EV6+ovTsEXCPAp58g2dD68LxoP/wK5pRvgy0J/HxPGB009omFPv3Yet0HiaqvrIrgPTBuC6wCH1LTOY91EO5hQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
  '@esbuild/netbsd-x64@0.21.5':
    resolution: {integrity: sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [netbsd]

+  '@esbuild/netbsd-x64@0.23.1':
+    resolution: {integrity: sha512-aevEkCNu7KlPRpYLjwmdcuNz6bDFiE7Z8XC4CPqExjTvrHugh28QzUXVOZtiYghciKUacNktqxdpymplil1beA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.23.1':
+    resolution: {integrity: sha512-3x37szhLexNA4bXhLrCC/LImN/YtWis6WXr1VESlfVtVeoFJBRINPJ3f0a/6LV8zpikqoUg4hyXw0sFBt5Cr+Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
  '@esbuild/openbsd-x64@0.21.5':
    resolution: {integrity: sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [openbsd]

+  '@esbuild/openbsd-x64@0.23.1':
+    resolution: {integrity: sha512-aY2gMmKmPhxfU+0EdnN+XNtGbjfQgwZj43k8G3fyrDM/UdZww6xrWxmDkuz2eCZchqVeABjV5BpildOrUbBTqA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
  '@esbuild/sunos-x64@0.21.5':
    resolution: {integrity: sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [sunos]

+  '@esbuild/sunos-x64@0.23.1':
+    resolution: {integrity: sha512-RBRT2gqEl0IKQABT4XTj78tpk9v7ehp+mazn2HbUeZl1YMdaGAQqhapjGTCe7uw7y0frDi4gS0uHzhvpFuI1sA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
  '@esbuild/win32-arm64@0.21.5':
    resolution: {integrity: sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==}
    engines: {node: '>=12'}
    cpu: [arm64]
    os: [win32]

+  '@esbuild/win32-arm64@0.23.1':
+    resolution: {integrity: sha512-4O+gPR5rEBe2FpKOVyiJ7wNDPA8nGzDuJ6gN4okSA1gEOYZ67N8JPk58tkWtdtPeLz7lBnY6I5L3jdsr3S+A6A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
  '@esbuild/win32-ia32@0.21.5':
    resolution: {integrity: sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==}
    engines: {node: '>=12'}
    cpu: [ia32]
    os: [win32]

+  '@esbuild/win32-ia32@0.23.1':
+    resolution: {integrity: sha512-BcaL0Vn6QwCwre3Y717nVHZbAa4UBEigzFm6VdsVdT/MbZ38xoj1X9HPkZhbmaBGUD1W8vxAfffbDe8bA6AKnQ==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
  '@esbuild/win32-x64@0.21.5':
    resolution: {integrity: sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==}
    engines: {node: '>=12'}
    cpu: [x64]
    os: [win32]

+  '@esbuild/win32-x64@0.23.1':
+    resolution: {integrity: sha512-BHpFFeslkWrXWyUPnbKm+xYYVYruCinGcftSBaa8zoF9hZO4BcSCFUvHVTtzpIY6YzUnYtuEhZ+C9iEXjxnasg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
  '@fontsource/roboto@5.1.0':
    resolution: {integrity: sha512-cFRRC1s6RqPygeZ8Uw/acwVHqih8Czjt6Q0MwoUoDe9U3m4dH1HmNDRBZyqlMSFwgNAUKgFImncKdmDHyKpwdg==}

@@ -555,6 +705,9 @@ packages:
  '@types/estree@1.0.6':
    resolution: {integrity: sha512-AYnb1nQyY49te+VRAVgmzfcgjYS91mY5P0TKUDCLEM+gNnA+3T6rWITXRLYCpahpqSQbN5cE+gHpnPyXjHWxcw==}

+  '@types/node@22.9.0':
+    resolution: {integrity: sha512-vuyHg81vvWA1Z1ELfvLko2c8f34gyA0zaic0+Rllc5lbCnbSyuvb2Oxpm6TAUAC/2xZN3QGqxBNggD1nNR2AfQ==}
+
  '@types/parse-json@4.0.2':
    resolution: {integrity: sha512-dISoDXWWQwUquiKsyZ4Ng+HX2KsPL7LyHKHQwgGFEA3IaKac4Obd+h2a/a6waisAoepJlBcx9paWqjA8/HVjCw==}

@@ -655,6 +808,11 @@ packages:
    engines: {node: '>=12'}
    hasBin: true

+  esbuild@0.23.1:
+    resolution: {integrity: sha512-VVNz/9Sa0bs5SELtn3f7qhJCDPCF5oMEl5cO9/SSinpE9hbPVvxbd572HH5AKiP7WD8INO53GgfDDhRjkylHEg==}
+    engines: {node: '>=18'}
+    hasBin: true
+
  escalade@3.2.0:
    resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==}
    engines: {node: '>=6'}
@@ -681,6 +839,9 @@ packages:
    resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==}
    engines: {node: '>=6.9.0'}

+  get-tsconfig@4.8.1:
+    resolution: {integrity: sha512-k9PN+cFBmaLWtVz29SkUoqU5O0slLuHJXt/2P+tMVFT+phsSGXGkp9t3rQIqdz0e+06EHNGs3oM6ZX1s2zHxRg==}
+
  globals@11.12.0:
    resolution: {integrity: sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==}
    engines: {node: '>=4'}
@@ -832,6 +993,9 @@ packages:
    resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==}
    engines: {node: '>=4'}

+  resolve-pkg-maps@1.0.0:
+    resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
  resolve@1.22.8:
    resolution: {integrity: sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==}
    hasBin: true
@@ -871,11 +1035,19 @@ packages:
    resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
    engines: {node: '>= 0.4'}

+  tsx@4.19.2:
+    resolution: {integrity: sha512-pOUl6Vo2LUq/bSa8S5q7b91cgNSjctn9ugq/+Mvow99qW6x/UZYwzxy/3NmqoT66eHYfCVvFvACC58UBPFf28g==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
  typescript@5.6.3:
    resolution: {integrity: sha512-hjcS1mhfuyi4WW8IWtjP7brDrG2cuDZukyrYrSauoXGNgx0S7zceP07adYkJycEr56BOUTNPzbInooiN3fn1qw==}
    engines: {node: '>=14.17'}
    hasBin: true

+  undici-types@6.19.8:
+    resolution: {integrity: sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==}
+
  update-browserslist-db@1.1.1:
    resolution: {integrity: sha512-R8UzCaa9Az+38REPiJ1tXlImTJXlVfgHZsglwBD/k6nj76ctsH1E3q4doGrukiLQd3sGQYu56r5+lo5r94l29A==}
    hasBin: true
@@ -1144,72 +1316,144 @@ snapshots:
  '@esbuild/aix-ppc64@0.21.5':
    optional: true

+  '@esbuild/aix-ppc64@0.23.1':
+    optional: true
+
  '@esbuild/android-arm64@0.21.5':
    optional: true

+  '@esbuild/android-arm64@0.23.1':
+    optional: true
+
  '@esbuild/android-arm@0.21.5':
    optional: true

+  '@esbuild/android-arm@0.23.1':
+    optional: true
+
  '@esbuild/android-x64@0.21.5':
    optional: true

+  '@esbuild/android-x64@0.23.1':
+    optional: true
+
  '@esbuild/darwin-arm64@0.21.5':
    optional: true

+  '@esbuild/darwin-arm64@0.23.1':
+    optional: true
+
  '@esbuild/darwin-x64@0.21.5':
    optional: true

+  '@esbuild/darwin-x64@0.23.1':
+    optional: true
+
  '@esbuild/freebsd-arm64@0.21.5':
    optional: true

+  '@esbuild/freebsd-arm64@0.23.1':
+    optional: true
+
  '@esbuild/freebsd-x64@0.21.5':
    optional: true

+  '@esbuild/freebsd-x64@0.23.1':
+    optional: true
+
  '@esbuild/linux-arm64@0.21.5':
    optional: true

+  '@esbuild/linux-arm64@0.23.1':
+    optional: true
+
  '@esbuild/linux-arm@0.21.5':
    optional: true

+  '@esbuild/linux-arm@0.23.1':
+    optional: true
+
  '@esbuild/linux-ia32@0.21.5':
    optional: true

+  '@esbuild/linux-ia32@0.23.1':
+    optional: true
+
  '@esbuild/linux-loong64@0.21.5':
    optional: true

+  '@esbuild/linux-loong64@0.23.1':
+    optional: true
+
  '@esbuild/linux-mips64el@0.21.5':
    optional: true

+  '@esbuild/linux-mips64el@0.23.1':
+    optional: true
+
  '@esbuild/linux-ppc64@0.21.5':
    optional: true

+  '@esbuild/linux-ppc64@0.23.1':
+    optional: true
+
  '@esbuild/linux-riscv64@0.21.5':
    optional: true

+  '@esbuild/linux-riscv64@0.23.1':
+    optional: true
+
  '@esbuild/linux-s390x@0.21.5':
    optional: true

+  '@esbuild/linux-s390x@0.23.1':
+    optional: true
+
  '@esbuild/linux-x64@0.21.5':
    optional: true

+  '@esbuild/linux-x64@0.23.1':
+    optional: true
+
  '@esbuild/netbsd-x64@0.21.5':
    optional: true

+  '@esbuild/netbsd-x64@0.23.1':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.23.1':
+    optional: true
+
  '@esbuild/openbsd-x64@0.21.5':
    optional: true

+  '@esbuild/openbsd-x64@0.23.1':
+    optional: true
+
  '@esbuild/sunos-x64@0.21.5':
    optional: true

+  '@esbuild/sunos-x64@0.23.1':
+    optional: true
+
  '@esbuild/win32-arm64@0.21.5':
    optional: true

+  '@esbuild/win32-arm64@0.23.1':
+    optional: true
+
  '@esbuild/win32-ia32@0.21.5':
    optional: true

+  '@esbuild/win32-ia32@0.23.1':
+    optional: true
+
  '@esbuild/win32-x64@0.21.5':
    optional: true

+  '@esbuild/win32-x64@0.23.1':
+    optional: true
+
  '@fontsource/roboto@5.1.0': {}

  '@jridgewell/gen-mapping@0.3.5':
@@ -1308,13 +1552,13 @@ snapshots:

  '@popperjs/core@2.11.8': {}

-  '@preact/preset-vite@2.9.1(@babel/core@7.26.0)(preact@10.24.3)(vite@5.4.10)':
+  '@preact/preset-vite@2.9.1(@babel/core@7.26.0)(preact@10.24.3)(vite@5.4.10(@types/node@22.9.0))':
    dependencies:
      '@babel/code-frame': 7.26.2
      '@babel/core': 7.26.0
      '@babel/plugin-transform-react-jsx': 7.25.9(@babel/core@7.26.0)
      '@babel/plugin-transform-react-jsx-development': 7.25.9(@babel/core@7.26.0)
-      '@prefresh/vite': 2.4.6(preact@10.24.3)(vite@5.4.10)
+      '@prefresh/vite': 2.4.6(preact@10.24.3)(vite@5.4.10(@types/node@22.9.0))
      '@rollup/pluginutils': 4.2.1
      babel-plugin-transform-hook-names: 1.0.2(@babel/core@7.26.0)
      debug: 4.3.7
@@ -1323,7 +1567,7 @@ snapshots:
      node-html-parser: 6.1.13
      source-map: 0.7.4
      stack-trace: 1.0.0-pre2
-      vite: 5.4.10
+      vite: 5.4.10(@types/node@22.9.0)
    transitivePeerDependencies:
      - preact
      - supports-color
@@ -1336,7 +1580,7 @@ snapshots:

  '@prefresh/utils@1.2.0': {}

-  '@prefresh/vite@2.4.6(preact@10.24.3)(vite@5.4.10)':
+  '@prefresh/vite@2.4.6(preact@10.24.3)(vite@5.4.10(@types/node@22.9.0))':
    dependencies:
      '@babel/core': 7.26.0
      '@prefresh/babel-plugin': 0.5.1
@@ -1344,7 +1588,7 @@ snapshots:
      '@prefresh/utils': 1.2.0
      '@rollup/pluginutils': 4.2.1
      preact: 10.24.3
-      vite: 5.4.10
+      vite: 5.4.10(@types/node@22.9.0)
    transitivePeerDependencies:
      - supports-color

@@ -1409,6 +1653,10 @@ snapshots:

  '@types/estree@1.0.6': {}

+  '@types/node@22.9.0':
+    dependencies:
+      undici-types: 6.19.8
+
  '@types/parse-json@4.0.2': {}

  '@types/prop-types@15.7.13': {}
@@ -1532,6 +1780,33 @@ snapshots:
      '@esbuild/win32-ia32': 0.21.5
      '@esbuild/win32-x64': 0.21.5

+  esbuild@0.23.1:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.23.1
+      '@esbuild/android-arm': 0.23.1
+      '@esbuild/android-arm64': 0.23.1
+      '@esbuild/android-x64': 0.23.1
+      '@esbuild/darwin-arm64': 0.23.1
+      '@esbuild/darwin-x64': 0.23.1
+      '@esbuild/freebsd-arm64': 0.23.1
+      '@esbuild/freebsd-x64': 0.23.1
+      '@esbuild/linux-arm': 0.23.1
+      '@esbuild/linux-arm64': 0.23.1
+      '@esbuild/linux-ia32': 0.23.1
+      '@esbuild/linux-loong64': 0.23.1
+      '@esbuild/linux-mips64el': 0.23.1
+      '@esbuild/linux-ppc64': 0.23.1
+      '@esbuild/linux-riscv64': 0.23.1
+      '@esbuild/linux-s390x': 0.23.1
+      '@esbuild/linux-x64': 0.23.1
+      '@esbuild/netbsd-x64': 0.23.1
+      '@esbuild/openbsd-arm64': 0.23.1
+      '@esbuild/openbsd-x64': 0.23.1
+      '@esbuild/sunos-x64': 0.23.1
+      '@esbuild/win32-arm64': 0.23.1
+      '@esbuild/win32-ia32': 0.23.1
+      '@esbuild/win32-x64': 0.23.1
+
  escalade@3.2.0: {}

  escape-string-regexp@4.0.0: {}
@@ -1547,6 +1822,10 @@ snapshots:

  gensync@1.0.0-beta.2: {}

+  get-tsconfig@4.8.1:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+
  globals@11.12.0: {}

  hasown@2.0.2:
@@ -1680,6 +1959,8 @@ snapshots:

  resolve-from@4.0.0: {}

+  resolve-pkg-maps@1.0.0: {}
+
  resolve@1.22.8:
    dependencies:
      is-core-module: 2.15.1
@@ -1728,20 +2009,30 @@ snapshots:

  supports-preserve-symlinks-flag@1.0.0: {}

+  tsx@4.19.2:
+    dependencies:
+      esbuild: 0.23.1
+      get-tsconfig: 4.8.1
+    optionalDependencies:
+      fsevents: 2.3.3
+
  typescript@5.6.3: {}

+  undici-types@6.19.8: {}
+
  update-browserslist-db@1.1.1(browserslist@4.24.2):
    dependencies:
      browserslist: 4.24.2
      escalade: 3.2.0
      picocolors: 1.1.1

-  vite@5.4.10:
+  vite@5.4.10(@types/node@22.9.0):
    dependencies:
      esbuild: 0.21.5
      postcss: 8.4.47
      rollup: 4.24.3
    optionalDependencies:
+      '@types/node': 22.9.0
      fsevents: 2.3.3

  yallist@3.1.1: {}
@@ -0,0 +1,3 @@
+export function Article({ children }) {
+  return <div>Article</div>;
+}
@@ -0,0 +1,3 @@
+export function Heading({ children }) {
+  return <h2>Heading</h2>;
+}
@@ -0,0 +1,3 @@
+export function Paragraph({ children }) {
+  return <p>Paragraph</p>;
+}
@@ -0,0 +1,3 @@
+export function Title({ children }) {
+  return <h1>Title</h1>;
+}
@@ -1,7 +1,7 @@
 import { Container } from "@mui/material";
-import { SearchHeader } from "./SearchHeader/SearchHeader";
-import { SearchResults } from "./SearchResults/SearchResults";
-import { ChosenArticle } from "./ChosenArticle/ChosenArticle";
+import { SearchHeader } from "./SearchHeader/SearchHeader.js";
+import { SearchResults } from "./SearchResults/SearchResults.js";
+import { ChosenArticle } from "./ChosenArticle/ChosenArticle.js";

 export function Blog() {
  return (
@@ -1,12 +1,12 @@
-import Box from "@mui/material/Box";
-import { SearchRow } from "./SearchRow/SearchRow";
-import { TagCloud } from "./TagCloud/TagCloud";
+import Stack from "@mui/material/Stack";
+import { SearchRow } from "./SearchRow/SearchRow.js";
+import { TagCloud } from "./TagCloud/TagCloud.js";

 export function SearchHeader() {
  return (
-    <Box class="search-header">
+    <Stack class="search-header" spacing={2}>
      <SearchRow />
      <TagCloud />
-    </Box>
+    </Stack>
  );
 }
@@ -1,5 +1,5 @@
 import TextField from "@mui/material/TextField";

 export function SearchTextBox() {
-  return <TextField variant="outlined" label="Search Articles" />;
+  return <TextField variant="outlined" label="Search Articles" fullWidth />;
 }
@@ -1,5 +1,15 @@
 import Box from "@mui/material/Box";
+import { tags } from "../../../tags.js";

 export function TagCloud() {
-  return <Box class="tag-cloud">Tags</Box>;
+  return (
+    <Box class="tag-cloud">
+      Tags
+      <ul>
+        {[...tags.values()].map((tag) => (
+          <li key={tag}>{tag}</li>
+        ))}
+      </ul>
+    </Box>
+  );
 }
@@ -0,0 +1,67 @@
+import { Article } from "../Article/Article.js";
+import { Heading } from "../Article/Heading/Heading.js";
+import { Paragraph } from "../Article/Paragraph/Paragraph.js";
+import { Title } from "../Article/Title/Title.js";
+
+export const tags = ["pnpm", "preact", "vite", "typescript"];
+
+export default function () {
+  return (
+    <Article>
+      <Title>Bootstrapping This Clog</Title>
+      <Heading>
+        <pre>pnpx create-preact</pre>
+      </Heading>
+      <Paragraph>
+        I'll begin straight-away with some design decisions.
+      </Paragraph>
+      <Paragraph>
+        I chose <pre>preact</pre> instead of React because of its small size and
+        good performance, despite its near-feature-parity with React.
+      </Paragraph>
+      <Paragraph>
+        I used the default <pre>create-preact</pre> bootstrapper because I had
+        already decided to use Vite as a bundler, and indeed
+        <pre>create-preact</pre> sets up Vite (among other things). The reason I
+        wanted to use Vite is because I wanted this clog to be a simple
+        Single-Page Application (SPA), so I didn't need bells-and-whistles
+        beyond Vite's sane defaults; and of course it's very fast ("vite" means
+        "fast" in French), which helps me keep my focus during development. I
+        tend to daydream if it takes more than 2-3 seconds.
+      </Paragraph>
+      <Paragraph>
+        I also had <pre>create-preact</pre> setup Typescript, which is almost
+        universally accepted as "the right thing to do". In my particular case,
+        I can use it to enforce a certain structure to the blog, as I'll try to
+        explain below.
+      </Paragraph>
+      <Heading>The Clog's Structure</Heading>
+      <Paragraph>
+        Each Article is to have two types of content: Prose, which are typical
+        blog articles such as this one, wherein prose is the centerpiece and
+        code is interspersed as a complement, much like figures in a textbook;
+        and Codes, which are code-centric and are complemented by explanatory
+        prose. Each Article will have a switch widget to switch between the two.
+      </Paragraph>
+      <Paragraph>
+        Articles have a Title, followed by a one or more Sections, each of which
+        has a Heading followed by one or more Paragraphs or CodeBlocks.
+      </Paragraph>
+      <Paragraph>
+        Codes, however, are meant to be more interactive. Their utility comes
+        from selectively displaying code and explanatory text. Each Article may
+        develop multiple files, not all of which are of interest to the reader.
+        So when in "Codes" mode, the reader is presented with a list of Files
+        produced in the writing of the article.
+      </Paragraph>
+      <Paragraph>
+        Each File has a language (for syntax highlighting) and is composed of
+        numbered Lines. They also have CodeComments, which target any
+        combination of Lines (they don't even have to be contiguous).
+        Mousing-over a Line displays all the CodeComment ranges on the right
+        margin of the code; the ranges represented by straight lines, and the
+        ranges appearing side-by-side from left to right.
+      </Paragraph>
+    </Article>
+  );
+}
@@ -0,0 +1,17 @@
+// !!NOTE: This `import.meta.glob` is currently a Vite-only feature.
+const modules = import.meta.glob<Array<string>>("./articles/*", {
+  import: "tags",
+  eager: true,
+});
+
+export const tags = Object.entries(modules).reduce(
+  (tagsSet, [modulePath, moduleTags]) => {
+    if (moduleTags) {
+      for (const tag of moduleTags) {
+        tagsSet.add(tag);
+      }
+    }
+    return tagsSet;
+  },
+  new Set<string>()
+);
@@ -1,5 +1,5 @@
-import { defineConfig } from 'vite';
-import preact from '@preact/preset-vite';
+import { defineConfig } from "vite";
+import preact from "@preact/preset-vite";

 // https://vitejs.dev/config/
 export default defineConfig({
Author	SHA1	Message	Date
Avraham Sakal	27d78928ea	include caveat	2024-11-10 10:08:34 -05:00
Avraham Sakal	0613a657a8	improve build-time tags collection * works better with types * works with Vite hot reload!	2024-11-10 10:06:14 -05:00
Avraham Sakal	cdb7c8f15c	create vite plugin to collect article tags at build-time	2024-11-10 10:04:51 -05:00
Avraham Sakal	921a8a1354	append `.js` to imports	2024-11-10 09:08:34 -05:00
Avraham Sakal	9e738b4e43	begin `Article` components and subcomponents	2024-11-10 09:08:23 -05:00
Avraham Sakal	4842b117b4	header looks okay	2024-11-07 22:04:25 -05:00