fix: docs build failure and add local example validation

docs/docs/layouts.md

@@ -85,7 +85,7 @@ This example uses the following code:
 
 (defn
   border-title
-  [layout]
+  [size layout]
   # Get the NodeID of the node the user is attached to
   (def node (layout/attach-id layout))
   (if

justfile

@@ -46,6 +46,15 @@ docs-build-assets:
   rm -rf docs/.docusaurus
   cd docs && npm run build
 
+# Validate the Janet code examples embedded in the docs, the same check
+# CI runs. Clears the Docusaurus/webpack caches first so the markdown
+# preprocessor actually re-runs (otherwise cached output is reused and
+# the examples are silently skipped). Skips story asset generation for
+# speed.
+docs-validate:
+  rm -rf docs/.docusaurus docs/node_modules/.cache
+  cd docs && CY_SKIP_ASSETS=1 npm run build
+
 api:
   go run ./cmd/docs/main.go
 

pkg/cy/api/docs-signal.md

@@ -23,6 +23,7 @@ Optional named parameters:
 - `:timeout` (number, default 0): Maximum number of seconds to wait. A value of 0 means wait indefinitely. Returns an error if the timeout is reached.
 
 ```janet
+# ignore
 # Wait with a 10-second timeout
 (def result (signal/wait :my-channel :timeout 10))
 (print result)