@ibgib/space-gib 0.0.35 → 0.0.36

package/src/client/ui/component/tutorial/tutorial.css

@@ -0,0 +1,260 @@
+/**
+ * tutorial.css — Styles for the Space-Gib Interactive Tutorial & Spotlight Tour
+ */
+
+.tutorial-overlay-container {
+    position: fixed;
+    inset: 0;
+    z-index: 10000;
+    pointer-events: none;
+    transition: opacity 0.3s ease;
+}
+
+/* Semi-transparent dimmer backdrop */
+.tutorial-backdrop {
+    position: absolute;
+    inset: 0;
+    background: rgba(8, 10, 15, 0.75);
+    backdrop-filter: blur(3px);
+    -webkit-backdrop-filter: blur(3px);
+    pointer-events: auto;
+    transition: clip-path 0.35s cubic-bezier(0.2, 0.9, 0.3, 1);
+}
+
+/* Glowing spotlight ring around the active target */
+.tutorial-spotlight-ring {
+    position: absolute;
+    border-radius: 8px;
+    box-shadow: 0 0 0 4px rgba(255, 204, 0, 0.6),
+                0 0 25px 6px rgba(255, 180, 0, 0.4),
+                inset 0 0 15px rgba(255, 204, 0, 0.2);
+    pointer-events: none;
+    transition: top 0.35s cubic-bezier(0.2, 0.9, 0.3, 1),
+                left 0.35s cubic-bezier(0.2, 0.9, 0.3, 1),
+                width 0.35s cubic-bezier(0.2, 0.9, 0.3, 1),
+                height 0.35s cubic-bezier(0.2, 0.9, 0.3, 1);
+    z-index: 10001;
+}
+
+/* Movable Golden Beacon Button */
+.tutorial-beacon {
+    position: absolute;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 8px 18px;
+    background: linear-gradient(135deg, #ffd700 0%, #ff9900 100%);
+    color: #121212;
+    font-family: inherit;
+    font-size: 0.95rem;
+    font-weight: 700;
+    border: 2px solid rgba(255, 255, 255, 0.8);
+    border-radius: 9999px;
+    box-shadow: 0 4px 20px rgba(255, 180, 0, 0.65), 0 0 30px rgba(255, 215, 0, 0.4);
+    cursor: pointer;
+    pointer-events: auto;
+    z-index: 10002;
+    transition: top 0.35s cubic-bezier(0.2, 0.9, 0.3, 1),
+                left 0.35s cubic-bezier(0.2, 0.9, 0.3, 1),
+                transform 0.2s ease,
+                box-shadow 0.2s ease;
+    animation: beacon-pulse 2s infinite ease-in-out;
+}
+
+.tutorial-beacon:hover {
+    transform: scale(1.06);
+    box-shadow: 0 6px 28px rgba(255, 190, 0, 0.85), 0 0 40px rgba(255, 230, 100, 0.6);
+}
+
+.tutorial-beacon:active {
+    transform: scale(0.96);
+}
+
+.tutorial-beacon-icon {
+    font-size: 1.15rem;
+    line-height: 1;
+}
+
+.tutorial-beacon-text {
+    letter-spacing: 0.02em;
+}
+
+@keyframes beacon-pulse {
+    0%, 100% {
+        box-shadow: 0 4px 20px rgba(255, 180, 0, 0.65), 0 0 15px rgba(255, 215, 0, 0.4);
+    }
+    50% {
+        box-shadow: 0 4px 30px rgba(255, 200, 0, 0.9), 0 0 35px rgba(255, 230, 50, 0.7);
+    }
+}
+
+/* Floating Glassmorphic Narration Card */
+.tutorial-card {
+    position: absolute;
+    width: 440px;
+    max-width: calc(100vw - 32px);
+    background: rgba(18, 22, 34, 0.88);
+    backdrop-filter: blur(16px);
+    -webkit-backdrop-filter: blur(16px);
+    border: 1px solid rgba(255, 215, 0, 0.25);
+    border-radius: 14px;
+    box-shadow: 0 16px 40px rgba(0, 0, 0, 0.6), 0 0 20px rgba(255, 200, 0, 0.15);
+    padding: 22px 24px;
+    color: #e2e8f0;
+    pointer-events: auto;
+    z-index: 10002;
+    transition: top 0.35s cubic-bezier(0.2, 0.9, 0.3, 1),
+                left 0.35s cubic-bezier(0.2, 0.9, 0.3, 1),
+                opacity 0.25s ease;
+}
+
+.tutorial-card.placement-center {
+    top: 50% !important;
+    left: 50% !important;
+    transform: translate(-50%, -50%);
+    width: 580px;
+    border-color: rgba(255, 215, 0, 0.45);
+    box-shadow: 0 20px 60px rgba(0, 0, 0, 0.8), 0 0 40px rgba(255, 200, 0, 0.25);
+}
+
+.tutorial-card-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 12px;
+}
+
+.tutorial-step-badge {
+    font-size: 0.75rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    color: #ffd700;
+    background: rgba(255, 215, 0, 0.12);
+    padding: 4px 10px;
+    border-radius: 9999px;
+    border: 1px solid rgba(255, 215, 0, 0.3);
+}
+
+.tutorial-card-close {
+    background: none;
+    border: none;
+    color: #94a3b8;
+    font-size: 1.25rem;
+    cursor: pointer;
+    padding: 4px 8px;
+    border-radius: 6px;
+    transition: color 0.15s ease, background 0.15s ease;
+}
+
+.tutorial-card-close:hover {
+    color: #ffffff;
+    background: rgba(255, 255, 255, 0.1);
+}
+
+.tutorial-card-title {
+    margin: 0 0 12px 0;
+    font-size: 1.2rem;
+    font-weight: 700;
+    color: #ffffff;
+    line-height: 1.35;
+}
+
+.tutorial-card-body {
+    font-size: 0.92rem;
+    line-height: 1.6;
+    color: #cbd5e1;
+    margin-bottom: 20px;
+    max-height: 55vh;
+    overflow-y: auto;
+}
+
+.tutorial-card-body p {
+    margin: 0 0 10px 0;
+}
+
+.tutorial-card-body p:last-child {
+    margin-bottom: 0;
+}
+
+.tutorial-card-body strong {
+    color: #f8fafc;
+}
+
+.tutorial-card-body em {
+    color: #ffd700;
+    font-style: normal;
+}
+
+.tutorial-card-footer {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding-top: 14px;
+    border-top: 1px solid rgba(255, 255, 255, 0.08);
+}
+
+.tutorial-progress-dots {
+    display: flex;
+    gap: 6px;
+}
+
+.tutorial-dot {
+    width: 8px;
+    height: 8px;
+    border-radius: 9999px;
+    background: rgba(255, 255, 255, 0.2);
+    transition: background 0.25s ease, transform 0.25s ease;
+}
+
+.tutorial-dot.active {
+    background: #ffd700;
+    transform: scale(1.25);
+    box-shadow: 0 0 8px #ffd700;
+}
+
+.tutorial-card-actions {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+}
+
+.tutorial-btn-skip {
+    background: none;
+    border: none;
+    color: #94a3b8;
+    font-size: 0.85rem;
+    cursor: pointer;
+    padding: 6px 12px;
+    border-radius: 6px;
+    transition: color 0.15s ease;
+}
+
+.tutorial-btn-skip:hover {
+    color: #ffffff;
+}
+
+.tutorial-btn-next {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    background: linear-gradient(135deg, #ffd700 0%, #ffaa00 100%);
+    color: #0f172a;
+    font-weight: 700;
+    font-size: 0.9rem;
+    padding: 8px 18px;
+    border: none;
+    border-radius: 8px;
+    cursor: pointer;
+    box-shadow: 0 4px 14px rgba(255, 180, 0, 0.4);
+    transition: transform 0.15s ease, box-shadow 0.15s ease;
+}
+
+.tutorial-btn-next:hover {
+    transform: translateY(-1px);
+    box-shadow: 0 6px 20px rgba(255, 180, 0, 0.6);
+}
+
+.tutorial-btn-next:active {
+    transform: translateY(1px);
+}

package/src/client/ui/shell/space-gib-shell-service.mts

@@ -53,6 +53,10 @@ import {
 import {
     registerPitchComponent, PITCH_COMPONENT_NAME, PitchComponentInstance,
 } from "../component/pitch/index.mjs";
+import {
+    getTutorialController,
+    PITCH_TOUR_SCRIPT,
+} from "../component/tutorial/index.mjs";
 import {
     registerCodeEditorComponent, CODE_EDITOR_COMPONENT_NAME,
     CodeEditorComponentInstance,
@@ -213,6 +217,13 @@ export class SpaceGibShellService {
     private notesExplorerInstance?: NotesExplorerComponentInstance;
     private notesInspectorInstance?: NotesInspectorComponentInstance;
 
+    public getCosmosNavigator(): CosmosNavigatorComponentInstance | undefined {
+        return this.cosmosNavigatorInstance;
+    }
+    public getFileExplorer(): FileExplorerComponentInstance | undefined {
+        return this.fileExplorerInstance;
+    }
+
     // Panel States
     private leftPanelState: PanelState = 'collapsed';
     private rightPanelState: PanelState = 'collapsed';
@@ -1497,38 +1508,30 @@ export class SpaceGibShellService {
     }
 
     public async showPitch(): Promise<void> {
-        const lc = `${this.lc}[${this.showPitch.name}]`;
-        try {
-            const centerPanel = document.getElementById(ID_CENTER_PANEL_CONTENT);
-            if (!centerPanel) {
-                console.warn(`${lc} ${ID_CENTER_PANEL_CONTENT} element not found.`);
-                return;
-            }
-
-            if (!this.pitchInstance) {
-                const componentSvc = await getComponentSvc();
-                this.pitchInstance = await componentSvc.getComponentInstance({
-                    path: PITCH_COMPONENT_NAME,
-                    ibGibAddr: ROOT_ADDR,
-                    useRegExpPrefilter: true,
-                }) as PitchComponentInstance;
-            }
+        await this.startPitchTour();
+    }
 
-            if (this.pitchInstance) {
-                const componentSvc = await getComponentSvc();
-                await componentSvc.inject({
-                    parentEl: centerPanel,
-                    componentToInject: this.pitchInstance,
-                });
+    public async startPitchTour(): Promise<void> {
+        const lc = `${this.lc}[${this.startPitchTour.name}]`;
+        console.log(`${lc} startPitchTour triggered.`);
+        try {
+            const tutorial = getTutorialController();
+            console.log(`${lc} tutorialController isActive = ${tutorial.isActive}`);
+            if (tutorial.isActive) {
+                await tutorial.next();
+            } else {
+                await tutorial.start(PITCH_TOUR_SCRIPT, this);
             }
-
-            this.collapsePanels();
         } catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
         }
     }
 
     public closePitch(): void {
+        const tutorial = getTutorialController();
+        if (tutorial.isActive) {
+            tutorial.stop();
+        }
         this.showCosmos();
     }
 
@@ -1768,6 +1771,7 @@ export class SpaceGibShellService {
         const btnHeaderClone = document.getElementById('btn-header-clone');
 
         btnHeaderPitch?.addEventListener('click', () => {
+            console.log(`[SpaceGibShellService] #btn-header-pitch clicked! Triggering showPitch()...`);
             this.showPitch();
         });