upd

mattqual · mattqual · commit 950413da039b · 2025-10-10T04:39:54.000-03:00
diff --git a/TODO b/TODO
@@ -4,8 +4,8 @@
 - [ ] Describe operations like GetQNameInNsSetOrAnyPublicNs() and possibly others used in property lookup
 - [70%] Property lookup
   - https://github.com/whackengine/sdk/blob/master/crates/mxmlsemantics/src/semantics/property_lookup.rs#L353
-  - [x] PropertyLookup: remind of `shock_proxy` stuff
-    - [x] `shock_proxy::get` allows for multiple signatures
+  - [x] PropertyLookup: remind of `sx_proxy` stuff
+    - [x] `sx_proxy::get` allows for multiple signatures
     - [ ] Introduce lazily imported source files based in source paths, when lookuping from packages.
     - [ ] Values whose static type is a type parameter will lookup for names in the type parameter's derived types.
   - [ ] InScopeLookup
@@ -30,7 +30,7 @@
 - [x] Lexical scopes
 - [x] Default lexical scope
 - [x] Conditional compilation
-- [x] ShockDoc comments
+- [x] SXDoc comments
 - [x] Proxies
 - [x] Lexical conventions
 - [ ] Expressions
@@ -60,16 +60,16 @@
     - [ ] Takes a non-attribute qualified identifier.
   - [ ] Call operator
     - [ ] Base is passed *followedByCall=true*
-    - [ ] Watch for static `shock_proxy::call` when calling classes (supports multiple signatures too)
-    - [ ] `XML` and `XMLList` being called statically shall still pass themselves as the context type to the first call argument, even if they define `shock_proxy::call()`.
+    - [ ] Watch for static `sx_proxy::call` when calling classes (supports multiple signatures too)
+    - [ ] `XML` and `XMLList` being called statically shall still pass themselves as the context type to the first call argument, even if they define `sx_proxy::call()`.
   - [ ] `v as T` operator
     - [ ] Passes context type `T` to `v`
   - [ ] Assignment expression
-    - [ ] When base is *KeyValuePairReferenceValue*, `shock_proxy::set()`
-    - [ ] When base is *AttributeReferenceValue*, `shock_proxy::setAttribute()`
+    - [ ] When base is *KeyValuePairReferenceValue*, `sx_proxy::set()`
+    - [ ] When base is *AttributeReferenceValue*, `sx_proxy::setAttribute()`
   - [ ] Delete operator
-    - [ ] `shock_proxy::delete()`
-    - [ ] `shock_proxy::deleteAttribute()`
+    - [ ] `sx_proxy::delete()`
+    - [ ] `sx_proxy::deleteAttribute()`
   - [ ] New operator
     - [ ] Base is passed *followedByCall=true*
     - [ ] Support a dynamically typed base (`*` or `Class`)
@@ -90,7 +90,7 @@
 - [ ] Directives
 - [ ] Definition constructs
 - [ ] Global objects
-  - [ ] shock_proxy namespace
+  - [ ] sx_proxy namespace
   - [ ] DotEnv namespace
   - [ ] Reflect namespace
   - [ ] trace()
@@ -112,7 +112,7 @@
     - [ ] required `next():{ done: Boolean, value?: T }`
     - [ ] `length():int`
     - [ ] `skip(count:int):void`
-    - [ ] `shock_proxy::filter(...)`
+    - [ ] `sx_proxy::filter(...)`
     - [ ] Other functional methods
   - [ ] Iterable.\<K, V> (interface) requires keys() and values()
   - [ ] Generator.\<T>
@@ -124,16 +124,16 @@
     - [ ] toLocaleString()
     - [ ] valueOf()
   - [ ] Array
-    - [ ] `shock_proxy::get(...)` throws if out of bounds
-    - [ ] `shock_proxy::filter(...)`
+    - [ ] `sx_proxy::get(...)` throws if out of bounds
+    - [ ] `sx_proxy::filter(...)`
     - [ ] `clone()`
     - [ ] `shift(): (void, T)`
     - [ ] `pop(): (void, T)`
     - [ ] `first : (void, T)`
     - [ ] `last : (void, T)`
   - [ ] Map
     - [ ] `Map(weakKeys:Boolean = false)`
-    - [ ] `shock_proxy::get()` throws if key does not match
+    - [ ] `sx_proxy::get()` throws if key does not match
     - [ ] `length()`
     - [ ] `clear()`
     - [ ] `clone()`
@@ -155,22 +155,20 @@
     - [ ] `clone()`
   - [ ] XML
     - [ ] Implement `Iterable`
-    - [ ] static `shock_proxy::call(arg:*):XML`
-    - [ ] `shock_proxy::has(name:QName):Boolean`
-    - [ ] `shock_proxy::get(index:int):XML` (throws if out of bounds)
-    - [ ] `shock_proxy::get(name:QName):XMLList`
-    - [ ] `shock_proxy::set(key:(int, QName), value:(XML, XMLList)):void`
-    - [ ] `shock_proxy::delete(arg:(int, QName)):Boolean`
+    - [ ] static `sx_proxy::call(arg:*):XML`
+    - [ ] `sx_proxy::has(name:QName):Boolean`
+    - [ ] `sx_proxy::get(index:int):XML` (throws if out of bounds)
+    - [ ] `sx_proxy::get(name:QName):XMLList`
+    - [ ] `sx_proxy::set(key:(int, QName), value:(XML, XMLList)):void`
+    - [ ] `sx_proxy::delete(arg:(int, QName)):Boolean`
     - [ ] Attributes
   - [ ] XMLList
-    - [ ] static `shock_proxy::call(arg:*):XMLList`
+    - [ ] static `sx_proxy::call(arg:*):XMLList`
   - [ ] ByteArray
     - [ ] Indexing
     - [ ] `shareable:Boolean`
     - [ ] `clone()`
-  - [ ] shock.intl.**
-    - [ ] Like ECMA-262 `Intl`. Aliased globally as `Intl::` to avoid manual import.
-  - [ ] shock.temporal.**
-
-    - [ ] Defines ECMA-262 like `Temporal` functionality, including classes and methods. That package is aliased globally as `Temporal::` to avoid manual import.
-
+  - [ ] SX.intl.**
+    - [ ] Like ECMA-262 `Intl`. Aliased globally as `Intl::` for clarity.
+  - [ ] SX.temporal.**
+    - [ ] Defines ECMA-262 like `Temporal` functionality, including classes and methods. That package is aliased globally as `Temporal::` for clarity.
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
@@ -56,6 +56,6 @@
 - [Lexical scopes](./lexical-scopes.md)
 - [Default lexical scope](./default-lexical-scope.md)
 - [Conditional compilation](./conditional-compilation.md)
-- [ShockDoc](./shockdoc.md)
+- [SXDoc](./sxdoc.md)
 - [Proxies](./proxies.md)
 - [Lexical conventions](./lexical-conventions.md)
diff --git a/src/_BASE/expressions/identifier.md b/src/_BASE/expressions/identifier.md
@@ -7,4 +7,4 @@
 <?fixed={object.q::n}?>
 ```
 
-> **Note**: Forcing fixture access allows to access a variable or method when a class implements `shock_proxy::get(k)` where `k` includes `String` or `QName`. This may also be necessary inside the class body itself to resolve to certain lexical names.
+> **Note**: Forcing fixture access allows to access a variable or method when a class implements `sx_proxy::get(k)` where `k` includes `String` or `QName`. This may also be necessary inside the class body itself to resolve to certain lexical names.
diff --git a/src/aliases.md b/src/aliases.md
@@ -9,9 +9,9 @@ type U = (decimal, String);
 namespace special_version;
 ```
 
-## ShockDoc comment
+## SXDoc comment
 
-An alias may be prefixed by a ShockDoc comment.
+An alias may be prefixed by a SXDoc comment.
 
 ```
 /** Comment */
diff --git a/src/classes.md b/src/classes.md
@@ -19,9 +19,9 @@ A class owns three namespaces:
 
 `protected` and `static protected` are propagated to the block of subclasses.
 
-## ShockDoc comment
+## SXDoc comment
 
-A class may be prefixed by a ShockDoc comment.
+A class may be prefixed by a SXDoc comment.
 
 ```
 /** Comment */
diff --git a/src/conversions.md b/src/conversions.md
@@ -2,7 +2,7 @@
 
 This section describes which type conversions are available.
 
-Explicit conversions may occur as either `T(v)` (strict conversion) or `v as T` (optional conversion). The behavior of the call operator over a type may not always be a conversion depending on if `T` implements the static `shock_proxy::call()` method.
+Explicit conversions may occur as either `T(v)` (strict conversion) or `v as T` (optional conversion). The behavior of the call operator over a type may not always be a conversion depending on if `T` implements the static `sx_proxy::call()` method.
 
 ```
 T(v)       // failure throws a TypeError
diff --git a/src/default-lexical-scope.md b/src/default-lexical-scope.md
@@ -4,19 +4,19 @@ The topmost scope from which all scopes inherit is implicitly created by ShockSc
 
 ## Imports
 
-The topmost scope imports the top-level package by wildcard. It is allowed to shadow names from the top-level package, in which case, the `global` alias may be used to access the top-level package.
+The topmost scope imports the top-level package by wildcard. It is allowed to shadow names from the top-level package, in which case, the `SX` alias may be used to access the top-level package.
 
-## global
+## SX
 
-The topmost scope defines a `global` property, which is an alias to a package wildcard import of the top-level package.
+The topmost scope defines a `SX` property, which is an alias to a package wildcard import of the top-level package.
 
 ## Intl
 
-The topmost scope defines a `Intl` property, which is an alias to `shock.intl.**`.
+The topmost scope defines a `Intl` property, which is an alias to `SX.intl.**`.
 
 ## Temporal
 
-The topmost scope defines a `Temporal` property, which is an alias to `shock.temporal.**`.
+The topmost scope defines a `Temporal` property, which is an alias to `SX.temporal.**`.
 
 ## Provided by Whack
 
diff --git a/src/enums.md b/src/enums.md
@@ -170,10 +170,10 @@ Returns the name of the enumeration instance. For a flag enumeration, returns th
 
 ### For flag enumerations
 
-#### shock_proxy::has()
+#### sx_proxy::has()
 
 ```
-shock_proxy function has(v:E):Boolean {
+sx_proxy function has(v:E):Boolean {
     //
 }
 ```
diff --git a/src/interfaces.md b/src/interfaces.md
@@ -21,9 +21,9 @@ The `interface` block may only contain function definitions, including regular m
 
 An `interface` is a subtype of `Object`, although compile-time property lookups do not inherit `Object` properties.
 
-## ShockDoc comment
+## SXDoc comment
 
-An interface may be prefixed by a ShockDoc comment.
+An interface may be prefixed by a SXDoc comment.
 
 ```
 /** Comment */
@@ -89,7 +89,7 @@ As annotations, interface methods may have nothing but an access modifier that i
 
 ```
 interface I {
-    shock_proxy function get(key:String):String;
+    sx_proxy function get(key:String):String;
 }
 ```
 
diff --git a/src/methods.md b/src/methods.md
@@ -21,9 +21,9 @@ class A {
 }
 ```
 
-## ShockDoc comment
+## SXDoc comment
 
-A ShockDoc comment can be applied to a method.
+A SXDoc comment can be applied to a method.
 
 ```
 /** Comment */
diff --git a/src/overview.md b/src/overview.md
@@ -14,6 +14,6 @@ For the Whack Engine, XML expressions create WhackDS nodes by default.
 
 ShockScript incorporates a basic event model and allows easily declaring event types and documenting them. Implementations may extend the event model for working with a Document Object Model.
 
-## ShockDoc
+## SXDoc
 
 ShockScript supports documentation comments allowing for Markdown notation, special tags such as `@throws` and media inclusion.
diff --git a/src/overview/relation/as3.md b/src/overview/relation/as3.md
@@ -53,7 +53,7 @@ class B extends A {
 
 ## “in” operator
 
-The `in` operator behaves differently. It triggers `shock_proxy::has()` which is in general used for determining whether a collection contains a specific value; for `Map`s it determines whether a pair key exists; for `XML` and `XMLList` objects it performs the same E4X behavior.
+The `in` operator behaves differently. It triggers `sx_proxy::has()` which is in general used for determining whether a collection contains a specific value; for `Map`s it determines whether a pair key exists; for `XML` and `XMLList` objects it performs the same E4X behavior.
 
 ```
 trace(e in arr);
diff --git a/src/overview/relation/mxml.md b/src/overview/relation/mxml.md
@@ -21,7 +21,7 @@ package com.business.components {
 
 In MXML, event handlers were expressed as `e="statements"`. In ShockScript, they are expressed as `e&={statements}` (note the ampersand **\&**) as a shorthand to `e={function(event){statements}}`.
 
-> **Note**: Although not demanded as such, as opposed to React.js + DOM, event handlers are conventionally expressed without a `on` prefix, such as `click&={trace("clicked!")}` rather than React.js `onClick={e=>{console.log("clicked!")}}`. Event parameters are conventionally given the `@eventparam` tag in the ShockDoc comments. Classes continue using the `Event` meta-data, though without needing the `@eventType` tag.
+> **Note**: Although not demanded as such, as opposed to React.js + DOM, event handlers are conventionally expressed without a `on` prefix, such as `click&={trace("clicked!")}` rather than React.js `onClick={e=>{console.log("clicked!")}}`. Event parameters are conventionally given the `@eventparam` tag in the SXDoc comments. Classes continue using the `Event` meta-data, though without needing the `@eventType` tag.
 
 ## Rendering components
 
diff --git a/src/packages.md b/src/packages.md
@@ -30,12 +30,12 @@ package {
 }
 ```
 
-When a global name is shadowed, the user may use the special `global` namespace to lookup a global name:
+When a global name is shadowed, the user may use the special `SX` namespace to lookup a global name:
 
 ```
 Math
     // or
-global::Math
+SX::Math
 ```
 
 ## Name shadowing
diff --git a/src/property-lookup.md b/src/property-lookup.md
@@ -56,9 +56,9 @@
   - If *baseType* is invalid
     - Return invalid
   - *baseType* = *baseType*.ResolveAlias()
-  - If (*followedByCall* == false and *forceFixture* == false) and *baseType* defines an instance method `shock_proxy::get` (possibly a multi method)
+  - If (*followedByCall* == false and *forceFixture* == false) and *baseType* defines an instance method `sx_proxy::get` (possibly a multi method)
     - Let *foundRegularProperty* = false
-    - For each `shock_proxy::get(k:K):V` method
+    - For each `sx_proxy::get(k:K):V` method
       - If *qual* != undefined
         - If *K* == `*` or *K* == (`Object` or defer) or *K* == (`QName` or defer) or *K* ?union contains (`QName` or defer)
           - Return *KeyValuePairReferenceValue*(*base*, *proxy method*, *qual* as a `Namespace` object, *key*.Value coerced to (`String` or defer))
diff --git a/src/proxies.md b/src/proxies.md
diff --git a/src/sxdoc.md b/src/sxdoc.md
diff --git a/src/variables.md b/src/variables.md
diff --git a/src/virtual-variables.md b/src/virtual-variables.md

Original file line number	Diff line number	Diff line change
`@@ -21,9 +21,9 @@ class A {`
`21`	`21`	`}`
`22`	`22`	```
`23`	`23`
`24`		`-## ShockDoc comment`
	`24`	`+## SXDoc comment`
`25`	`25`
`26`		`-A ShockDoc comment can be applied to a method.`
	`26`	`+A SXDoc comment can be applied to a method.`
`27`	`27`
`28`	`28`	```
`29`	`29`	`/** Comment */`