@alliance-droid/svelte-docs-system 0.0.2 → 0.1.0

package/src/lib/themeCustomization.ts

@@ -1,212 +0,0 @@
-/**
- * Theme customization system
- * Generates CSS variables from theme configuration
- */
-
-import type { ThemeConfig } from './config';
-
-export interface CSSVariables {
-  [key: string]: string;
-}
-
-/**
- * Generate CSS custom properties (variables) from theme config
- * These can be injected into the document or stylesheet
- */
-export function generateCSSVariables(theme: ThemeConfig): CSSVariables {
-  const vars: CSSVariables = {};
-
-  // Color variables
-  if (theme.primary) vars['--color-primary'] = theme.primary;
-  if (theme.secondary) vars['--color-secondary'] = theme.secondary;
-  if (theme.textLight) vars['--color-text-light'] = theme.textLight;
-  if (theme.textDark) vars['--color-text-dark'] = theme.textDark;
-  if (theme.bgLight) vars['--color-bg-light'] = theme.bgLight;
-  if (theme.bgDark) vars['--color-bg-dark'] = theme.bgDark;
-  if (theme.sidebarBg) vars['--color-sidebar-bg'] = theme.sidebarBg;
-  if (theme.navbarBg) vars['--color-navbar-bg'] = theme.navbarBg;
-  if (theme.codeBg) vars['--color-code-bg'] = theme.codeBg;
-
-  // Font variables
-  if (theme.fontFamily) vars['--font-family-body'] = theme.fontFamily;
-  if (theme.headingFont) vars['--font-family-heading'] = theme.headingFont;
-
-  return vars;
-}
-
-/**
- * Apply CSS variables to the document root
- */
-export function applyCSSVariables(vars: CSSVariables): void {
-  if (typeof window === 'undefined') {
-    return; // Skip in SSR
-  }
-
-  const root = document.documentElement;
-  Object.entries(vars).forEach(([key, value]) => {
-    root.style.setProperty(key, value);
-  });
-}
-
-/**
- * Create a stylesheet string from CSS variables
- * Useful for injecting into <style> tags
- */
-export function createCSSVariablesStylesheet(vars: CSSVariables): string {
-  const entries = Object.entries(vars)
-    .map(([key, value]) => `  ${key}: ${value};`)
-    .join('\n');
-
-  return `:root {\n${entries}\n}`;
-}
-
-/**
- * Parse a color value and validate it
- */
-export function parseColor(color: string): { valid: boolean; value?: string; error?: string } {
-  if (!color || typeof color !== 'string') {
-    return { valid: false, error: 'Color must be a non-empty string' };
-  }
-
-  const trimmed = color.trim();
-
-  // Hex colors
-  if (/^#[0-9a-fA-F]{3}([0-9a-fA-F]{3})?([0-9a-fA-F]{2})?$/.test(trimmed)) {
-    return { valid: true, value: trimmed };
-  }
-
-  // RGB/RGBA
-  if (/^rgba?\s*\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}(\s*,\s*[\d.]+)?\s*\)$/.test(trimmed)) {
-    return { valid: true, value: trimmed };
-  }
-
-  // Named colors (basic list)
-  const namedColors = [
-    'red',
-    'blue',
-    'green',
-    'white',
-    'black',
-    'gray',
-    'grey',
-    'transparent',
-    'currentColor',
-  ];
-  if (namedColors.includes(trimmed.toLowerCase())) {
-    return { valid: true, value: trimmed };
-  }
-
-  // CSS custom property
-  if (/^var\s*\(\s*--[a-zA-Z0-9-]+\s*\)$/.test(trimmed)) {
-    return { valid: true, value: trimmed };
-  }
-
-  return { valid: false, error: `Invalid color format: ${color}` };
-}
-
-/**
- * Validate theme configuration
- */
-export function validateTheme(theme: ThemeConfig): { valid: boolean; errors: string[] } {
-  const errors: string[] = [];
-
-  if (!theme || typeof theme !== 'object') {
-    return { valid: false, errors: ['Theme must be an object'] };
-  }
-
-  // Validate colors
-  const colorFields = ['primary', 'secondary', 'textLight', 'textDark', 'bgLight', 'bgDark', 'sidebarBg', 'navbarBg', 'codeBg'] as const;
-  colorFields.forEach((field) => {
-    if (theme[field] !== undefined) {
-      const validation = parseColor(theme[field]!);
-      if (!validation.valid) {
-        errors.push(`${field}: ${validation.error}`);
-      }
-    }
-  });
-
-  // Validate fonts
-  if (theme.fontFamily !== undefined && typeof theme.fontFamily !== 'string') {
-    errors.push('fontFamily must be a string');
-  }
-
-  if (theme.headingFont !== undefined && typeof theme.headingFont !== 'string') {
-    errors.push('headingFont must be a string');
-  }
-
-  return { valid: errors.length === 0, errors };
-}
-
-/**
- * Merge theme configs, with priority to the first argument
- */
-export function mergeThemes(primary: ThemeConfig, secondary: ThemeConfig): ThemeConfig {
-  return {
-    ...secondary,
-    ...primary,
-  };
-}
-
-/**
- * Get a predefined theme template
- */
-export type ThemeTemplate = 'default' | 'dark' | 'minimal' | 'colorful';
-
-export function getThemeTemplate(template: ThemeTemplate = 'default'): ThemeConfig {
-  const templates: Record<ThemeTemplate, ThemeConfig> = {
-    default: {
-      primary: '#0066cc',
-      secondary: '#ff6b6b',
-      textLight: '#333333',
-      textDark: '#f0f0f0',
-      bgLight: '#ffffff',
-      bgDark: '#1a1a1a',
-      sidebarBg: '#f5f5f5',
-      navbarBg: '#ffffff',
-      codeBg: '#f4f4f4',
-      fontFamily: 'system-ui, -apple-system, sans-serif',
-      headingFont: 'system-ui, -apple-system, sans-serif',
-    },
-    dark: {
-      primary: '#4da6ff',
-      secondary: '#ff9999',
-      textLight: '#e0e0e0',
-      textDark: '#1a1a1a',
-      bgLight: '#1a1a1a',
-      bgDark: '#0d0d0d',
-      sidebarBg: '#262626',
-      navbarBg: '#1a1a1a',
-      codeBg: '#2d2d2d',
-      fontFamily: 'system-ui, -apple-system, sans-serif',
-      headingFont: 'system-ui, -apple-system, sans-serif',
-    },
-    minimal: {
-      primary: '#000000',
-      secondary: '#666666',
-      textLight: '#333333',
-      textDark: '#cccccc',
-      bgLight: '#ffffff',
-      bgDark: '#181818',
-      sidebarBg: '#fafafa',
-      navbarBg: '#ffffff',
-      codeBg: '#eeeeee',
-      fontFamily: 'Georgia, serif',
-      headingFont: 'Georgia, serif',
-    },
-    colorful: {
-      primary: '#ff006e',
-      secondary: '#00d9ff',
-      textLight: '#2d3142',
-      textDark: '#e0e0e0',
-      bgLight: '#fafafa',
-      bgDark: '#0d1b2a',
-      sidebarBg: '#f0f3ff',
-      navbarBg: '#ffffff',
-      codeBg: '#f5f5f5',
-      fontFamily: 'system-ui, -apple-system, sans-serif',
-      headingFont: '"Segoe UI", Tahoma, sans-serif',
-    },
-  };
-
-  return templates[template] || templates.default;
-}

package/src/lib/utils/highlight.test.ts

@@ -1,136 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { highlightSearchTerms, truncateText, extractExcerpt } from './highlight';
-
-describe('Highlight Utilities', () => {
-	describe('highlightSearchTerms', () => {
-		it('should highlight single search term', () => {
-			const text = 'This is a test sentence';
-			const result = highlightSearchTerms(text, 'test');
-			expect(result).toContain('<mark>test</mark>');
-		});
-
-		it('should highlight multiple occurrences', () => {
-			const text = 'test case with test words';
-			const result = highlightSearchTerms(text, 'test');
-			const matches = (result.match(/<mark>test<\/mark>/g) || []).length;
-			expect(matches).toBe(2);
-		});
-
-		it('should handle multiple search terms', () => {
-			const text = 'This is a test case';
-			const result = highlightSearchTerms(text, 'test case');
-			expect(result).toContain('<mark>test</mark>');
-			expect(result).toContain('<mark>case</mark>');
-		});
-
-		it('should be case insensitive', () => {
-			const text = 'TEST and Test and test';
-			const result = highlightSearchTerms(text, 'test');
-			const matches = (result.match(/<mark>/g) || []).length;
-			expect(matches).toBe(3);
-		});
-
-		it('should handle special regex characters', () => {
-			const text = 'This (test) has [special] {chars}';
-			const result = highlightSearchTerms(text, 'test');
-			expect(result).toContain('<mark>test</mark>');
-			expect(result).not.toThrow;
-		});
-
-		it('should return original text if search query is empty', () => {
-			const text = 'This is a test';
-			const result = highlightSearchTerms(text, '');
-			expect(result).toBe(text);
-		});
-
-		it('should return empty string if text is empty', () => {
-			const result = highlightSearchTerms('', 'test');
-			expect(result).toBe('');
-		});
-
-		it('should use word boundaries', () => {
-			const text = 'testing test';
-			const result = highlightSearchTerms(text, 'test');
-			// Should highlight 'test' in 'testing' as part of word, and 'test' as standalone
-			// Actually, \b word boundary means 'test' won't match in 'testing'
-			const matches = (result.match(/<mark>test<\/mark>/g) || []).length;
-			expect(matches).toBe(1); // Only the standalone 'test'
-		});
-	});
-
-	describe('truncateText', () => {
-		it('should not truncate short text', () => {
-			const text = 'Short text';
-			const result = truncateText(text, 50);
-			expect(result).toBe(text);
-		});
-
-		it('should truncate long text with ellipsis', () => {
-			const text = 'This is a very long text that should be truncated';
-			const result = truncateText(text, 20);
-			expect(result).toContain('...');
-			expect(result.length).toBeLessThan(text.length);
-		});
-
-		it('should truncate at word boundary if possible', () => {
-			const text = 'This is a test sentence for truncation';
-			const result = truncateText(text, 15);
-			expect(result.endsWith('...')).toBe(true);
-			// Result should have ellipsis and be shorter
-			expect(result.length).toBeLessThan(text.length);
-		});
-
-		it('should use default max length', () => {
-			const longText = 'a'.repeat(200);
-			const result = truncateText(longText);
-			expect(result).toContain('...');
-			expect(result.length).toBeLessThan(longText.length);
-		});
-	});
-
-	describe('extractExcerpt', () => {
-		it('should extract text around search term', () => {
-			const text = 'The quick brown fox jumps over the lazy dog';
-			const result = extractExcerpt(text, 'brown', 20);
-			expect(result).toContain('brown');
-		});
-
-		it('should return truncated text if no search query', () => {
-			const text = 'a'.repeat(300);
-			const result = extractExcerpt(text, '', 50);
-			expect(result).toContain('...');
-		});
-
-		it('should handle short excerpts', () => {
-			const text = 'The quick brown fox jumps';
-			const result = extractExcerpt(text, 'brown', 30);
-			expect(result).toContain('brown');
-		});
-
-		it('should handle longer text with excerpt', () => {
-			const text = 'The quick brown fox jumps over lazy dog';
-			const result = extractExcerpt(text, 'brown', 50);
-			expect(result).toContain('brown');
-		});
-
-		it('should handle search term at start', () => {
-			const text = 'brown fox jumps';
-			const result = extractExcerpt(text, 'brown', 50);
-			expect(result).toContain('brown');
-			expect(result.startsWith('...')).toBe(false);
-		});
-
-		it('should handle search term at end', () => {
-			const text = 'the quick brown';
-			const result = extractExcerpt(text, 'brown', 50);
-			expect(result).toContain('brown');
-			expect(result.endsWith('...')).toBe(false);
-		});
-
-		it('should be case insensitive', () => {
-			const text = 'The Brown fox';
-			const result = extractExcerpt(text, 'brown', 50);
-			expect(result.toLowerCase()).toContain('brown');
-		});
-	});
-});

package/src/lib/utils/highlight.ts

@@ -1,100 +0,0 @@
-/**
- * Highlight search terms in text
- * Returns HTML with highlighted terms wrapped in <mark> tags
- */
-export function highlightSearchTerms(text: string, searchQuery: string): string {
-	if (!text || !searchQuery.trim()) {
-		return text;
-	}
-
-	// Split search query into individual terms and escape special regex characters
-	const terms = searchQuery
-		.trim()
-		.split(/\s+/)
-		.filter((term) => term.length > 0)
-		.map((term) => term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
-
-	if (terms.length === 0) {
-		return text;
-	}
-
-	// Create a regex that matches any of the terms (case-insensitive)
-	const regex = new RegExp(`\\b(${terms.join('|')})\\b`, 'gi');
-
-	// Replace matches with highlighted version
-	return text.replace(regex, '<span class="search-highlight">$1</span>');
-}
-
-/**
- * Truncate text to a maximum length and ensure it ends at a word boundary
- */
-export function truncateText(text: string, maxLength: number = 150): string {
-	if (text.length <= maxLength) {
-		return text;
-	}
-
-	// Truncate and find the last space
-	const truncated = text.substring(0, maxLength);
-	const lastSpace = truncated.lastIndexOf(' ');
-
-	if (lastSpace > maxLength * 0.7) {
-		// If the last space is relatively close to the end, use it
-		return truncated.substring(0, lastSpace) + '...';
-	}
-
-	// Otherwise just truncate and add ellipsis
-	return truncated + '...';
-}
-
-/**
- * Extract excerpt around search terms
- */
-export function extractExcerpt(text: string, searchQuery: string, maxLength: number = 200): string {
-	if (!text || !searchQuery.trim()) {
-		return truncateText(text, maxLength);
-	}
-
-	const searchTerms = searchQuery
-		.trim()
-		.split(/\s+/)
-		.filter((term) => term.length > 0)
-		.map((term) => term.toLowerCase());
-
-	// Find the position of the first search term in the text
-	let earliestIndex = text.length;
-	for (const term of searchTerms) {
-		const index = text.toLowerCase().indexOf(term);
-		if (index !== -1 && index < earliestIndex) {
-			earliestIndex = index;
-		}
-	}
-
-	// Extract context around the search term
-	let startIndex = Math.max(0, earliestIndex - 50);
-	let endIndex = Math.min(text.length, startIndex + maxLength);
-
-	// Adjust if we're too close to the end
-	if (endIndex === text.length && startIndex > 0) {
-		startIndex = Math.max(0, endIndex - maxLength);
-	}
-
-	let excerpt = text.substring(startIndex, endIndex);
-
-	// Remove partial words at the beginning
-	if (startIndex > 0) {
-		const firstSpace = excerpt.indexOf(' ');
-		if (firstSpace !== -1 && firstSpace < 20) {
-			excerpt = excerpt.substring(firstSpace + 1);
-		}
-	}
-
-	// Add ellipsis if needed
-	if (startIndex > 0) {
-		excerpt = '...' + excerpt;
-	}
-	if (endIndex < text.length) {
-		excerpt = excerpt + '...';
-	}
-
-	return excerpt;
-}

package/src/lib/utils/index.ts

@@ -1,7 +0,0 @@
-export {
-	renderMarkdown,
-	extractMetadata,
-	getExcerpt,
-	type MarkdownMetadata,
-	type MarkdownResult
-} from './markdown';