coop/rose-ash
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Restructure SX docs nav into 4 top-level sections with nested routing

Browse Source 
New hierarchy: Geography (Reactive Islands, Hypermedia Lakes, Marshes,
Isomorphism), Language (Docs, Specs, Bootstrappers, Testing),
Applications (CSSX, Protocols), Etc (Essays, Philosophy, Plans).

All routes updated to match: /reactive/* → /geography/reactive/*,
/docs/* → /language/docs/*, /essays/* → /etc/essays/*, etc.
Updates nav-data.sx, all defpage routes, API endpoints, internal links
across 43 files. Enhanced find-nav-match for nested group resolution.

Also includes: page-helpers-demo sf-total fix (reduce instead of set!),
rebootstrapped sx-browser.js and sx_ref.py, defensive slice/rest guards.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
giles
2026-03-11 18:50:31 +00:00
parent 0174fbfea3
commit 4d54be6b6b
43 changed files with 813 additions and 746 deletions
Download Patch File Download Diff File Expand all files Collapse all files

96
sx/sxc/examples.sx
View File

@@ -22,7 +22,7 @@
(div :id "click-result" :class "p-4 rounded bg-stone-100 text-stone-500 text-center"
"Click the button to load content.")
(button
:sx-get "/hypermedia/examples/api/click"
:sx-get "/geography/hypermedia/examples/api/click"
:sx-target "#click-result"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-violet-600 text-white rounded hover:bg-violet-700 transition-colors"
@@ -39,7 +39,7 @@
(defcomp ~form-demo ()
(div :class "space-y-4"
(form
:sx-post "/hypermedia/examples/api/form"
:sx-post "/geography/hypermedia/examples/api/form"
:sx-target "#form-result"
:sx-swap "innerHTML"
:class "space-y-3"
@@ -63,7 +63,7 @@
(defcomp ~polling-demo ()
(div :class "space-y-4"
(div :id "poll-target"
:sx-get "/hypermedia/examples/api/poll"
:sx-get "/geography/hypermedia/examples/api/poll"
:sx-trigger "load, every 2s"
:sx-swap "innerHTML"
:class "p-4 rounded border border-stone-200 bg-stone-100 text-center font-mono"
@@ -99,7 +99,7 @@
(td :class "px-3 py-2 text-stone-700" name)
(td :class "px-3 py-2"
(button
:sx-delete (str "/hypermedia/examples/api/delete/" id)
:sx-delete (str "/geography/hypermedia/examples/api/delete/" id)
:sx-target (str "#row-" id)
:sx-swap "outerHTML"
:sx-confirm "Delete this item?"
@@ -116,7 +116,7 @@
(div :class "flex items-center justify-between p-3 rounded border border-stone-200"
(span :class "text-stone-800" value)
(button
:sx-get (str "/hypermedia/examples/api/edit?value=" value)
:sx-get (str "/geography/hypermedia/examples/api/edit?value=" value)
:sx-target "#edit-target"
:sx-swap "innerHTML"
:class "text-sm text-violet-600 hover:text-violet-800"
@@ -124,7 +124,7 @@
(defcomp ~inline-edit-form (&key value)
(form
:sx-post "/hypermedia/examples/api/edit"
:sx-post "/geography/hypermedia/examples/api/edit"
:sx-target "#edit-target"
:sx-swap "innerHTML"
:class "flex items-center gap-2 p-3 rounded border border-violet-300 bg-violet-50"
@@ -134,7 +134,7 @@
:class "px-3 py-1.5 bg-violet-600 text-white rounded text-sm hover:bg-violet-700"
"save")
(button :type "button"
:sx-get (str "/hypermedia/examples/api/edit/cancel?value=" value)
:sx-get (str "/geography/hypermedia/examples/api/edit/cancel?value=" value)
:sx-target "#edit-target"
:sx-swap "innerHTML"
:class "px-3 py-1.5 bg-stone-200 text-stone-700 rounded text-sm hover:bg-stone-300"
@@ -152,7 +152,7 @@
(p :class "text-stone-500" "Box B")
(p :class "text-sm text-stone-400" "Waiting...")))
(button
:sx-get "/hypermedia/examples/api/oob"
:sx-get "/geography/hypermedia/examples/api/oob"
:sx-target "#oob-box-a"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-violet-600 text-white rounded hover:bg-violet-700 transition-colors text-sm"
@@ -164,7 +164,7 @@
(div :class "space-y-4"
(p :class "text-sm text-stone-500" "The content below loads automatically when the page renders.")
(div :id "lazy-target"
:sx-get "/hypermedia/examples/api/lazy"
:sx-get "/geography/hypermedia/examples/api/lazy"
:sx-trigger "load"
:sx-swap "innerHTML"
:class "p-6 rounded border border-stone-200 bg-stone-100 text-center"
@@ -187,7 +187,7 @@
(str "Item " (+ i 1) " — loaded with the page")))
(list 1 2 3 4 5))
(div :id "scroll-sentinel"
:sx-get "/hypermedia/examples/api/scroll?page=2"
:sx-get "/geography/hypermedia/examples/api/scroll?page=2"
:sx-trigger "intersect once"
:sx-target "#scroll-items"
:sx-swap "beforeend"
@@ -201,7 +201,7 @@
items)
(when (<= page 5)
(div :id "scroll-sentinel"
:sx-get (str "/hypermedia/examples/api/scroll?page=" page)
:sx-get (str "/geography/hypermedia/examples/api/scroll?page=" page)
:sx-trigger "intersect once"
:sx-target "#scroll-items"
:sx-swap "beforeend"
@@ -217,7 +217,7 @@
(div :class "bg-violet-600 h-4 rounded-full transition-all" :style "width: 0%"))
(p :class "text-sm text-stone-500 text-center" "Click start to begin."))
(button
:sx-post "/hypermedia/examples/api/progress/start"
:sx-post "/geography/hypermedia/examples/api/progress/start"
:sx-target "#progress-target"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-violet-600 text-white rounded hover:bg-violet-700 transition-colors text-sm"
@@ -230,7 +230,7 @@
:style (str "width: " percent "%")))
(p :class "text-sm text-stone-500 text-center" (str percent "% complete"))
(when (< percent 100)
(div :sx-get (str "/hypermedia/examples/api/progress/status?job=" job-id)
(div :sx-get (str "/geography/hypermedia/examples/api/progress/status?job=" job-id)
:sx-trigger "load delay:500ms"
:sx-target "#progress-target"
:sx-swap "innerHTML"))
@@ -242,7 +242,7 @@
(defcomp ~active-search-demo ()
(div :class "space-y-3"
(input :type "text" :name "q"
:sx-get "/hypermedia/examples/api/search"
:sx-get "/geography/hypermedia/examples/api/search"
:sx-trigger "keyup delay:300ms changed"
:sx-target "#search-results"
:sx-swap "innerHTML"
@@ -262,11 +262,11 @@
;; --- Inline validation demo ---
(defcomp ~inline-validation-demo ()
(form :class "space-y-4" :sx-post "/hypermedia/examples/api/validate/submit" :sx-target "#validation-result" :sx-swap "innerHTML"
(form :class "space-y-4" :sx-post "/geography/hypermedia/examples/api/validate/submit" :sx-target "#validation-result" :sx-swap "innerHTML"
(div
(label :class "block text-sm font-medium text-stone-700 mb-1" "Email")
(input :type "text" :name "email" :placeholder "user@example.com"
:sx-get "/hypermedia/examples/api/validate"
:sx-get "/geography/hypermedia/examples/api/validate"
:sx-trigger "blur"
:sx-target "#email-feedback"
:sx-swap "innerHTML"
@@ -290,7 +290,7 @@
(div
(label :class "block text-sm font-medium text-stone-700 mb-1" "Category")
(select :name "category"
:sx-get "/hypermedia/examples/api/values"
:sx-get "/geography/hypermedia/examples/api/values"
:sx-trigger "change"
:sx-target "#value-items"
:sx-swap "innerHTML"
@@ -314,7 +314,7 @@
(defcomp ~reset-on-submit-demo ()
(div :class "space-y-3"
(form :id "reset-form"
:sx-post "/hypermedia/examples/api/reset-submit"
:sx-post "/geography/hypermedia/examples/api/reset-submit"
:sx-target "#reset-result"
:sx-swap "innerHTML"
:sx-on:afterSwap "this.reset()"
@@ -354,7 +354,7 @@
(td :class "px-3 py-2 text-stone-700" stock)
(td :class "px-3 py-2"
(button
:sx-get (str "/hypermedia/examples/api/editrow/" id)
:sx-get (str "/geography/hypermedia/examples/api/editrow/" id)
:sx-target (str "#erow-" id)
:sx-swap "outerHTML"
:class "text-sm text-violet-600 hover:text-violet-800"
@@ -373,14 +373,14 @@
:class "w-20 px-2 py-1 border border-stone-300 rounded text-sm"))
(td :class "px-3 py-2 space-x-1"
(button
:sx-post (str "/hypermedia/examples/api/editrow/" id)
:sx-post (str "/geography/hypermedia/examples/api/editrow/" id)
:sx-target (str "#erow-" id)
:sx-swap "outerHTML"
:sx-include (str "#erow-" id)
:class "text-sm text-emerald-600 hover:text-emerald-800"
"save")
(button
:sx-get (str "/hypermedia/examples/api/editrow/" id "/cancel")
:sx-get (str "/geography/hypermedia/examples/api/editrow/" id "/cancel")
:sx-target (str "#erow-" id)
:sx-swap "outerHTML"
:class "text-sm text-stone-500 hover:text-stone-700"
@@ -393,14 +393,14 @@
(form :id "bulk-form"
(div :class "flex gap-2 mb-3"
(button :type "button"
:sx-post "/hypermedia/examples/api/bulk?action=activate"
:sx-post "/geography/hypermedia/examples/api/bulk?action=activate"
:sx-target "#bulk-table"
:sx-swap "innerHTML"
:sx-include "#bulk-form"
:class "px-3 py-1.5 bg-emerald-600 text-white rounded text-sm hover:bg-emerald-700"
"Activate")
(button :type "button"
:sx-post "/hypermedia/examples/api/bulk?action=deactivate"
:sx-post "/geography/hypermedia/examples/api/bulk?action=deactivate"
:sx-target "#bulk-table"
:sx-swap "innerHTML"
:sx-include "#bulk-form"
@@ -437,19 +437,19 @@
(div :class "space-y-3"
(div :class "flex gap-2"
(button
:sx-post "/hypermedia/examples/api/swap-log?mode=beforeend"
:sx-post "/geography/hypermedia/examples/api/swap-log?mode=beforeend"
:sx-target "#swap-log"
:sx-swap "beforeend"
:class "px-3 py-1.5 bg-violet-600 text-white rounded text-sm hover:bg-violet-700"
"Add to End")
(button
:sx-post "/hypermedia/examples/api/swap-log?mode=afterbegin"
:sx-post "/geography/hypermedia/examples/api/swap-log?mode=afterbegin"
:sx-target "#swap-log"
:sx-swap "afterbegin"
:class "px-3 py-1.5 bg-violet-600 text-white rounded text-sm hover:bg-violet-700"
"Add to Start")
(button
:sx-post "/hypermedia/examples/api/swap-log?mode=none"
:sx-post "/geography/hypermedia/examples/api/swap-log?mode=none"
:sx-target "#swap-log"
:sx-swap "none"
:class "px-3 py-1.5 bg-stone-600 text-white rounded text-sm hover:bg-stone-700"
@@ -469,21 +469,21 @@
(div :class "space-y-3"
(div :class "flex gap-2"
(button
:sx-get "/hypermedia/examples/api/dashboard"
:sx-get "/geography/hypermedia/examples/api/dashboard"
:sx-target "#filter-target"
:sx-swap "innerHTML"
:sx-select "#dash-stats"
:class "px-3 py-1.5 bg-violet-600 text-white rounded text-sm hover:bg-violet-700"
"Stats Only")
(button
:sx-get "/hypermedia/examples/api/dashboard"
:sx-get "/geography/hypermedia/examples/api/dashboard"
:sx-target "#filter-target"
:sx-swap "innerHTML"
:sx-select "#dash-header"
:class "px-3 py-1.5 bg-violet-600 text-white rounded text-sm hover:bg-violet-700"
"Header Only")
(button
:sx-get "/hypermedia/examples/api/dashboard"
:sx-get "/geography/hypermedia/examples/api/dashboard"
:sx-target "#filter-target"
:sx-swap "innerHTML"
:class "px-3 py-1.5 bg-stone-600 text-white rounded text-sm hover:bg-stone-700"
@@ -505,10 +505,10 @@
(defcomp ~tab-btn (&key tab label active)
(button
:sx-get (str "/hypermedia/examples/api/tabs/" tab)
:sx-get (str "/geography/hypermedia/examples/api/tabs/" tab)
:sx-target "#tab-content"
:sx-swap "innerHTML"
:sx-push-url (str "/hypermedia/examples/tabs?tab=" tab)
:sx-push-url (str "/geography/hypermedia/examples/tabs?tab=" tab)
:class (str "px-4 py-2 text-sm font-medium border-b-2 -mb-px transition-colors "
(if (= active "true")
"border-violet-600 text-violet-600"
@@ -520,7 +520,7 @@
(defcomp ~animations-demo ()
(div :class "space-y-4"
(button
:sx-get "/hypermedia/examples/api/animate"
:sx-get "/geography/hypermedia/examples/api/animate"
:sx-target "#anim-target"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-violet-600 text-white rounded hover:bg-violet-700 transition-colors text-sm"
@@ -539,7 +539,7 @@
(defcomp ~dialogs-demo ()
(div
(button
:sx-get "/hypermedia/examples/api/dialog"
:sx-get "/geography/hypermedia/examples/api/dialog"
:sx-target "#dialog-container"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-violet-600 text-white rounded hover:bg-violet-700 transition-colors text-sm"
@@ -549,7 +549,7 @@
(defcomp ~dialog-modal (&key title message)
(div :class "fixed inset-0 z-50 flex items-center justify-center"
(div :class "absolute inset-0 bg-black/50"
:sx-get "/hypermedia/examples/api/dialog/close"
:sx-get "/geography/hypermedia/examples/api/dialog/close"
:sx-target "#dialog-container"
:sx-swap "innerHTML")
(div :class "relative bg-stone-100 rounded-lg shadow-xl p-6 max-w-md w-full mx-4 space-y-4"
@@ -557,13 +557,13 @@
(p :class "text-stone-600" message)
(div :class "flex justify-end gap-2"
(button
:sx-get "/hypermedia/examples/api/dialog/close"
:sx-get "/geography/hypermedia/examples/api/dialog/close"
:sx-target "#dialog-container"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-stone-200 text-stone-700 rounded text-sm hover:bg-stone-300"
"Cancel")
(button
:sx-get "/hypermedia/examples/api/dialog/close"
:sx-get "/geography/hypermedia/examples/api/dialog/close"
:sx-target "#dialog-container"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-violet-600 text-white rounded text-sm hover:bg-violet-700"
@@ -586,16 +586,16 @@
(kbd :class "px-2 py-0.5 bg-stone-100 border border-stone-300 rounded text-xs font-mono" "h")
(span :class "text-sm text-stone-500" "Help"))))
(div :id "kbd-target"
:sx-get "/hypermedia/examples/api/keyboard?key=s"
:sx-get "/geography/hypermedia/examples/api/keyboard?key=s"
:sx-trigger "keyup[key=='s'&&!event.target.matches('input,textarea')] from:body"
:sx-swap "innerHTML"
:class "p-4 rounded border border-stone-200 bg-stone-100 text-center"
(p :class "text-stone-400 text-sm" "Press a shortcut key..."))
(div :sx-get "/hypermedia/examples/api/keyboard?key=n"
(div :sx-get "/geography/hypermedia/examples/api/keyboard?key=n"
:sx-trigger "keyup[key=='n'&&!event.target.matches('input,textarea')] from:body"
:sx-target "#kbd-target"
:sx-swap "innerHTML")
(div :sx-get "/hypermedia/examples/api/keyboard?key=h"
(div :sx-get "/geography/hypermedia/examples/api/keyboard?key=h"
:sx-trigger "keyup[key=='h'&&!event.target.matches('input,textarea')] from:body"
:sx-target "#kbd-target"
:sx-swap "innerHTML")))
@@ -619,7 +619,7 @@
(p :class "text-sm text-stone-500" email)
(p :class "text-sm text-stone-500" role))
(button
:sx-get "/hypermedia/examples/api/putpatch/edit-all"
:sx-get "/geography/hypermedia/examples/api/putpatch/edit-all"
:sx-target "#pp-target"
:sx-swap "innerHTML"
:class "text-sm text-violet-600 hover:text-violet-800"
@@ -627,7 +627,7 @@
(defcomp ~pp-form-full (&key name email role)
(form
:sx-put "/hypermedia/examples/api/putpatch"
:sx-put "/geography/hypermedia/examples/api/putpatch"
:sx-target "#pp-target"
:sx-swap "innerHTML"
:class "space-y-3"
@@ -648,7 +648,7 @@
:class "px-4 py-2 bg-violet-600 text-white rounded text-sm hover:bg-violet-700"
"Save All (PUT)")
(button :type "button"
:sx-get "/hypermedia/examples/api/putpatch/cancel"
:sx-get "/geography/hypermedia/examples/api/putpatch/cancel"
:sx-target "#pp-target"
:sx-swap "innerHTML"
:class "px-4 py-2 bg-stone-200 text-stone-700 rounded text-sm hover:bg-stone-300"
@@ -659,7 +659,7 @@
(defcomp ~json-encoding-demo ()
(div :class "space-y-4"
(form
:sx-post "/hypermedia/examples/api/json-echo"
:sx-post "/geography/hypermedia/examples/api/json-echo"
:sx-target "#json-result"
:sx-swap "innerHTML"
:sx-encoding "json"
@@ -691,7 +691,7 @@
(div :class "space-y-2"
(h4 :class "text-sm font-semibold text-stone-700" "sx-vals — send extra values")
(button
:sx-get "/hypermedia/examples/api/echo-vals"
:sx-get "/geography/hypermedia/examples/api/echo-vals"
:sx-target "#vals-result"
:sx-swap "innerHTML"
:sx-vals "{\"source\": \"button\", \"version\": \"2.0\"}"
@@ -702,7 +702,7 @@
(div :class "space-y-2"
(h4 :class "text-sm font-semibold text-stone-700" "sx-headers — send custom headers")
(button
:sx-get "/hypermedia/examples/api/echo-headers"
:sx-get "/geography/hypermedia/examples/api/echo-headers"
:sx-target "#headers-result"
:sx-swap "innerHTML"
:sx-headers {:X-Custom-Token "abc123" :X-Request-Source "demo"}
@@ -723,7 +723,7 @@
(defcomp ~loading-states-demo ()
(div :class "space-y-4"
(button
:sx-get "/hypermedia/examples/api/slow"
:sx-get "/geography/hypermedia/examples/api/slow"
:sx-target "#loading-result"
:sx-swap "innerHTML"
:class "sx-loading-btn px-4 py-2 bg-violet-600 text-white rounded hover:bg-violet-700 transition-colors text-sm flex items-center gap-2"
@@ -742,7 +742,7 @@
(defcomp ~sync-replace-demo ()
(div :class "space-y-3"
(input :type "text" :name "q"
:sx-get "/hypermedia/examples/api/slow-search"
:sx-get "/geography/hypermedia/examples/api/slow-search"
:sx-trigger "keyup delay:200ms changed"
:sx-target "#sync-result"
:sx-swap "innerHTML"
@@ -762,7 +762,7 @@
(defcomp ~retry-demo ()
(div :class "space-y-4"
(button
:sx-get "/hypermedia/examples/api/flaky"
:sx-get "/geography/hypermedia/examples/api/flaky"
:sx-target "#retry-result"
:sx-swap "innerHTML"
:sx-retry "exponential:1000:8000"