;
diff --git a/packages/shared-help-types/src/search.ts b/packages/shared-help-types/src/search.ts
new file mode 100644
index 000000000..900d11235
--- /dev/null
+++ b/packages/shared-help-types/src/search.ts
@@ -0,0 +1,71 @@
+/**
+ * Search-related Type Definitions
+ */
+
+import type { FAQItem, FeatureItem, GettingStartedItem, ChangelogItem } from './content.js';
+
+// ============================================================================
+// Searchable Item Types
+// ============================================================================
+
+export type SearchableContentType = 'faq' | 'feature' | 'guide' | 'changelog';
+
+export interface SearchableItem {
+ id: string;
+ type: SearchableContentType;
+ title: string;
+ content: string;
+ tags?: string[];
+ question?: string;
+ description?: string;
+}
+
+// ============================================================================
+// Search Result Types
+// ============================================================================
+
+export interface SearchResult {
+ id: string;
+ type: SearchableContentType;
+ title: string;
+ excerpt: string;
+ score: number;
+ highlight?: string;
+ /** Original item reference */
+ item: FAQItem | FeatureItem | GettingStartedItem | ChangelogItem;
+}
+
+export interface SearchOptions {
+ /** Maximum number of results to return */
+ limit?: number;
+ /** Minimum score threshold (0-1, lower is more strict) */
+ threshold?: number;
+ /** Filter by content type */
+ types?: SearchableContentType[];
+ /** Filter by app ID (for app-specific content) */
+ appId?: string;
+}
+
+export interface SearchIndexConfig {
+ /** Weight for title/question field */
+ titleWeight?: number;
+ /** Weight for content field */
+ contentWeight?: number;
+ /** Weight for tags field */
+ tagsWeight?: number;
+ /** Fuzzy match threshold (0-1, lower is more strict) */
+ threshold?: number;
+ /** Minimum characters to start searching */
+ minMatchCharLength?: number;
+}
+
+// ============================================================================
+// Search State Types (for UI)
+// ============================================================================
+
+export interface SearchState {
+ query: string;
+ results: SearchResult[];
+ isSearching: boolean;
+ hasSearched: boolean;
+}
diff --git a/packages/shared-help-types/tsconfig.json b/packages/shared-help-types/tsconfig.json
new file mode 100644
index 000000000..1b9470b61
--- /dev/null
+++ b/packages/shared-help-types/tsconfig.json
@@ -0,0 +1,16 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "module": "ESNext",
+ "moduleResolution": "bundler",
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "forceConsistentCasingInFileNames": true,
+ "verbatimModuleSyntax": true,
+ "noEmit": true
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules"]
+}
diff --git a/packages/shared-help-ui/package.json b/packages/shared-help-ui/package.json
new file mode 100644
index 000000000..9828cd4e8
--- /dev/null
+++ b/packages/shared-help-ui/package.json
@@ -0,0 +1,65 @@
+{
+ "name": "@manacore/shared-help-ui",
+ "version": "1.0.0",
+ "private": true,
+ "type": "module",
+ "svelte": "./src/index.ts",
+ "main": "./src/index.ts",
+ "types": "./src/index.ts",
+ "exports": {
+ ".": {
+ "svelte": "./src/index.ts",
+ "types": "./src/index.ts",
+ "default": "./src/index.ts"
+ },
+ "./HelpPage.svelte": {
+ "svelte": "./src/pages/HelpPage.svelte",
+ "default": "./src/pages/HelpPage.svelte"
+ },
+ "./FAQSection.svelte": {
+ "svelte": "./src/components/FAQSection.svelte",
+ "default": "./src/components/FAQSection.svelte"
+ },
+ "./FeaturesOverview.svelte": {
+ "svelte": "./src/components/FeaturesOverview.svelte",
+ "default": "./src/components/FeaturesOverview.svelte"
+ },
+ "./KeyboardShortcuts.svelte": {
+ "svelte": "./src/components/KeyboardShortcuts.svelte",
+ "default": "./src/components/KeyboardShortcuts.svelte"
+ },
+ "./GettingStartedGuide.svelte": {
+ "svelte": "./src/components/GettingStartedGuide.svelte",
+ "default": "./src/components/GettingStartedGuide.svelte"
+ },
+ "./ChangelogSection.svelte": {
+ "svelte": "./src/components/ChangelogSection.svelte",
+ "default": "./src/components/ChangelogSection.svelte"
+ },
+ "./ContactSection.svelte": {
+ "svelte": "./src/components/ContactSection.svelte",
+ "default": "./src/components/ContactSection.svelte"
+ },
+ "./HelpSearch.svelte": {
+ "svelte": "./src/components/HelpSearch.svelte",
+ "default": "./src/components/HelpSearch.svelte"
+ }
+ },
+ "scripts": {
+ "check": "svelte-check --tsconfig ./tsconfig.json",
+ "lint": "eslint ."
+ },
+ "dependencies": {
+ "@manacore/shared-help-types": "workspace:*",
+ "@manacore/shared-help-content": "workspace:*",
+ "@manacore/shared-icons": "workspace:*"
+ },
+ "devDependencies": {
+ "svelte": "^5.0.0",
+ "svelte-check": "^4.0.0",
+ "typescript": "^5.7.3"
+ },
+ "peerDependencies": {
+ "svelte": "^5.0.0"
+ }
+}
diff --git a/packages/shared-help-ui/src/components/ChangelogEntry.svelte b/packages/shared-help-ui/src/components/ChangelogEntry.svelte
new file mode 100644
index 000000000..f9cfde552
--- /dev/null
+++ b/packages/shared-help-ui/src/components/ChangelogEntry.svelte
@@ -0,0 +1,152 @@
+
+
+
+
+
+ {#if expanded}
+
+ {#if item.summary}
+
{item.summary}
+ {/if}
+
+ {#if item.changes}
+ {#if item.changes.features && item.changes.features.length > 0}
+
+
+ New Features
+
+
+ {#each item.changes.features as change}
+ -
+ +
+
+ {change.title}
+ {#if change.description}
+ - {change.description}
+ {/if}
+
+
+ {/each}
+
+
+ {/if}
+
+ {#if item.changes.improvements && item.changes.improvements.length > 0}
+
+
+ Improvements
+
+
+ {#each item.changes.improvements as change}
+ -
+ ↑
+
+ {change.title}
+ {#if change.description}
+ - {change.description}
+ {/if}
+
+
+ {/each}
+
+
+ {/if}
+
+ {#if item.changes.bugfixes && item.changes.bugfixes.length > 0}
+
+
Bug Fixes
+
+ {#each item.changes.bugfixes as change}
+ -
+ ×
+
+ {change.title}
+ {#if change.description}
+ - {change.description}
+ {/if}
+
+
+ {/each}
+
+
+ {/if}
+ {/if}
+
+ {#if item.content}
+
+ {@html item.content}
+
+ {/if}
+
+ {/if}
+
+ {translations.changelog.noItems}
+
+{:else}
+
+ {#each displayedItems() as item (item.id)}
+
+ {/each}
+
+ {#if hasMore}
+
+
+
+ {/if}
+
+ {translations.contact.noInfo}
+
+{:else}
+
+
+ {@html contact.content}
+
+
+
+
+
+
+ {#if expanded}
+
+ {@html item.answer}
+
+ {/if}
+
+ {#if showCategories && items.length > 0}
+
+
+ {#each categories as category}
+ {@const hasItems = items.some((item) => item.category === category)}
+ {#if hasItems}
+
+ {/if}
+ {/each}
+
+ {/if}
+
+ {#if filteredItems().length === 0}
+
+ {translations.faq.noItems}
+
+ {:else}
+
+ {#each filteredItems() as item (item.id)}
+ toggleItem(item.id)}
+ />
+ {/each}
+
+ {/if}
+
+ {#if hasMore}
+
+
+
+ {/if}
+
+ {#if item.comingSoon}
+
+ {comingSoonLabel}
+
+ {/if}
+
+
+ {#if item.icon}
+ {item.icon}
+ {/if}
+
+ {item.title}
+
+
+
+
+ {item.description}
+
+
+ {#if item.highlights && item.highlights.length > 0}
+
+ {#each item.highlights as highlight}
+ -
+
+ {highlight}
+
+ {/each}
+
+ {/if}
+
+ {#if item.learnMoreUrl}
+
+ {learnMoreLabel} →
+
+ {/if}
+
+ {translations.features.noItems}
+
+{:else}
+
+ {#each Object.entries(groupedItems()) as [_category, categoryItems]}
+ {#if categoryItems.length > 0}
+
+ {#each categoryItems as item (item.id)}
+
+ {/each}
+
+ {/if}
+ {/each}
+
+ {translations.gettingStarted.noItems}
+
+{:else}
+
+
+
+ {#each items as item (item.id)}
+
+ {/each}
+
+
+
+
+ {#if selectedGuide()}
+ {@const guide = selectedGuide()}
+
+
+ {guide.title}
+
+
+ {guide.description}
+
+
+ {#if guide.steps && guide.steps.length > 0}
+
+ {#each guide.steps as step, index}
+
+
+ {index + 1}
+
+
+
+ {step.title}
+
+
+ {step.content}
+
+
+
+ {/each}
+
+ {:else}
+
+ {@html guide.content}
+
+ {/if}
+
+ {/if}
+
+
+
+
query.length >= 2 && (showResults = true)}
+ onblur={handleBlur}
+ placeholder={placeholder ?? translations.search.noResults}
+ class="w-full rounded-lg border border-gray-300 bg-white py-2.5 pl-10 pr-4 text-sm text-gray-900 placeholder-gray-500 transition-colors focus:border-primary-500 focus:outline-none focus:ring-1 focus:ring-primary-500 dark:border-gray-600 dark:bg-gray-800 dark:text-gray-100 dark:placeholder-gray-400"
+ />
+
+ {#if isSearching}
+
+ {:else}
+
+ {/if}
+
+
+
+ {#if showResults}
+
+ {#if results.length === 0}
+
+ {translations.search.noResults.replace('{query}', query)}
+
+ {:else}
+
+ {#each results as result, index (result.id)}
+ -
+
+
+ {/each}
+
+
+ {translations.search.resultsCount.replace('{count}', String(results.length))}
+
+ {/if}
+
+ {/if}
+
+ {translations.shortcuts.noItems}
+
+{:else}
+
+
+
+
+ | Shortcut |
+ Action |
+ Description |
+
+
+
+ {#each allShortcuts() as shortcut}
+
+ |
+
+ {shortcut.shortcut}
+
+ |
+
+ {shortcut.action}
+ |
+
+ {shortcut.description || '-'}
+ |
+
+ {/each}
+
+
+
+
+
+ {#if showBackButton}
+
+ {/if}
+
+
+ {translations.title}
+
+ {#if translations.subtitle}
+
+ {translations.subtitle} - {appName}
+
+ {/if}
+
+
+
+ {#if searchEnabled}
+
+
+
+ {/if}
+
+
+ {#if visibleSections.length > 1}
+
+
+
+ {/if}
+
+
+
+ {#if activeSection === 'faq' && showFAQ}
+
+ {:else if activeSection === 'features' && showFeatures}
+
+ {:else if activeSection === 'shortcuts' && showShortcuts}
+
+ {:else if activeSection === 'getting-started' && showGettingStarted}
+
+ {:else if activeSection === 'changelog' && showChangelog}
+
+ {:else if activeSection === 'contact' && showContact}
+
+ {/if}
+
+