Merge branch 'worktree-refactor-primitives' into macros

# Conflicts:
#	shared/sx/ref/bootstrap_js.py
#	shared/sx/ref/bootstrap_py.py

shared/sx/ref/primitives.sx

@@ -18,13 +18,19 @@
 ;; The :body is optional — when provided, it gives a reference
 ;; implementation in SX that bootstrap compilers MAY use for testing
 ;; or as a fallback. Most targets will implement natively for performance.
+;;
+;; Modules: (define-module :name) scopes subsequent define-primitive
+;; entries until the next define-module. Bootstrappers use this to
+;; selectively include primitive groups.
 ;; ==========================================================================
 
 
 ;; --------------------------------------------------------------------------
-;; Arithmetic
+;; Core — Arithmetic
 ;; --------------------------------------------------------------------------
 
+(define-module :core.arithmetic)
+
 (define-primitive "+"
   :params (&rest args)
   :returns "number"
@@ -115,9 +121,11 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Comparison
+;; Core — Comparison
 ;; --------------------------------------------------------------------------
 
+(define-module :core.comparison)
+
 (define-primitive "="
   :params (a b)
   :returns "boolean"
@@ -172,9 +180,11 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Predicates
+;; Core — Predicates
 ;; --------------------------------------------------------------------------
 
+(define-module :core.predicates)
+
 (define-primitive "odd?"
   :params (n)
   :returns "boolean"
@@ -235,9 +245,11 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Logic
+;; Core — Logic
 ;; --------------------------------------------------------------------------
 
+(define-module :core.logic)
+
 (define-primitive "not"
   :params (x)
   :returns "boolean"
@@ -245,9 +257,11 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Strings
+;; Core — Strings
 ;; --------------------------------------------------------------------------
 
+(define-module :core.strings)
+
 (define-primitive "str"
   :params (&rest args)
   :returns "string"
@@ -305,9 +319,11 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Collections — construction
+;; Core — Collections
 ;; --------------------------------------------------------------------------
 
+(define-module :core.collections)
+
 (define-primitive "list"
   :params (&rest args)
   :returns "list"
@@ -323,11 +339,6 @@
   :returns "list"
   :doc "Integer range [start, end) with optional step.")
 
-
-;; --------------------------------------------------------------------------
-;; Collections — access
-;; --------------------------------------------------------------------------
-
 (define-primitive "get"
   :params (coll key &rest default)
   :returns "any"
@@ -380,9 +391,11 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Collections — dict operations
+;; Core — Dict operations
 ;; --------------------------------------------------------------------------
 
+(define-module :core.dict)
+
 (define-primitive "keys"
   :params (d)
   :returns "list"
@@ -415,9 +428,11 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Format helpers
+;; Stdlib — Format
 ;; --------------------------------------------------------------------------
 
+(define-module :stdlib.format)
+
 (define-primitive "format-date"
   :params (date-str fmt)
   :returns "string"
@@ -433,11 +448,18 @@
   :returns "number"
   :doc "Parse string to integer with optional default on failure.")
 
+(define-primitive "parse-datetime"
+  :params (s)
+  :returns "string"
+  :doc "Parse datetime string — identity passthrough (returns string or nil).")
+
 
 ;; --------------------------------------------------------------------------
-;; Text helpers
+;; Stdlib — Text
 ;; --------------------------------------------------------------------------
 
+(define-module :stdlib.text)
+
 (define-primitive "pluralize"
   :params (count &rest forms)
   :returns "string"
@@ -455,33 +477,10 @@
 
 
 ;; --------------------------------------------------------------------------
-;; Date & parsing helpers
+;; Stdlib — Style
 ;; --------------------------------------------------------------------------
 
-(define-primitive "parse-datetime"
-  :params (s)
-  :returns "string"
-  :doc "Parse datetime string — identity passthrough (returns string or nil).")
-
-(define-primitive "split-ids"
-  :params (s)
-  :returns "list"
-  :doc "Split comma-separated ID string into list of trimmed non-empty strings.")
-
-
-;; --------------------------------------------------------------------------
-;; Assertions
-;; --------------------------------------------------------------------------
-
-(define-primitive "assert"
-  :params (condition &rest message)
-  :returns "boolean"
-  :doc "Assert condition is truthy; raise error with message if not.")
-
-
-;; --------------------------------------------------------------------------
-;; CSSX — style system primitives
-;; --------------------------------------------------------------------------
+(define-module :stdlib.style)
 
 (define-primitive "css"
   :params (&rest atoms)
@@ -493,3 +492,15 @@
   :params (&rest styles)
   :returns "style-value"
   :doc "Merge multiple StyleValues into one combined StyleValue.")
+
+
+;; --------------------------------------------------------------------------
+;; Stdlib — Debug
+;; --------------------------------------------------------------------------
+
+(define-module :stdlib.debug)
+
+(define-primitive "assert"
+  :params (condition &rest message)
+  :returns "boolean"
+  :doc "Assert condition is truthy; raise error with message if not.")