@dusted/anqst 1.0.0 → 1.5.0

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@dusted/anqst",
-  "version": "1.0.0",
+  "version": "1.5.0",
   "description": "Opinionated backend generator for webapps.",
   "keywords": [
     "nodejs",
     "qt",
     "angular",
-    "webapp",
-    "apigenerator"
+    "webapp"
   ],
   "homepage": "https://github.com/DusteDdk/AnQst#readme",
   "bugs": {

package/spec/AnQst-Spec-DSL.d.ts

@@ -18,12 +18,12 @@ export namespace AnQst {
 
     /**
      * Declare service `InterfaceName`
-     * 
+     *
      * @remarks
      * Multiple allowed.
      * Affords developers of advanced widgets the ability to create domain-informed categories.
      * - Duplicate method declarations with identical parameter lists are invalid in normative AnQst-Spec input.
-     * 
+     *
      * @example
      * export interface UserService extends Widget.Service { }
      * // Generates UserService.
@@ -83,6 +83,7 @@ export namespace AnQst {
      *      - throw -> failure
      *      - rejected promise -> failure
      *   - Parent: `MethodName` call returns with result.
+     * - Generated C++ Slot methods do not expose `ok/error` out parameters.
      * - Default Slot timeout is 1000ms.
      * Note: One active handler, calling will replace existing and is valid and allowed.
      * @example
@@ -164,12 +165,15 @@ export namespace AnQst {
      *   - External: A Qt widget initiates a QDrag carrying QMimeData.
      *   - Parent: AnQstWebHostBase intercepts the drop via event filter on the
      *     embedded QWebEngineView's rendering surface.
-     *   - Parent: QMimeData for the accepted format is deserialized (JSON) into
-     *     the generated C++ struct and forwarded through the bridge.
+     *   - Parent: QMimeData for the accepted format is deserialized from a JSON
+     *     array of normalized AnQst wire items and forwarded through the bridge.
      *   - Widget: Service updates signal `PropertyName` with the deserialized
      *     payload and drop coordinates. Angular components react via effect() / template binding.
      * - MIME type is convention-derived: `application/anqst-dragdropevent_<ServiceName>-<TypeName>`.
-     * - The source QWidget must serialize the drag payload as JSON under the same MIME type.
+     * - The source QWidget must serialize the generated AnQst wire payload as a
+     *   JSON array under the same MIME type. Generated Qt widgets expose helper
+     *   functions for this and source widgets should use them instead of
+     *   hand-written JSON mapping.
      * - Multiple DropTarget members per service are allowed (each accepting a different type).
      * @example
      * // AnQst spec:
@@ -192,8 +196,9 @@ export namespace AnQst {
      *   - External: A Qt widget initiates a QDrag carrying QMimeData.
      *   - Parent: AnQstWebHostBase intercepts drag-move events via event filter on the
      *     embedded QWebEngineView's rendering surface. Events are throttled (trailing edge).
-     *   - Parent: Payload is deserialized once on DragEnter; subsequent DragMove events
-     *     forward only the updated position.
+     *   - Parent: Payload is deserialized once on DragEnter from a JSON array of
+     *     normalized AnQst wire items; subsequent DragMove events forward only
+     *     the updated position.
      *   - Widget: Service updates signal `PropertyName` with the payload and current
      *     coordinates. Signal becomes null on DragLeave.
      * - Shares the same MIME type convention as DropTarget: `application/anqst-dragdropevent_<ServiceName>-<TypeName>`.
@@ -302,6 +307,9 @@ export namespace AnQst {
         Promise = "Passing Promises across the boundary is not allowed",
         Callable = "Passing Callable objects across the boundary is not allowed",
         any = "Passing 'any' type across the boundary is not allowed",
+        symbol = "Passing 'symbol' type across the boundary is not allowed",
+        unknown = "Passing 'unknown' type across the boundary is not allowed",
+        never = "Passing 'never' type across the boundary is not allowed",
     }
 
     /**
@@ -324,4 +332,3 @@ export namespace AnQst {
     }
 
 }
-