coursecode 0.1.0

package/framework/css/components/lightbox.css

@@ -0,0 +1,666 @@
+/* ============================================================================
+   LIGHTBOX - Click-to-enlarge media viewer
+   ============================================================================
+   
+   WHAT: Fullscreen overlay for viewing images and videos
+   
+   INCLUDES:
+   - Image lightbox with gallery navigation
+   - Video lightbox (YouTube, Vimeo, native)
+   - Responsive controls
+   - Keyboard navigation (ESC, arrows)
+   
+   DEPENDENCIES:
+   - design-tokens.css (--color-*, --space-*, --shadow-*, --transition-*)
+   - icons.js (for close button, navigation arrows)
+   
+   USED BY:
+   - framework/js/components/ui-components/lightbox.js
+   
+   LAST UPDATED: 2026-02-04
+   ============================================================================ */
+
+/* Lightbox trigger — zoom-in cursor signals "click to enlarge" */
+[data-component="lightbox"] {
+    cursor: zoom-in;
+}
+
+/* Lightbox container - hidden by default */
+.lightbox {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    z-index: var(--z-modal);
+    display: none;
+    align-items: center;
+    justify-content: center;
+}
+
+.lightbox.active {
+    display: flex;
+}
+
+/* Dark backdrop overlay */
+.lightbox-backdrop {
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: rgba(0, 0, 0, 0.9);
+    cursor: zoom-out;
+    opacity: 0;
+    transition: opacity var(--transition-normal);
+}
+
+.lightbox.active .lightbox-backdrop {
+    opacity: 1;
+}
+
+/* Content container */
+.lightbox-content {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    max-width: 90vw;
+    max-height: 90vh;
+    z-index: 1;
+}
+
+/* Media wrapper (image or video) with loading state */
+.lightbox-media-wrapper {
+    position: relative;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 200px;
+    min-height: 200px;
+}
+
+/* The enlarged image */
+.lightbox-image {
+    max-width: 90vw;
+    max-height: 80vh;
+    object-fit: contain;
+    border-radius: var(--radius-md);
+    box-shadow: var(--shadow-xl);
+    opacity: 0;
+    transition: opacity var(--transition-normal);
+}
+
+/* Loading spinner */
+.lightbox-loading {
+    position: absolute;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: var(--color-white);
+}
+
+/* Video container */
+.lightbox-video {
+    display: none;
+    width: 80vw;
+    max-width: 1200px;
+    aspect-ratio: 16 / 9;
+    border-radius: var(--radius-md);
+    overflow: hidden;
+    box-shadow: var(--shadow-xl);
+}
+
+/* Embedded videos (YouTube, Vimeo) */
+.lightbox-video-embed {
+    width: 100%;
+    height: 100%;
+    border: none;
+    border-radius: inherit;
+}
+
+/* Native HTML5 video */
+.lightbox-video-native {
+    width: 100%;
+    height: 100%;
+    object-fit: contain;
+    border-radius: inherit;
+    background: var(--color-black);
+}
+
+/* Close button */
+.lightbox-close {
+    position: absolute;
+    top: var(--space-4);
+    right: var(--space-4);
+    background: rgba(255, 255, 255, 0.1);
+    border: none;
+    border-radius: var(--radius-full);
+    color: var(--color-white);
+    width: 48px;
+    height: 48px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+    transition: background var(--transition-fast);
+    z-index: 10;
+}
+
+.lightbox-close:hover {
+    background: rgba(255, 255, 255, 0.2);
+}
+
+.lightbox-close:focus-visible {
+    outline: 2px solid var(--color-white);
+    outline-offset: 2px;
+}
+
+/* Caption */
+.lightbox-caption {
+    margin-top: var(--space-4);
+    color: var(--color-white);
+    font-size: var(--font-size-sm);
+    text-align: center;
+    max-width: 80vw;
+    opacity: 0.9;
+}
+
+/* Navigation buttons (prev/next) */
+.lightbox-nav {
+    position: absolute;
+    top: 50%;
+    transform: translateY(-50%);
+    background: rgba(255, 255, 255, 0.1);
+    border: none;
+    border-radius: var(--radius-full);
+    color: var(--color-white);
+    width: 56px;
+    height: 56px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+    transition: background var(--transition-fast);
+}
+
+.lightbox-nav:hover {
+    background: rgba(255, 255, 255, 0.2);
+}
+
+.lightbox-nav:focus-visible {
+    outline: 2px solid var(--color-white);
+    outline-offset: 2px;
+}
+
+.lightbox-prev {
+    left: var(--space-4);
+}
+
+.lightbox-next {
+    right: var(--space-4);
+}
+
+/* ============================================================================
+   RESPONSIVE
+   ============================================================================ */
+
+@media (max-width: 768px) {
+    .lightbox-close {
+        top: var(--space-2);
+        right: var(--space-2);
+        width: 40px;
+        height: 40px;
+    }
+
+    .lightbox-nav {
+        width: 44px;
+        height: 44px;
+    }
+
+    .lightbox-prev {
+        left: var(--space-2);
+    }
+
+    .lightbox-next {
+        right: var(--space-2);
+    }
+
+    .lightbox-image {
+        max-width: 95vw;
+        max-height: 75vh;
+    }
+
+    .lightbox-video {
+        width: 95vw;
+    }
+}
+
+/* ============================================================================
+   ACCESSIBILITY
+   ============================================================================ */
+
+@media (prefers-reduced-motion: reduce) {
+
+    .lightbox-backdrop,
+    .lightbox-image {
+        transition: none;
+    }
+}
+
+/* ============================================================================
+   MARKDOWN CONTENT
+   ============================================================================ */
+
+/* Markdown container - scrollable document view */
+.lightbox-markdown {
+    display: none;
+    width: 80vw;
+    max-width: 800px;
+    max-height: 80vh;
+    overflow-y: auto;
+    background: #ffffff;
+    color: #1a1a1a;
+    border-radius: 8px;
+    box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+    padding: 2rem;
+    text-align: left;
+    line-height: 1.7;
+    font-size: 1rem;
+}
+
+/* Typography within markdown */
+.lightbox-markdown h1,
+.lightbox-markdown h2,
+.lightbox-markdown h3,
+.lightbox-markdown h4,
+.lightbox-markdown h5,
+.lightbox-markdown h6 {
+    margin-top: 1.5em;
+    margin-bottom: 0.5em;
+    font-weight: 600;
+    line-height: 1.3;
+    color: #111111;
+}
+
+.lightbox-markdown h1 {
+    font-size: 1.75em;
+    margin-top: 0;
+}
+
+.lightbox-markdown h2 {
+    font-size: 1.5em;
+    border-bottom: 1px solid #e0e0e0;
+    padding-bottom: 0.3em;
+}
+
+.lightbox-markdown h3 {
+    font-size: 1.25em;
+}
+
+.lightbox-markdown h4 {
+    font-size: 1.1em;
+}
+
+.lightbox-markdown p {
+    margin: 0 0 1em 0;
+}
+
+.lightbox-markdown a {
+    color: #2563eb;
+    text-decoration: underline;
+}
+
+.lightbox-markdown a:hover {
+    opacity: 0.8;
+}
+
+.lightbox-markdown ul,
+.lightbox-markdown ol {
+    margin: 0 0 1em 0;
+    padding-left: 1.5em;
+}
+
+.lightbox-markdown li {
+    margin-bottom: 0.25em;
+}
+
+.lightbox-markdown code {
+    font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
+    font-size: 0.9em;
+    background: #f5f5f5;
+    padding: 0.2em 0.4em;
+    border-radius: 4px;
+}
+
+.lightbox-markdown pre {
+    margin: 0 0 1em 0;
+    padding: 1rem;
+    background: #f5f5f5;
+    border-radius: 6px;
+    overflow-x: auto;
+}
+
+.lightbox-markdown pre code {
+    padding: 0;
+    background: none;
+}
+
+.lightbox-markdown blockquote {
+    margin: 0 0 1em 0;
+    padding: 1rem;
+    border-left: 4px solid #2563eb;
+    background: #f5f5f5;
+    border-radius: 0 4px 4px 0;
+}
+
+.lightbox-markdown blockquote p:last-child {
+    margin-bottom: 0;
+}
+
+.lightbox-markdown hr {
+    margin: 2em 0;
+    border: none;
+    border-top: 1px solid #e0e0e0;
+}
+
+.lightbox-markdown table {
+    width: 100%;
+    margin: 0 0 1em 0;
+    border-collapse: collapse;
+}
+
+.lightbox-markdown th,
+.lightbox-markdown td {
+    padding: 0.5rem 0.75rem;
+    border: 1px solid #e0e0e0;
+    text-align: left;
+}
+
+.lightbox-markdown th {
+    background: #f5f5f5;
+    font-weight: 600;
+}
+
+.lightbox-markdown img {
+    max-width: 100%;
+    height: auto;
+    border-radius: 6px;
+}
+
+/* Error state */
+.lightbox-danger {
+    color: #dc2626;
+    padding: 2rem;
+    text-align: center;
+}
+
+/* Responsive markdown */
+@media (max-width: 768px) {
+    .lightbox-markdown {
+        width: 95vw;
+        max-height: 75vh;
+        padding: 1rem;
+        font-size: 0.875rem;
+    }
+}
+
+/* ============================================================================
+   MARKDOWN THUMBNAIL PREVIEW
+   ============================================================================ */
+
+/* Thumbnail container - shows first portion of rendered markdown */
+.lightbox-md-thumbnail {
+    display: block;
+    position: relative;
+    width: 280px;
+    height: 200px;
+    overflow: hidden;
+    background: var(--bg-surface);
+    border: 3px solid var(--border-default);
+    border-radius: var(--radius-lg);
+    box-shadow: var(--shadow-md);
+    cursor: zoom-in;
+    transition: box-shadow var(--transition-normal), transform var(--transition-normal), border-color var(--transition-normal);
+}
+
+.lightbox-md-thumbnail:hover {
+    box-shadow: var(--shadow-xl);
+    border-color: var(--color-primary);
+    transform: translateY(-2px);
+}
+
+/* Fade out at bottom to indicate more content */
+.lightbox-md-thumbnail::after {
+    content: '';
+    position: absolute;
+    bottom: 0;
+    left: 0;
+    right: 0;
+    height: 60px;
+    background: linear-gradient(to top, var(--bg-surface), transparent);
+    pointer-events: none;
+}
+
+/* Inner content container */
+.lightbox-md-thumbnail-content {
+    padding: var(--space-4);
+    font-size: 0.65rem;
+    line-height: 1.4;
+    color: var(--color-text);
+    overflow: hidden;
+}
+
+/* Scale down markdown elements for thumbnail */
+.lightbox-md-thumbnail-content h1 {
+    font-size: 0.9rem;
+    margin: 0 0 0.5em 0;
+}
+
+.lightbox-md-thumbnail-content h2 {
+    font-size: 0.75rem;
+    margin: 0.8em 0 0.3em 0;
+    border-bottom: none;
+    padding-bottom: 0;
+}
+
+.lightbox-md-thumbnail-content h3,
+.lightbox-md-thumbnail-content h4 {
+    font-size: 0.7rem;
+    margin: 0.5em 0 0.25em 0;
+}
+
+.lightbox-md-thumbnail-content p {
+    margin: 0 0 0.5em 0;
+}
+
+.lightbox-md-thumbnail-content ul,
+.lightbox-md-thumbnail-content ol {
+    margin: 0 0 0.5em 0;
+    padding-left: 1em;
+}
+
+.lightbox-md-thumbnail-content code {
+    font-size: 0.6rem;
+    padding: 0.1em 0.2em;
+}
+
+.lightbox-md-thumbnail-content pre {
+    font-size: 0.55rem;
+    padding: var(--space-2);
+    margin: 0.5em 0;
+}
+
+.lightbox-md-thumbnail-content table {
+    font-size: 0.55rem;
+}
+
+/* Loading state */
+.lightbox-md-thumbnail-loading {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    height: 100%;
+    color: var(--text-muted);
+}
+
+/* Error state */
+.lightbox-md-thumbnail-danger {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    height: 100%;
+    gap: var(--space-2);
+    color: var(--text-muted);
+}
+
+.lightbox-md-thumbnail-danger span {
+    font-size: var(--font-size-sm);
+}
+
+/* ============================================================================
+   CUSTOM THUMBNAIL OVERRIDE
+   ============================================================================ */
+
+/* Container for custom thumbnail images (data-lightbox-thumbnail) */
+.lightbox-custom-thumbnail {
+    display: block;
+    position: relative;
+    width: 280px;
+    height: 200px;
+    overflow: hidden;
+    background: var(--bg-surface);
+    border: 3px solid var(--border-default);
+    border-radius: var(--radius-lg);
+    box-shadow: var(--shadow-md);
+    cursor: zoom-in;
+    transition: box-shadow var(--transition-normal), transform var(--transition-normal), border-color var(--transition-normal);
+}
+
+.lightbox-custom-thumbnail:hover {
+    box-shadow: var(--shadow-xl);
+    border-color: var(--color-primary);
+    transform: translateY(-2px);
+}
+
+.lightbox-custom-thumbnail-img {
+    display: block;
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+}
+
+/* ============================================================================
+   PDF THUMBNAIL PLACEHOLDER
+   ============================================================================ */
+
+/* PDF thumbnail container - styled placeholder since we can't preview PDF content */
+.lightbox-pdf-thumbnail {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 280px;
+    height: 200px;
+    background: linear-gradient(135deg, var(--bg-subtle) 0%, var(--bg-surface) 100%);
+    border: 3px solid var(--border-default);
+    border-radius: var(--radius-lg);
+    box-shadow: var(--shadow-md);
+    cursor: zoom-in;
+    transition: box-shadow var(--transition-normal), transform var(--transition-normal), border-color var(--transition-normal);
+}
+
+.lightbox-pdf-thumbnail:hover {
+    box-shadow: var(--shadow-xl);
+    border-color: var(--color-primary);
+    transform: translateY(-2px);
+}
+
+.lightbox-pdf-thumbnail-content {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: var(--space-2);
+    text-align: center;
+    padding: var(--space-4);
+}
+
+.lightbox-pdf-thumbnail-icon {
+    color: var(--color-danger, #dc2626);
+    opacity: 0.9;
+}
+
+.lightbox-pdf-thumbnail-badge {
+    display: inline-block;
+    padding: var(--space-1) var(--space-2);
+    background: var(--color-danger, #dc2626);
+    color: var(--color-white);
+    font-size: var(--font-size-xs);
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    border-radius: var(--radius-sm);
+}
+
+.lightbox-pdf-thumbnail-filename {
+    font-size: var(--font-size-xs);
+    color: var(--text-muted);
+    max-width: 160px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+/* ============================================================================
+   THUMBNAIL SUBTITLE
+   ============================================================================ */
+
+/* Wrapper for thumbnail + subtitle */
+.lightbox-thumbnail-wrapper {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: var(--space-2);
+}
+
+.lightbox-thumbnail-subtitle {
+    display: block;
+    font-size: var(--font-size-sm);
+    color: var(--text-muted);
+    text-align: center;
+    max-width: 100%;
+}
+
+/* ============================================================================
+   PDF VIEWER (IFRAME IN LIGHTBOX)
+   ============================================================================ */
+
+/* PDF iframe container */
+.lightbox-pdf {
+    display: none;
+    width: 80vw;
+    max-width: 1000px;
+    height: 80vh;
+    border: none;
+    border-radius: var(--radius-md);
+    background: var(--bg-surface);
+    box-shadow: var(--shadow-xl);
+}
+
+/* Responsive PDF viewer */
+@media (max-width: 768px) {
+    .lightbox-pdf-thumbnail {
+        width: 160px;
+        height: 130px;
+    }
+
+    .lightbox-pdf-thumbnail-filename {
+        max-width: 120px;
+    }
+
+    .lightbox-pdf {
+        width: 95vw;
+        height: 75vh;
+    }
+}

package/framework/css/components/loading.css

@@ -0,0 +1,65 @@
+/* ============================================================================
+   LOADING INDICATOR - Initial course load state
+   ============================================================================
+   
+   PURPOSE: Display loading state during course initialization
+   
+   INCLUDES:
+   - Loading container styles
+   - Centered layout
+   - Text styling
+   - Integration with footer hide
+   
+   DEPENDENCIES:
+   - Requires: design-tokens.css (for CSS variables)
+   
+   USED BY:
+   - Course initialization phase
+   - Content loading display
+   
+   AI DEBUGGING TIPS:
+   - Loading not showing? Check if #loading element exists in HTML
+   - Footer not hiding during load? Verify footer.css hide rule
+   - Text color wrong? Check var(--text-muted) token
+   
+   ============================================================================ */
+
+/* Loading indicator - overlay that covers the content area */
+#loading {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: var(--space-4);
+  /* Match main content background */
+  background: var(--bg-page);
+  background-image:
+    radial-gradient(circle at 20% 50%, var(--color-secondary-alpha-05) 0%, transparent 50%),
+    radial-gradient(circle at 80% 80%, var(--color-primary-alpha-10) 0%, transparent 50%);
+  color: var(--text-muted);
+  z-index: 100;
+}
+
+/* Loading text styling */
+#loading .loading-text {
+  font-size: var(--font-size-base);
+  color: var(--text-secondary);
+}
+
+/* Spinner inside loading indicator */
+#loading .spinner {
+  width: 2.5rem;
+  height: 2.5rem;
+  border-width: 0.25em;
+}
+
+/* Hide loading when removed from DOM or has hidden attribute */
+#loading[hidden],
+#loading.hidden {
+  display: none;
+}