Feature/authors/draft/0

.docs/.templates/Boilerplate.Widget.svelte

@@ -1,23 +1,36 @@
 <!--
-╭────────────────────────────────────────────────────────────────────────╮
-│ NOTE:                                                                  │
-│ This is a 'boilerplate' example for a .svelte component,               │
-│ used by Betarena | Scores.                                             │
-│ It acts as a guidance on internal development standards and            │
-│ code style used throughout this project.                               │
-│ NOTE: | IMPORTANT                                                      │
-│ Use _this_ Boilerplate / Template when creating your next Svelte       │
-│ Component of Type Widget.                                              │
-│ NOTE: | IMPORTANT                                                      │
-│ ❗️ Please Remove _this_ comment after adding this to a target file.    │
-╰────────────────────────────────────────────────────────────────────────╯
+╭──────────────────────────────────────────────────────────────────────────────────╮
+│ NOTE:                                                                            │
+│ ➤ This is a 'boilerplate' example for a .svelte component,                       │
+│ ➤ used by Betarena | Scores.                                                     │
+│ ➤ It acts as a guidance on internal development standards and                    │
+│ ➤ code style used throughout this project.                                       │
+┣──────────────────────────────────────────────────────────────────────────────────┫
+│ NOTE: IMPORTANT                                                                  │
+│ Use _this_ Boilerplate / Template when creating your next Svelte                 │
+│ Component of Type Widget.                                                        │
+┣──────────────────────────────────────────────────────────────────────────────────┫
+│ NOTE: IMPORTANT                                                                  │
+│ ❗️ Please Remove _this_ comment after adding this to a target file.              │
+╰──────────────────────────────────────────────────────────────────────────────────╯
+-->
+
+<!--
+╭──────────────────────────────────────────────────────────────────────────────────╮
+│ High Order Component Overview                                                    │
+┣──────────────────────────────────────────────────────────────────────────────────┫
+│ ➤ Internal Svelte Code Format :|: V.X.Y                                          │
+│ ➤ Status :|: 🔒 LOCKED                                                           │
+│ ➤ Author(s) :|: @migbash                                                         │
+╰──────────────────────────────────────────────────────────────────────────────────╯
 -->
 
 <!--
 ╭──────────────────────────────────────────────────────────────────────────────────╮
 │ Svelte Component JS/TS                                                           │
 ┣──────────────────────────────────────────────────────────────────────────────────┫
-│ - access custom Betarena Scores JS VScode Snippets by typing 'script...'         │
+│ ➤ HINT: │ Access snippets for '<script> [..] </script>' those found in           │
+│         │ '.vscode/snippets.code-snippets' via intellisense using 'doc'          │
 ╰──────────────────────────────────────────────────────────────────────────────────╯
 -->
 
@@ -198,14 +211,18 @@
 ╭──────────────────────────────────────────────────────────────────────────────────╮
 │ Svelte Component HTML                                                            │
 ┣──────────────────────────────────────────────────────────────────────────────────┫
-│ - use 'Ctrl+Space' to autocomplete global class="(cursor)" styles                │
-│ - access custom Betarena Scores VScode Snippets by typing emmet-like abbrev.     │
+│ ➤ HINT: │ Use 'Ctrl + Space' to autocomplete global class=styles, dynamically    │
+│         │ imported from './static/app.css'                                       │
+│ ➤ HINT: │ access custom Betarena Scores VScode Snippets by typing emmet-like     │
+│         │ abbrev.                                                                │
 ╰──────────────────────────────────────────────────────────────────────────────────╯
 -->
 
 <SeoBox>
   <!--
-  SEO CONTENT GOES HERE
+  ╭─────
+  │ > Note goes here
+  ╰─────
   -->
 </SeoBox>
 
@@ -260,8 +277,9 @@
 ╭──────────────────────────────────────────────────────────────────────────────────╮
 │ Svelte Component CSS/SCSS                                                        │
 ┣──────────────────────────────────────────────────────────────────────────────────┫
-│ - auto-fill/auto-complete iniside <style> for var() values by typing/CTRL+SPACE  │
-│ - access custom Betarena Scores CSS VScode Snippets by typing 'style...'         │
+│ ➤ HINT: │ auto-fill/auto-complete iniside <style> for var()                      │
+│         │ values by typing/CTRL+SPACE                                            │
+│ ➤ HINT: │ access custom Betarena Scores CSS VScode Snippets by typing 'style...' │
 ╰──────────────────────────────────────────────────────────────────────────────────╯
 -->
 

.docs/.templates/Bolierplate.+page.svelte

@@ -0,0 +1,41 @@
+<!--
+╭──────────────────────────────────────────────────────────────────────────────────╮
+│ Svelte Component JS/TS                                                           │
+┣──────────────────────────────────────────────────────────────────────────────────┫
+│ - access custom Betarena Scores JS VScode Snippets by typing 'script...'         │
+╰──────────────────────────────────────────────────────────────────────────────────╯
+-->
+
+<script lang="ts">
+
+  // #region ➤ 📦 Package Imports
+
+  // ╭────────────────────────────────────────────────────────────────────────╮
+  // │ NOTE:                                                                  │
+  // │ Please add inside 'this' region the 'imports' that are required        │
+  // │ by 'this' .svelte file is ran.                                         │
+  // │ IMPORTANT                                                              │
+  // │ Please, structure the imports as follows:                              │
+  // │ 1. svelte/sveltekit imports                                            │
+  // │ 2. project-internal files and logic                                    │
+  // │ 3. component import(s)                                                 │
+  // │ 4. assets import(s)                                                    │
+  // │ 5. type(s) imports(s)                                                  │
+  // ╰────────────────────────────────────────────────────────────────────────╯
+
+  import Layout from "$lib/components/section/authors/page/author/Layout.svelte";
+
+  // #endregion ➤ 📦 Package Imports
+
+</script>
+
+<!--
+╭──────────────────────────────────────────────────────────────────────────────────╮
+│ Svelte Component HTML                                                            │
+┣──────────────────────────────────────────────────────────────────────────────────┫
+│ - use 'Ctrl+Space' to autocomplete global class=styles                           │
+│ - access custom Betarena Scores VScode Snippets by typing emmet-like abbrev.     │
+╰──────────────────────────────────────────────────────────────────────────────────╯
+-->
+
+<Layout />

.docs/openapi.yaml

@@ -1500,6 +1500,48 @@ paths:
         200:
           description: Target competition HIGHLIGHTS widget data
 
+  # ╭──────────────────────────────────────────────────────────────────────────────────╮
+  # │ 🎟️ AUTHORS SECTION                                                               │
+  # ╰──────────────────────────────────────────────────────────────────────────────────╯
+
+  /api/data/author:
+    get:
+      summary:
+        Returns a targets' competition (id) main Scoreboard widget (data).
+      #
+      parameters:
+        - name: filter
+          in: query
+          description: Target fixture (main) SCOREBOARD widget data parameters
+          required: true
+          style: form
+          explode: true
+          schema:
+            type: object
+            properties:
+              hasura:
+                type: boolean
+                example: true
+              permalink:
+                type: string
+                example: "betarena-tennis-it/australian-open-men-singles-ryan-peniston-vs-elias-ymer-2023-2024-pronostici-probabili-formazioni-e-consigli-per-le-scommesse-8yomojf34kyzq0j1707239136"
+              lang:
+                type: string
+                example: "es"
+            additionalProperties: false
+            oneOf:
+              # translation
+              - required: [permalink]
+              - required: [permalink, hasura]
+              - required: [lang]
+              - required: [lang, hasura]
+      #
+      responses:
+        200:
+          description: Target competition HIGHLIGHTS widget data
+    #
+  #
+
 components:
 
   schemas: