@ibgib/space-gib 0.0.34 → 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/router/space-gib-router-helpers.mts

@@ -2,199 +2,50 @@
  * @module client/ui/router/space-gib-router-helpers
  *
  * Route parsing and formatting helpers for the Space-Gib Client Router.
- * Pure isomorphic functions with zero DOM dependency.
+ * Delegates universal Cosmos & Galaxy routes to @ibgib/web-gib,
+ * while handling space-gib specific routes (/admin/review).
  */
 
 import {
-    SpaceGibRouteInfo, SpaceGibTenant,
+    parseCosmosRoute,
+    formatCosmosRoute,
+    isSameCosmosRoute,
+    safeDecode,
+    ParseCosmosRouteOptions,
+    CosmosRouteInfo,
+} from '@ibgib/web-gib/dist/ui/router/index.mjs';
+
+import {
+    SpaceGibRouteInfo,
+    AdminReviewRouteInfo,
 } from './space-gib-router-types.mjs';
 
-/**
- * Safely decodes a URI component, returning the raw string if decoding fails.
- */
-function safeDecode(str: string): string {
-    try {
-        return decodeURIComponent(str);
-    } catch {
-        return str;
-    }
-}
+export { safeDecode };
+export type ParseSpaceGibRouteOptions = ParseCosmosRouteOptions;
 
 /**
  * Parses a browser pathname into a structured SpaceGibRouteInfo.
- *
- * Supports:
- * - Polycosmos: / or /polycosmos or /@:siteUsername or /keystone/:keystoneTjp
- * - Cosmos: /:cosmos or /@:siteUsername/:cosmos or /keystone/:keystoneTjp/:cosmos
- * - Code Galaxy: /:cosmos/code/:galaxyId[/:branch[/*filePath]]
- * - Notes Galaxy: /:cosmos/notes/:galaxyId[/:topicTjp]
- * - Raw Addr (Snapshot): /:cosmos/:spaceId/addr/:ibGibAddr
- * - Raw Tjp (Living Tip): /:cosmos/:spaceId/tjp/:tjpAddr
- * - Admin Review: /admin/review[/:tjpGib]
+ * Handles /admin/review explicitly, and delegates all Cosmos / Galaxy / Raw routes to @ibgib/web-gib.
  */
-export function parseSpaceGibRoute(pathname: string): SpaceGibRouteInfo {
+export function parseSpaceGibRoute(pathname: string, opts?: ParseSpaceGibRouteOptions): SpaceGibRouteInfo {
     let p = (pathname || '').trim();
 
-    let queryObj: Record<string, string> | undefined;
-    const qIdx = p.indexOf('?');
-    if (qIdx !== -1) {
-        const qStr = p.substring(qIdx + 1);
-        p = p.substring(0, qIdx);
-        const searchParams = new URLSearchParams(qStr);
-        const q: Record<string, string> = {};
-        searchParams.forEach((val, key) => {
-            q[key] = val;
-        });
-        if (Object.keys(q).length > 0) {
-            queryObj = q;
-        }
-    }
-    const hIdx = p.indexOf('#');
-    if (hIdx !== -1) { p = p.substring(0, hIdx); }
+    // Check query string/hash for /admin/review prefix
+    let cleanPath = p;
+    const qIdx = cleanPath.indexOf('?');
+    if (qIdx !== -1) { cleanPath = cleanPath.substring(0, qIdx); }
+    const hIdx = cleanPath.indexOf('#');
+    if (hIdx !== -1) { cleanPath = cleanPath.substring(0, hIdx); }
 
-    if (!p || p === '/') {
-        return { kind: 'polycosmos' };
-    }
-
-    // Special Route: /admin/review
-    if (p === '/admin/review') {
+    if (cleanPath === '/admin/review') {
         return { kind: 'admin-review' };
     }
-    if (p.startsWith('/admin/review/')) {
-        const tjpGib = safeDecode(p.slice('/admin/review/'.length)).trim();
+    if (cleanPath.startsWith('/admin/review/')) {
+        const tjpGib = safeDecode(cleanPath.slice('/admin/review/'.length)).trim();
         return { kind: 'admin-review', ...(tjpGib ? { tjpGib } : {}) };
     }
 
-    const rawSegments = p.split('/').filter(s => s.length > 0);
-    if (rawSegments.length === 0) {
-        return { kind: 'polycosmos' };
-    }
-
-    // Extract tenant prefix if present (@username or /keystone/tjp)
-    let tenant: SpaceGibTenant | undefined;
-    let segIdx = 0;
-
-    if (rawSegments[0].startsWith('@')) {
-        const username = safeDecode(rawSegments[0].slice(1)).trim();
-        if (username) {
-            tenant = { type: 'username', siteUsername: username };
-            segIdx = 1;
-        }
-    } else if (rawSegments[0] === 'keystone' && rawSegments.length > 1) {
-        const keystoneTjp = safeDecode(rawSegments[1]).trim();
-        if (keystoneTjp) {
-            tenant = { type: 'keystone', keystoneTjp };
-            segIdx = 2;
-        }
-    }
-
-    const remaining = rawSegments.slice(segIdx);
-
-    // If only tenant specifier was given (e.g. /@bill or /keystone/tjp123)
-    if (remaining.length === 0) {
-        return { kind: 'polycosmos', ...(tenant ? { tenant } : {}) };
-    }
-
-    if (remaining.length === 1 && remaining[0] === 'polycosmos') {
-        return { kind: 'polycosmos', ...(tenant ? { tenant } : {}) };
-    }
-
-    const cosmos = safeDecode(remaining[0]).trim();
-
-    if (remaining.length === 1) {
-        return { kind: 'cosmos', ...(tenant ? { tenant } : {}), cosmos };
-    }
-
-    const second = safeDecode(remaining[1]).trim();
-
-    // Code Galaxy: /:cosmos/code/:galaxyId[/:branch[/*filePath]]
-    if (second === 'code') {
-        const galaxyId = remaining[2] ? safeDecode(remaining[2]).trim() : '';
-        if (!galaxyId) {
-            return { kind: 'cosmos', ...(tenant ? { tenant } : {}), cosmos };
-        }
-        const branch = remaining[3] ? safeDecode(remaining[3]).trim() : undefined;
-        const filePath = remaining.length > 4 ? remaining.slice(4).map(safeDecode).join('/') : undefined;
-        return {
-            kind: 'code-galaxy',
-            ...(tenant ? { tenant } : {}),
-            cosmos,
-            galaxyId,
-            ...(branch ? { branch } : {}),
-            ...(filePath ? { filePath } : {}),
-        };
-    }
-
-    // Notes Galaxy: /:cosmos/notes/:galaxyId[/tjp/:tjp1/:tjp2...] or [/addr/:addr1/:addr2...] or [/:topicTjp]
-    if (second === 'notes') {
-        const galaxyId = remaining[2] ? safeDecode(remaining[2]).trim() : '';
-        if (!galaxyId) {
-            return { kind: 'cosmos', ...(tenant ? { tenant } : {}), cosmos };
-        }
-
-        let trailMode: 'tjp' | 'addr' | undefined;
-        let trail: string[] | undefined;
-        let topicTjp: string | undefined;
-
-        if (remaining.length > 3) {
-            const modeCandidate = safeDecode(remaining[3]).trim();
-            if (modeCandidate === 'tjp' || modeCandidate === 'addr') {
-                trailMode = modeCandidate;
-                const trailSegments = remaining.slice(4).map(s => safeDecode(s).trim()).filter(s => s.length > 0);
-                if (trailSegments.length > 0) {
-                    trail = trailSegments;
-                    topicTjp = trailSegments[0];
-                }
-            } else {
-                // Backward compatibility / shorthand: /notes/:galaxyId/:topicTjp
-                topicTjp = modeCandidate;
-                trailMode = 'tjp';
-                trail = [modeCandidate];
-            }
-        }
-
-        return {
-            kind: 'notes-galaxy',
-            ...(tenant ? { tenant } : {}),
-            cosmos,
-            galaxyId,
-            ...(trailMode ? { trailMode } : {}),
-            ...(trail ? { trail } : {}),
-            ...(topicTjp ? { topicTjp } : {}),
-            ...(queryObj ? { query: queryObj } : {}),
-        };
-    }
-
-    // Mechanism 1: Space-Qualified Raw Addrs
-    // /:cosmos/:spaceId/addr/:ibGibAddr
-    // /:cosmos/:spaceId/tjp/:tjpAddr
-    if (remaining.length >= 4) {
-        const third = safeDecode(remaining[2]).trim();
-        const spaceId = second;
-        if (third === 'addr') {
-            const ibGibAddr = safeDecode(remaining.slice(3).join('/')).trim();
-            return {
-                kind: 'raw-addr',
-                ...(tenant ? { tenant } : {}),
-                cosmos,
-                spaceId,
-                ibGibAddr,
-            };
-        }
-        if (third === 'tjp') {
-            const tjpAddr = safeDecode(remaining.slice(3).join('/')).trim();
-            return {
-                kind: 'raw-tjp',
-                ...(tenant ? { tenant } : {}),
-                cosmos,
-                spaceId,
-                tjpAddr,
-            };
-        }
-    }
-
-    // Fallback: Cosmos route
-    return { kind: 'cosmos', ...(tenant ? { tenant } : {}), cosmos };
+    return parseCosmosRoute(pathname, opts) as SpaceGibRouteInfo;
 }
 
 /**
@@ -204,62 +55,7 @@ export function formatSpaceGibRoute(route: SpaceGibRouteInfo): string {
     if (route.kind === 'admin-review') {
         return `/admin/review${route.tjpGib ? `/${encodeURIComponent(route.tjpGib)}` : ''}`;
     }
-
-    let prefix = '';
-    if (route.tenant) {
-        if (route.tenant.type === 'username') {
-            prefix = `/@${encodeURIComponent(route.tenant.siteUsername)}`;
-        } else if (route.tenant.type === 'keystone') {
-            prefix = `/keystone/${encodeURIComponent(route.tenant.keystoneTjp)}`;
-        }
-    }
-
-    switch (route.kind) {
-        case 'polycosmos':
-            return prefix ? `${prefix}/polycosmos` : '/';
-
-        case 'cosmos':
-            return `${prefix}/${encodeURIComponent(route.cosmos)}`;
-
-        case 'code-galaxy': {
-            let res = `${prefix}/${encodeURIComponent(route.cosmos)}/code/${encodeURIComponent(route.galaxyId)}`;
-            if (route.branch) {
-                res += `/${encodeURIComponent(route.branch)}`;
-                if (route.filePath) {
-                    res += `/${route.filePath.split('/').map(encodeURIComponent).join('/')}`;
-                }
-            }
-            return res;
-        }
-
-        case 'notes-galaxy': {
-            let res = `${prefix}/${encodeURIComponent(route.cosmos)}/notes/${encodeURIComponent(route.galaxyId)}`;
-            if (route.trail && route.trail.length > 0) {
-                const mode = route.trailMode || 'tjp';
-                res += `/${mode}/${route.trail.map(encodeURIComponent).join('/')}`;
-            } else if (route.topicTjp) {
-                res += `/${encodeURIComponent(route.topicTjp)}`;
-            }
-            if (route.query && Object.keys(route.query).length > 0) {
-                const sp = new URLSearchParams();
-                for (const [k, v] of Object.entries(route.query)) {
-                    if (v !== undefined) { sp.set(k, v); }
-                }
-                const qs = sp.toString();
-                if (qs) { res += `?${qs}`; }
-            }
-            return res;
-        }
-
-        case 'raw-addr':
-            return `${prefix}/${encodeURIComponent(route.cosmos)}/${encodeURIComponent(route.spaceId)}/addr/${encodeURIComponent(route.ibGibAddr)}`;
-
-        case 'raw-tjp':
-            return `${prefix}/${encodeURIComponent(route.cosmos)}/${encodeURIComponent(route.spaceId)}/tjp/${encodeURIComponent(route.tjpAddr)}`;
-
-        default:
-            return '/';
-    }
+    return formatCosmosRoute(route as CosmosRouteInfo);
 }
 
 /**
@@ -268,5 +64,9 @@ export function formatSpaceGibRoute(route: SpaceGibRouteInfo): string {
 export function isSameRoute(a?: SpaceGibRouteInfo, b?: SpaceGibRouteInfo): boolean {
     if (!a && !b) { return true; }
     if (!a || !b) { return false; }
-    return formatSpaceGibRoute(a) === formatSpaceGibRoute(b);
+    if (a.kind === 'admin-review' || b.kind === 'admin-review') {
+        if (a.kind !== b.kind) { return false; }
+        return (a as AdminReviewRouteInfo).tjpGib === (b as AdminReviewRouteInfo).tjpGib;
+    }
+    return isSameCosmosRoute(a as CosmosRouteInfo, b as CosmosRouteInfo);
 }