valtech-components 2.0.544 → 2.0.545

package/lib/components/molecules/docs-breadcrumb/docs-breadcrumb.component.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from '@angular/core';
+import { Router } from '@angular/router';
+import { DocsBreadcrumbMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-docs-breadcrumb
+ *
+ * A breadcrumb navigation component for documentation.
+ *
+ * @example
+ * ```html
+ * <val-docs-breadcrumb
+ *   [props]="{
+ *     showHome: true,
+ *     items: [
+ *       { label: 'Components', route: ['/docs', 'components'] },
+ *       { label: 'Button' }
+ *     ]
+ *   }"
+ * ></val-docs-breadcrumb>
+ * ```
+ */
+export declare class DocsBreadcrumbComponent {
+    private router;
+    props: DocsBreadcrumbMetadata;
+    navigate: EventEmitter<string[]>;
+    constructor(router: Router);
+    onNavigate(route: string[]): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DocsBreadcrumbComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DocsBreadcrumbComponent, "val-docs-breadcrumb", never, { "props": { "alias": "props"; "required": false; }; }, { "navigate": "navigate"; }, never, never, true, never>;
+}

package/lib/components/molecules/docs-breadcrumb/types.d.ts

@@ -0,0 +1,18 @@
+export interface DocsBreadcrumbMetadata {
+    /** Breadcrumb items */
+    items: DocsBreadcrumbItem[];
+    /** Separator character */
+    separator?: string;
+    /** Show home icon at start */
+    showHome?: boolean;
+    /** Home route */
+    homeRoute?: string[];
+    /** Custom CSS class */
+    cssClass?: string;
+}
+export interface DocsBreadcrumbItem {
+    /** Display label */
+    label: string;
+    /** Route array for navigation (omit for current page) */
+    route?: string[];
+}

package/lib/components/molecules/docs-code-example/docs-code-example.component.d.ts

@@ -26,9 +26,11 @@ import * as i0 from "@angular/core";
 export declare class DocsCodeExampleComponent {
     props: DocsCodeExampleMetadata;
     previewTpl?: TemplateRef<any>;
+    private syntaxService;
     protected activeTab: import("@angular/core").WritableSignal<number>;
     protected copied: import("@angular/core").WritableSignal<boolean>;
     protected currentTab(): DocsCodeTab;
+    protected highlightedCode(): string;
     copyCode(): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DocsCodeExampleComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DocsCodeExampleComponent, "val-docs-code-example", never, { "props": { "alias": "props"; "required": false; }; }, {}, ["previewTpl"], never, true, never>;

package/lib/components/molecules/docs-search/docs-search.component.d.ts

@@ -0,0 +1,47 @@
+import { EventEmitter, ElementRef, OnDestroy } from '@angular/core';
+import { Router } from '@angular/router';
+import { DocsSearchMetadata, DocsSearchResult } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-docs-search
+ *
+ * A search component for documentation with keyboard navigation support.
+ * Supports Cmd+K / Ctrl+K shortcut to open.
+ *
+ * @example
+ * ```html
+ * <val-docs-search
+ *   [props]="{
+ *     placeholder: 'Search docs...',
+ *     sections: sidebarSections,
+ *     showShortcut: true
+ *   }"
+ *   (navigate)="onNavigate($event)"
+ * ></val-docs-search>
+ * ```
+ */
+export declare class DocsSearchComponent implements OnDestroy {
+    private router;
+    props: DocsSearchMetadata;
+    navigate: EventEmitter<string[]>;
+    search: EventEmitter<string>;
+    searchInputEl?: ElementRef<HTMLInputElement>;
+    protected searchQuery: import("@angular/core").WritableSignal<string>;
+    protected showResults: import("@angular/core").WritableSignal<boolean>;
+    protected selectedIndex: import("@angular/core").WritableSignal<number>;
+    private searchSubject;
+    private destroy$;
+    readonly isMac: boolean;
+    protected results: import("@angular/core").Signal<DocsSearchResult[]>;
+    constructor(router: Router);
+    ngOnDestroy(): void;
+    onGlobalKeydown(event: KeyboardEvent): void;
+    onQueryChange(query: string): void;
+    onFocus(): void;
+    onBlur(): void;
+    onInputKeydown(event: KeyboardEvent): void;
+    selectResult(result: DocsSearchResult): void;
+    clearSearch(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DocsSearchComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DocsSearchComponent, "val-docs-search", never, { "props": { "alias": "props"; "required": false; }; }, { "navigate": "navigate"; "search": "search"; }, never, never, true, never>;
+}

package/lib/components/molecules/docs-search/types.d.ts

@@ -0,0 +1,27 @@
+export interface DocsSearchMetadata {
+    /** Placeholder text for the search input */
+    placeholder?: string;
+    /** Sections to search through */
+    sections?: DocsSearchSection[];
+    /** Debounce time in milliseconds */
+    debounceMs?: number;
+    /** Show keyboard shortcut hint (Cmd+K / Ctrl+K) */
+    showShortcut?: boolean;
+    /** Custom CSS class */
+    cssClass?: string;
+}
+export interface DocsSearchSection {
+    title: string;
+    items: DocsSearchItem[];
+}
+export interface DocsSearchItem {
+    label: string;
+    route: string[];
+    description?: string;
+    keywords?: string[];
+}
+export interface DocsSearchResult {
+    section: string;
+    item: DocsSearchItem;
+    matchType: 'label' | 'description' | 'keyword';
+}

package/lib/components/organisms/article/article.component.d.ts

@@ -90,7 +90,7 @@ export declare class ArticleComponent implements OnInit {
         contentInterpolation?: Record<string, string | number>;
         icon?: import("valtech-components").IconMetada;
         shape?: "round";
-        size?: "default" | "small" | "large";
+        size?: "small" | "large" | "default";
         fill?: "default" | "clear" | "outline" | "solid";
         type: "button" | "submit" | "reset";
         token?: string;

package/lib/components/templates/docs-layout/docs-layout.component.d.ts

@@ -34,6 +34,7 @@ export declare class DocsLayoutComponent {
     protected isMobile: import("@angular/core").Signal<boolean>;
     protected isTablet: import("@angular/core").Signal<boolean>;
     onResize(): void;
+    onEscapeKey(): void;
     toggleSidebar(): void;
     closeSidebar(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DocsLayoutComponent, never>;

package/lib/services/syntax-highlight/index.d.ts

@@ -0,0 +1 @@
+export { SyntaxHighlightService } from './syntax-highlight.service';

package/lib/services/syntax-highlight/syntax-highlight.service.d.ts

@@ -0,0 +1,52 @@
+import 'prismjs/components/prism-typescript';
+import 'prismjs/components/prism-javascript';
+import 'prismjs/components/prism-css';
+import 'prismjs/components/prism-scss';
+import 'prismjs/components/prism-json';
+import 'prismjs/components/prism-bash';
+import 'prismjs/components/prism-markdown';
+import * as i0 from "@angular/core";
+/**
+ * SyntaxHighlightService
+ *
+ * Provides syntax highlighting using Prism.js.
+ * Supports common web development languages.
+ *
+ * @example
+ * ```typescript
+ * const highlighted = syntaxService.highlight(code, 'typescript');
+ * ```
+ */
+export declare class SyntaxHighlightService {
+    private loaded;
+    /**
+     * Check if Prism is loaded and ready
+     */
+    isLoaded(): boolean;
+    /**
+     * Highlight code string with the specified language
+     * @param code - The code string to highlight
+     * @param language - The language for syntax highlighting
+     * @returns HTML string with syntax highlighting classes
+     */
+    highlight(code: string, language: string): string;
+    /**
+     * Highlight all code elements in a container
+     * @param container - The container element or selector
+     */
+    highlightAllIn(container: HTMLElement | string): void;
+    /**
+     * Get list of supported languages
+     */
+    getSupportedLanguages(): string[];
+    /**
+     * Normalize language aliases
+     */
+    private normalizeLanguage;
+    /**
+     * Escape HTML special characters for safe display
+     */
+    private escapeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SyntaxHighlightService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SyntaxHighlightService>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.544",
+  "version": "2.0.545",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -241,6 +241,11 @@ export * from './lib/components/molecules/docs-api-table/docs-api-table.componen
 export * from './lib/components/molecules/docs-api-table/types';
 export * from './lib/components/molecules/docs-code-example/docs-code-example.component';
 export * from './lib/components/molecules/docs-code-example/types';
+export * from './lib/components/molecules/docs-search/docs-search.component';
+export * from './lib/components/molecules/docs-search/types';
+export * from './lib/components/molecules/docs-breadcrumb/docs-breadcrumb.component';
+export * from './lib/components/molecules/docs-breadcrumb/types';
+export * from './lib/services/syntax-highlight';
 export * from './lib/components/types';
 export * from './lib/shared/pipes/process-links.pipe';
 export * from './lib/shared/utils/dom';