fix(-selector-builder): fetch namespace members and comments from docs

Author: nemni8

scripts/selector-declaration-builder.js

@@ -5,9 +5,19 @@ const {
   dtsObjectTypeAlias,
   convertTreeToString
 } = docworksDts.dtsGenerator;
+const { convertOperationToFunction } = docworksDts.docworksToDtsConverters;
 
 const QUERYABLE_TYPE = "TypeNameToSdkType";
 const $W = "$w";
+const $W_MEMBER_KEY = "// $W_NAMESPACE_MEMBERS";
+
+function find$wService(services) {
+  return services.find(
+    service =>
+      service.name === $W &&
+      !Object.prototype.hasOwnProperty.call(service, "memberOf")
+  );
+}
 
 function getQueryableObjectType(services) {
   const isQueryableService = service =>
@@ -20,10 +30,45 @@ function getQueryableObjectType(services) {
   return dtsObjectTypeAlias(QUERYABLE_TYPE, properties);
 }
 
+function extract$wComments(services) {
+  const $wService = find$wService(services);
+  const $wOperation = $wService.operations.find(
+    operation => operation.name === $W
+  );
+  const [$w$wMembersComment] = $wService.operations
+    .filter(o => o.name === $W)
+    .map(operation => operation.docs.summary);
+  return {
+    $W_GLOBAL_DECLARATION_COMMENT: $wOperation.docs.summary,
+    $W_NAMESPACE_COMMENT: $wService.docs.summary,
+    $W_$W_DECLARATION_COMMENT: $w$wMembersComment
+  };
+}
+
+function extract$wMembers(services) {
+  const $wService = find$wService(services);
+  const $wMembersOperations = $wService.operations
+    .filter(o => o.name !== $W)
+    .map(operation => {
+      return convertOperationToFunction($wService, operation, {
+        documentationGenerator: ({ summary }) => summary
+      });
+    });
+  return convertTreeToString($wMembersOperations);
+}
+
 function $wDeclarationBuilder(services) {
+  const $wComments = extract$wComments(services);
+  const $wMembers = extract$wMembers(services);
   const queryableType = getQueryableObjectType(services);
 
-  const page$w = fs.readFileSync("./src_types/pages/$w.d.ts", null, "utf-8");
+  let page$w = fs.readFileSync("./src_types/pages/$w.d.ts", "utf-8");
+  page$w = page$w.replace($W_MEMBER_KEY, $wMembers);
+  page$w = Object.keys($wComments).reduce(
+    (dts, commnetKey) => dts.replace(commnetKey, $wComments[commnetKey]),
+    page$w
+  );
+
   return [convertTreeToString({ queryableType }), page$w].join("\n");
 }
 

src_types/pages/$w.d.ts

@@ -15,42 +15,35 @@ type VaildSelectorsChars = WixElementSelector | LegalChars
 
 type OnlyVaildSelectorsChars<S> =
     S extends ""
-        ? any
+        ? unknown
         : S extends `${VaildSelectorsChars}${infer Tail}`
             ? OnlyVaildSelectorsChars<Tail>
             : never
 
 type HasComma<S> = 
     S extends `${CommaChar}${infer Tail}`
         ? unknown
-        : S extends `${VaildSelectorsChars}${infer Tail2}`
-            ? HasComma<Tail2>
+        : S extends `${VaildSelectorsChars}${infer Tail}`
+            ? HasComma<Tail>
             : never
+            
 type MultiSelector<S> = S & OnlyVaildSelectorsChars<S> & HasComma<S>
 /**
- * Selects and returns elements from a page.
+ * $W_GLOBAL_DECLARATION_COMMENT
  */
 declare function $w<T extends WixElementSelector, S extends string>(selector: T | MultiSelector<S>):
     S extends keyof WixElements 
         ? WixElements[S]
         : any
 /**
- * The `$w` namespace contains everything you need in order to work
- *  with your site's components.
+ * $W_NAMESPACE_COMMENT
  */
 declare namespace $w {
-    /**
-     * Gets a selector function for a specific context.
-     */
-    function at(context: $w.Event.EventContext): $w.$w;
 
-    /**
-     * Sets the function that runs when all the page elements have finished loading.
-     */
-    function onReady(initFunction: $w.ReadyHandler): void;
+    // $W_NAMESPACE_MEMBERS
 
     /**
-     * Selects and returns elements from a page.
+     * $W_$W_DECLARATION_COMMENT
      */
     type $w = <T extends WixElementSelector, S extends string>(selector: T | MultiSelector<S>) =>
         S extends keyof WixElements