jamdesk 1.1.143 → 1.1.144

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.143",
+  "version": "1.1.144",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/components/navigation/Header.tsx

@@ -6,7 +6,7 @@ import Link from 'next/link';
 import { usePathname } from 'next/navigation';
 // Icons use Font Awesome CSS classes for lightweight rendering
 import type { DocsConfig, TabsPosition } from '@/lib/docs-types';
-import { normalizeLogo, getIconName } from '@/lib/docs-types';
+import { normalizeLogo, getIconString } from '@/lib/docs-types';
 import type { LayoutVariant } from '@/themes';
 import { getTheme } from '@/themes';
 import { ThemeToggle } from '@/components/theme/ThemeToggle';
@@ -136,7 +136,7 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
     if (!hasTabs) return [];
 
     return navigationTabs.map((tab) => {
-      const iconName = getIconName(tab.icon);
+      const iconName = getIconString(tab.icon);
 
       // For external tabs, use the href directly
       if (tab.href && !tab.groups && !tab.pages) {
@@ -489,7 +489,7 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
                       rel={isExternal ? 'noopener noreferrer' : undefined}
                       className="flex items-center gap-1.5 px-2.5 py-1.5 text-sm text-[var(--color-text-tertiary)] hover:text-[var(--color-text-primary)] transition-colors"
                     >
-                      {link.icon && <i className={`${getIconClass(getIconName(link.icon))} text-[14px]`} aria-hidden="true" />}
+                      {link.icon && <i className={`${getIconClass(getIconString(link.icon))} text-[14px]`} aria-hidden="true" />}
                       <span>{resolveLabel(link.label, link.labels)}</span>
                       {isExternal && <i className="fa-solid fa-arrow-up-right-from-square text-[10px] opacity-50" aria-hidden="true" />}
                     </a>
@@ -564,6 +564,7 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
           isOpen={isSearchOpen}
           onClose={() => setIsSearchOpen(false)}
           popularPages={config.search?.popularPages}
+          placeholder={config.search?.prompt}
         />
       )}
       {searchDevNotice}

package/vendored/components/search/SearchModal.tsx

@@ -12,11 +12,13 @@ import { useProjectSlug } from '@/lib/project-slug-context';
 import type { SearchResult, SearchGroup } from '@/lib/search-client';
 import { useChatPanelOptional } from '@/hooks/useChatPanel';
 import { modifierKeyLabel } from '@/lib/platform-keys';
+import { getIconString, type IconConfig } from '@/lib/docs-types';
+import { getIconClass } from '@/lib/icon-utils';
 
 interface PopularPage {
   title: string;
   slug: string;
-  icon?: string;
+  icon?: IconConfig;
 }
 
 interface SearchModalProps {
@@ -24,10 +26,14 @@ interface SearchModalProps {
   onClose: () => void;
   popularPages?: PopularPage[];
   onNavigate?: (url: string) => void;
+  /** Custom placeholder for the search input (docs.json `search.prompt`) */
+  placeholder?: string;
 }
 
 const DEBOUNCE_MS = 150;
 
+const DEFAULT_SEARCH_PLACEHOLDER = 'Search documentation…';
+
 // Default popular pages fallback
 const DEFAULT_POPULAR_PAGES: PopularPage[] = [
   { title: 'Quick Start', slug: 'quickstart', icon: 'rocket' },
@@ -135,7 +141,7 @@ function countVisibleResults(rows: SearchRow[]): number {
   return rows.reduce((n, r) => (r.kind === 'expander' ? n : n + 1), 0);
 }
 
-export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: SearchModalProps) {
+export function SearchModal({ isOpen, onClose, popularPages, onNavigate, placeholder }: SearchModalProps) {
   const linkPrefix = useLinkPrefix();
   const projectSlug = useProjectSlug();
   const chatPanel = useChatPanelOptional();
@@ -522,7 +528,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
             <input
               ref={inputRef}
               type="search"
-              placeholder="Search documentation…"
+              placeholder={placeholder || DEFAULT_SEARCH_PLACEHOLDER}
               value={query}
               onChange={(e) => setQuery(e.target.value)}
               className="flex-1 bg-transparent text-[var(--color-text-primary)] placeholder-[var(--color-text-muted)] outline-none text-base [&::-webkit-search-cancel-button]:appearance-none [&::-webkit-search-decoration]:appearance-none"
@@ -703,7 +709,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
                               : 'hover:bg-[var(--color-bg-secondary)]'
                           }`}
                         >
-                          <i className={`fa-light fa-${page.icon || 'file-lines'} text-sm text-[var(--color-text-muted)]`} aria-hidden="true" />
+                          <i className={`${getIconClass(getIconString(page.icon))} text-sm text-[var(--color-text-muted)]`} aria-hidden="true" />
                           <span className="text-sm text-[var(--color-text-primary)] truncate">{page.title}</span>
                         </button>
                       ))}

package/vendored/lib/docs-types.ts

@@ -685,7 +685,7 @@ export interface SearchConfig {
   popularPages?: Array<{
     title: string;
     slug: string;
-    icon?: string;
+    icon?: IconConfig;
   }>;
 }
 
@@ -960,7 +960,7 @@ export function normalizeNavPage(page: NavigationPage): {
       .pop()
       ?.replace(/-/g, ' ')
       .replace(/\b\w/g, (l) => l.toUpperCase()) || page.page,
-    icon: getIconName(page.icon),
+    icon: getIconString(page.icon),
     tag: page.tag,
   };
 }
@@ -1024,6 +1024,19 @@ export function getIconName(icon: IconConfig | undefined): string | undefined {
   return icon.name;
 }
 
+/**
+ * Flatten an icon config to the string getIconClass() understands, preserving
+ * the Font Awesome style as a "style/name" prefix (every IconStyle value is a
+ * getIconClass style prefix). Use this — not getIconName — wherever an icon is
+ * rendered, so a configured `style` survives the flatten. `library` is
+ * intentionally dropped: all icons render via Font Awesome.
+ */
+export function getIconString(icon: IconConfig | undefined): string | undefined {
+  if (!icon) return undefined;
+  if (typeof icon === 'string') return icon;
+  return icon.style ? `${icon.style}/${icon.name}` : icon.name;
+}
+
 /**
  * Get icon library from config
  */

package/vendored/lib/navigation-resolver.ts

@@ -18,7 +18,7 @@ import type {
   ExternalAnchorConfig,
 } from './docs-types';
 
-import { normalizeNavPage, getIconName } from './docs-types';
+import { normalizeNavPage, getIconString } from './docs-types';
 import { getLanguageDisplayInfo, extractLanguageFromPath } from './language-utils';
 import { evictOldest } from './cache-utils';
 
@@ -225,7 +225,7 @@ function resolveGroup(group: GroupConfig): ResolvedGroup {
 
   return {
     name: group.group,
-    icon: getIconName(group.icon),
+    icon: getIconString(group.icon),
     tag: group.tag,
     pages: resolvedPages,
     expanded: group.expanded,
@@ -268,7 +268,7 @@ function resolveTabGroups(tab: TabConfig): ResolvedGroup[] {
 function resolveTab(tab: TabConfig): ResolvedTab {
   return {
     name: tab.tab,
-    icon: getIconName(tab.icon),
+    icon: getIconString(tab.icon),
     href: tab.href,
     isExternal: !!tab.href && !tab.groups && !tab.pages,
   };
@@ -465,7 +465,7 @@ export function resolveNavigation(
       .map((anchor: ExternalAnchorConfig) => ({
         name: anchor.name,
         href: anchor.href,
-        icon: getIconName(anchor.icon),
+        icon: getIconString(anchor.icon),
       }));
   }
 
@@ -476,7 +476,7 @@ export function resolveNavigation(
       result.externalAnchors.push({
         name: anchor.anchor,
         href: anchor.href,
-        icon: getIconName(anchor.icon),
+        icon: getIconString(anchor.icon),
       });
     }
   }

package/vendored/schema/docs-schema.json

@@ -555,7 +555,7 @@
                                     "slug": {
                                         "type": "string",
                                         "minLength": 1,
-                                        "description": "Page path (without .mdx extension)"
+                                        "description": "Page path, without a leading slash or file extension. A leading slash makes a broken // URL. Nested pages use the folder path: e.g. 'quickstart', or 'guides/authentication' for the file guides/authentication.mdx."
                                     },
                                     "icon": {
                                         "$ref": "#/definitions/iconSchema",