ezfw-core 1.0.0

package/template/doc/EzDocs.module.scss

@@ -0,0 +1,627 @@
+:global {
+    .ez-docs {
+        display: flex;
+        flex: 1;
+        min-height: 0;
+        background: var(--ez-surface-primary, #f8fafc);
+        overflow: hidden;
+    }
+
+    .ez-docs-sidebar {
+        width: 280px;
+        min-width: 280px;
+        min-height: 0;
+        align-self: stretch;
+        background: var(--ez-surface-secondary, #ffffff);
+        border-right: 1px solid var(--ez-border, #e2e8f0);
+        display: flex;
+        flex-direction: column;
+        overflow-y: auto;
+        overflow-x: hidden;
+    }
+
+    .ez-docs-header {
+        padding: 20px 16px;
+        border-bottom: 1px solid var(--ez-border, #e2e8f0);
+        display: flex;
+        align-items: center;
+        gap: 12px;
+        cursor: pointer;
+        transition: background 0.15s ease;
+
+        &:hover {
+            background: var(--ez-surface-primary, #f8fafc);
+        }
+    }
+
+    .ez-docs-header-icon {
+        font-size: 20px;
+        color: var(--ez-primary, #005871);
+    }
+
+    .ez-docs-header-title {
+        font-size: 18px;
+        font-weight: 700;
+        color: var(--ez-text-primary, #1e293b);
+    }
+
+    .ez-docs-search {
+        padding: 16px;
+        border-bottom: 1px solid var(--ez-border, #e2e8f0);
+        display: flex;
+        align-items: center;
+        gap: 10px;
+        background: var(--ez-surface-primary, #f8fafc);
+    }
+
+    .ez-docs-search-icon {
+        color: var(--ez-text-tertiary, #94a3b8);
+        font-size: 14px;
+    }
+
+    .ez-docs-search-input {
+        flex: 1;
+        border: none;
+        background: transparent;
+        font-size: 14px;
+        color: var(--ez-text-primary, #1e293b);
+        outline: none;
+
+        &::placeholder {
+            color: var(--ez-text-tertiary, #94a3b8);
+        }
+    }
+
+    .ez-docs-categories {
+        flex: 1;
+        overflow-y: auto;
+        padding: 8px 0;
+    }
+
+    .ez-docs-category {
+        margin-bottom: 8px;
+    }
+
+    .ez-docs-category-header {
+        display: flex;
+        align-items: center;
+        gap: 10px;
+        padding: 10px 16px;
+        color: var(--ez-text-secondary, #64748b);
+        font-size: 12px;
+        font-weight: 600;
+        text-transform: uppercase;
+        letter-spacing: 0.5px;
+    }
+
+    .ez-docs-category-icon {
+        font-size: 12px;
+        width: 16px;
+        text-align: center;
+    }
+
+    .ez-docs-component-list {
+        list-style: none;
+        margin: 0;
+        padding: 0;
+    }
+
+    .ez-docs-component-item {
+        padding: 10px 16px 10px 42px;
+        cursor: pointer;
+        transition: all 0.15s ease;
+        border-left: 3px solid transparent;
+
+        &:hover {
+            background: var(--ez-surface-tertiary, #f1f5f9);
+        }
+
+        &.active {
+            background: var(--ez-primary-light, rgba(0, 88, 113, 0.08));
+            border-left-color: var(--ez-primary, #005871);
+
+            .ez-docs-component-name {
+                color: var(--ez-primary, #005871);
+                font-weight: 500;
+            }
+        }
+    }
+
+    .ez-docs-component-name {
+        font-size: 14px;
+        color: var(--ez-text-primary, #334155);
+    }
+
+    .ez-docs-content {
+        flex: 1;
+        min-width: 0;
+        min-height: 0;
+        align-self: stretch;
+        display: flex;
+        flex-direction: column;
+        overflow-y: auto;
+        overflow-x: hidden;
+    }
+
+    .ez-docs-welcome {
+        flex: 1;
+        display: flex;
+        flex-direction: column;
+        padding: 32px;
+        overflow-y: auto;
+        background: var(--ez-surface-primary, #f8fafc);
+    }
+
+    .ez-docs-welcome-header {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        gap: 8px;
+        margin-bottom: 32px;
+        text-align: center;
+    }
+
+    .ez-docs-welcome-icon {
+        font-size: 48px;
+        color: var(--ez-primary, #005871);
+        margin-bottom: 8px;
+    }
+
+    .ez-docs-welcome-title {
+        font-size: 32px;
+        font-weight: 700;
+        color: var(--ez-text-primary, #1e293b);
+    }
+
+    .ez-docs-welcome-subtitle {
+        font-size: 16px;
+        color: var(--ez-text-secondary, #64748b);
+    }
+
+    .ez-docs-categories-grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+        gap: 20px;
+    }
+
+    .ez-docs-category-items {
+        display: flex;
+        flex-direction: column;
+    }
+
+    .ez-docs-category-item {
+        display: flex;
+        flex-direction: column;
+        gap: 2px;
+        padding: 12px 20px;
+        cursor: pointer;
+        transition: background 0.15s ease;
+        border-bottom: 1px solid var(--ez-border, #e2e8f0);
+
+        &:last-child {
+            border-bottom: none;
+        }
+
+        &:hover {
+            background: var(--ez-surface-primary, #f8fafc);
+
+            .ez-docs-category-item-name {
+                color: var(--ez-primary, #005871);
+            }
+        }
+    }
+
+    .ez-docs-category-item-name {
+        font-size: 14px;
+        font-weight: 500;
+        color: var(--ez-text-primary, #1e293b);
+        font-family: 'Monaco', 'Menlo', monospace;
+        transition: color 0.15s ease;
+    }
+
+    .ez-docs-category-item-desc {
+        font-size: 12px;
+        color: var(--ez-text-secondary, #64748b);
+        line-height: 1.4;
+    }
+
+    .ez-docs-viewer {
+        flex: 1;
+        min-height: 0;
+        display: flex;
+        flex-direction: column;
+        overflow: hidden;
+    }
+
+    .ez-docs-viewer-header {
+        padding: 24px 32px;
+        background: var(--ez-surface-secondary, #ffffff);
+        border-bottom: 1px solid var(--ez-border, #e2e8f0);
+    }
+
+    .ez-docs-viewer-title {
+        font-size: 28px;
+        font-weight: 700;
+        color: var(--ez-text-primary, #1e293b);
+        font-family: 'Monaco', 'Menlo', monospace;
+    }
+
+    .ez-docs-viewer-description {
+        margin-top: 8px;
+        font-size: 16px;
+        color: var(--ez-text-secondary, #64748b);
+    }
+
+    .ez-docs-viewer-tabs {
+        display: flex;
+        gap: 0;
+        background: var(--ez-surface-secondary, #ffffff);
+        border-bottom: 1px solid var(--ez-border, #e2e8f0);
+        padding: 0 32px;
+    }
+
+    .ez-docs-tab {
+        padding: 12px 20px;
+        font-size: 14px;
+        font-weight: 500;
+        color: var(--ez-text-secondary, #64748b);
+        cursor: pointer;
+        border-bottom: 2px solid transparent;
+        margin-bottom: -1px;
+        transition: all 0.15s ease;
+
+        &:hover {
+            color: var(--ez-text-primary, #1e293b);
+        }
+
+        &.active {
+            color: var(--ez-primary, #005871);
+            border-bottom-color: var(--ez-primary, #005871);
+        }
+    }
+
+    .ez-docs-viewer-body {
+        flex: 1;
+        padding: 32px;
+        overflow-y: auto;
+    }
+
+    .ez-docs-placeholder {
+        font-size: 16px;
+        color: var(--ez-text-secondary, #64748b);
+        padding: 24px;
+        background: var(--ez-surface-secondary, #ffffff);
+        border-radius: 8px;
+        border: 1px dashed var(--ez-border, #e2e8f0);
+        text-align: center;
+    }
+
+    .ez-docs-viewer-breadcrumb {
+        display: flex;
+        align-items: center;
+        gap: 4px;
+        margin-bottom: 12px;
+        font-size: 13px;
+        color: var(--ez-text-secondary, #64748b);
+    }
+
+    .ez-docs-breadcrumb-link {
+        color: var(--ez-primary, #005871);
+        cursor: pointer;
+
+        &:hover {
+            text-decoration: underline;
+        }
+    }
+
+    .ez-docs-breadcrumb-category {
+        color: var(--ez-text-secondary, #64748b);
+    }
+
+    .ez-docs-breadcrumb-current {
+        color: var(--ez-text-primary, #1e293b);
+        font-weight: 500;
+    }
+
+    .ez-docs-section {
+        background: var(--ez-surface-secondary, #ffffff);
+        border-radius: 8px;
+        padding: 24px;
+        margin-bottom: 16px;
+        border: 1px solid var(--ez-border, #e2e8f0);
+    }
+
+    .ez-docs-section-title {
+        font-size: 18px;
+        font-weight: 600;
+        color: var(--ez-text-primary, #1e293b);
+        margin-bottom: 12px;
+    }
+
+    .ez-docs-section-content {
+        font-size: 15px;
+        color: var(--ez-text-secondary, #475569);
+        line-height: 1.6;
+    }
+
+    .ez-docs-code-block {
+        background: #1e293b;
+        border-radius: 6px;
+        padding: 16px;
+        overflow-x: auto;
+
+        pre {
+            margin: 0;
+            font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+            font-size: 13px;
+            color: #e2e8f0;
+            line-height: 1.5;
+            white-space: pre-wrap;
+        }
+    }
+
+    .ez-docs-feature-list {
+        margin: 0;
+        padding-left: 20px;
+
+        li {
+            font-size: 14px;
+            color: var(--ez-text-secondary, #475569);
+            line-height: 1.8;
+            margin-bottom: 4px;
+
+            &::marker {
+                color: var(--ez-primary, #005871);
+            }
+        }
+    }
+
+    .ez-docs-api-table {
+        display: flex;
+        flex-direction: column;
+        border: 1px solid var(--ez-border, #e2e8f0);
+        border-radius: 6px;
+        overflow: hidden;
+    }
+
+    .ez-docs-api-row {
+        display: flex;
+        border-bottom: 1px solid var(--ez-border, #e2e8f0);
+
+        &:last-child {
+            border-bottom: none;
+        }
+
+        &.ez-docs-api-header {
+            background: var(--ez-surface-primary, #f8fafc);
+            font-weight: 600;
+
+            .ez-docs-api-method,
+            .ez-docs-api-desc,
+            .ez-docs-type-name,
+            .ez-docs-type-coercion,
+            .ez-docs-type-example {
+                color: var(--ez-text-primary, #1e293b);
+                font-size: 13px;
+            }
+        }
+    }
+
+    .ez-docs-api-method {
+        flex: 0 0 320px;
+        padding: 12px 16px;
+        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+        font-size: 13px;
+        color: var(--ez-primary, #005871);
+        background: var(--ez-surface-primary, #f8fafc);
+        border-right: 1px solid var(--ez-border, #e2e8f0);
+    }
+
+    .ez-docs-api-desc {
+        flex: 1;
+        padding: 12px 16px;
+        font-size: 14px;
+        color: var(--ez-text-secondary, #475569);
+    }
+
+    .ez-docs-type-name {
+        flex: 0 0 80px;
+        padding: 12px 16px;
+        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+        font-size: 13px;
+        color: var(--ez-primary, #005871);
+        background: var(--ez-surface-primary, #f8fafc);
+        border-right: 1px solid var(--ez-border, #e2e8f0);
+    }
+
+    .ez-docs-type-coercion {
+        flex: 0 0 180px;
+        padding: 12px 16px;
+        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+        font-size: 12px;
+        color: var(--ez-text-secondary, #64748b);
+        border-right: 1px solid var(--ez-border, #e2e8f0);
+    }
+
+    .ez-docs-type-example {
+        flex: 1;
+        padding: 12px 16px;
+        font-size: 14px;
+        color: var(--ez-text-secondary, #475569);
+    }
+
+    .ez-docs-showcase-container {
+        flex: 1;
+        min-height: 0;
+        display: flex;
+        overflow: hidden;
+    }
+
+    .ez-docs-showcase-panel {
+        flex: 1;
+        min-width: 0;
+        padding: 24px;
+        overflow: auto;
+        background: var(--ez-surface-primary, #f8fafc);
+    }
+
+    .ez-docs-showcase-section {
+        margin-bottom: 24px;
+
+        &:last-child {
+            margin-bottom: 0;
+        }
+    }
+
+    .ez-docs-showcase-section-title {
+        font-size: 13px;
+        font-weight: 600;
+        color: var(--ez-text-secondary, #64748b);
+        text-transform: uppercase;
+        letter-spacing: 0.5px;
+        margin-bottom: 12px;
+    }
+
+    .ez-docs-showcase-variants {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 12px;
+
+        // Grids need full width
+        .ez-docs-variant-wrapper:has(.ez-grid) {
+            width: 100%;
+            align-items: stretch;
+        }
+    }
+
+    .ez-docs-variant-wrapper {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        gap: 8px;
+        padding: 16px;
+        background: var(--ez-surface-secondary, #ffffff);
+        border: 2px solid transparent;
+        border-radius: 8px;
+        cursor: pointer;
+        transition: all 0.15s ease;
+        min-width: 100px;
+        max-width: 100%;
+        overflow: hidden;
+
+        .ez-grid {
+            max-width: 100%;
+        }
+
+        &:hover {
+            border-color: var(--ez-border, #cbd5e1);
+            box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05);
+        }
+
+        &.selected {
+            border-color: var(--ez-primary, #005871);
+            background: var(--ez-primary-light, rgba(0, 88, 113, 0.08));
+        }
+    }
+
+    .ez-docs-variant-label {
+        font-size: 11px;
+        color: var(--ez-text-secondary, #64748b);
+        text-align: center;
+    }
+
+    .ez-docs-code-panel {
+        width: 400px;
+        min-width: 400px;
+        display: flex;
+        flex-direction: column;
+        background: #1e293b;
+        border-left: 1px solid #334155;
+    }
+
+    .ez-docs-code-panel-header {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        padding: 12px 16px;
+        background: #0f172a;
+        border-bottom: 1px solid #334155;
+        color: #94a3b8;
+        font-size: 13px;
+        font-weight: 500;
+
+        i {
+            font-size: 12px;
+        }
+
+        .ez-docs-copy-btn {
+            padding: 4px 8px;
+            color: #94a3b8;
+            background: transparent;
+            border: 1px solid #334155;
+            border-radius: 4px;
+            cursor: pointer;
+            transition: all 0.15s ease;
+
+            &:hover {
+                color: #e2e8f0;
+                background: #334155;
+            }
+        }
+    }
+
+    .ez-docs-code-panel-content {
+        flex: 1;
+        padding: 16px;
+        overflow: auto;
+
+        pre {
+            margin: 0;
+            font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+            font-size: 13px;
+            color: #e2e8f0;
+            line-height: 1.6;
+            white-space: pre-wrap;
+        }
+    }
+
+    .ez-docs-code-placeholder {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        height: 100%;
+        min-height: 200px;
+        color: var(--ez-text-secondary, #64748b);
+        font-size: 14px;
+        text-align: center;
+    }
+
+    .ez-docs-grid-section {
+        padding: 0;
+        overflow: hidden;
+
+        .ez-docs-section-title {
+            padding: 16px 24px;
+            margin-bottom: 0;
+            border-bottom: 1px solid var(--ez-border, #e2e8f0);
+        }
+
+        .ez-tab-panel {
+            border-radius: 0;
+        }
+
+        .ez-tab-panel__header {
+            background: var(--ez-surface-secondary, #ffffff);
+            padding-left: 16px;
+        }
+
+        .ez-tab-panel__pane {
+            background: var(--ez-surface-primary, #f8fafc);
+        }
+    }
+
+    .ez-docs-grid-preview {
+        background: var(--ez-surface-primary, #f8fafc);
+        min-height: 200px;
+    }
+}