@flxgde/gigamenu 0.0.1 → 0.0.2

package/src/lib/gigamenu.component.ts

@@ -1,305 +0,0 @@
-import {
-  Component,
-  signal,
-  computed,
-  effect,
-  ElementRef,
-  viewChild,
-  contentChild,
-  HostListener,
-  PLATFORM_ID,
-  Inject,
-  TemplateRef,
-} from '@angular/core';
-import { isPlatformBrowser, NgTemplateOutlet } from '@angular/common';
-import { GigamenuService } from './gigamenu.service';
-import { FrecencyService } from './frecency.service';
-import { GigamenuItem } from './types';
-import {
-  GigamenuItemTemplate,
-  GigamenuEmptyTemplate,
-  GigamenuHeaderTemplate,
-  GigamenuFooterTemplate,
-  GigamenuPanelTemplate,
-  GigamenuItemContext,
-  GigamenuEmptyContext,
-  GigamenuHeaderContext,
-  GigamenuFooterContext,
-  GigamenuPanelContext,
-} from './gigamenu-templates.directive';
-
-@Component({
-  selector: 'gm-gigamenu',
-  standalone: true,
-  imports: [NgTemplateOutlet],
-  templateUrl: 'gigamenu.component.html',
-  styles: `
-    :host {
-      display: contents;
-    }
-  `,
-})
-export class GigamenuComponent {
-  private readonly searchInput = viewChild<ElementRef<HTMLInputElement>>('searchInput');
-  private readonly listContainer = viewChild<ElementRef<HTMLDivElement>>('listContainer');
-  private readonly isBrowser: boolean;
-
-  // Template queries
-  protected readonly itemTemplate = contentChild(GigamenuItemTemplate);
-  protected readonly emptyTemplate = contentChild(GigamenuEmptyTemplate);
-  protected readonly headerTemplate = contentChild(GigamenuHeaderTemplate);
-  protected readonly footerTemplate = contentChild(GigamenuFooterTemplate);
-  protected readonly panelTemplate = contentChild(GigamenuPanelTemplate);
-
-  protected readonly query = signal('');
-  protected readonly selectedIndex = signal(0);
-
-  /** Parsed search term (before first separator) */
-  protected readonly searchTerm = computed(() => {
-    const q = this.query();
-    const separator = this.service.config().argSeparator ?? ' ';
-    const sepIndex = q.indexOf(separator);
-    if (sepIndex === -1) return q;
-    return q.substring(0, sepIndex);
-  });
-
-  /** Parsed arguments (after first separator) */
-  protected readonly args = computed(() => {
-    const q = this.query();
-    const separator = this.service.config().argSeparator ?? ' ';
-    const sepIndex = q.indexOf(separator);
-    if (sepIndex === -1) return '';
-    return q.substring(sepIndex + separator.length);
-  });
-
-  protected readonly filteredItems = computed(() => {
-    const searchTerm = this.searchTerm().toLowerCase().trim();
-    const items = this.service.items();
-    const maxResults = this.service.config().maxResults ?? 10;
-
-    if (!searchTerm) {
-      // No query: sort by frecency scores from empty searches
-      const scores = this.frecency.getScores('');
-      return this.sortByFrecency(items, scores).slice(0, maxResults);
-    }
-
-    // Filter matching items using only search term (not args)
-    const matched = items.filter((item) => this.matchesQuery(item, searchTerm));
-
-    // Sort by frecency for this search term
-    const scores = this.frecency.getScores(searchTerm);
-    return this.sortByFrecency(matched, scores).slice(0, maxResults);
-  });
-
-  constructor(
-    protected readonly service: GigamenuService,
-    private readonly frecency: FrecencyService,
-    @Inject(PLATFORM_ID) platformId: object
-  ) {
-    this.isBrowser = isPlatformBrowser(platformId);
-
-    effect(() => {
-      if (this.service.isOpen() && this.isBrowser) {
-        setTimeout(() => this.searchInput()?.nativeElement.focus(), 0);
-      }
-    });
-
-    effect(() => {
-      const items = this.filteredItems();
-      const searchTerm = this.searchTerm();
-
-      // Check for auto-select based on frecency
-      if (searchTerm && items.length > 0) {
-        const topMatch = this.frecency.getTopMatch(searchTerm);
-        if (topMatch) {
-          const idx = items.findIndex((item) => item.id === topMatch);
-          if (idx !== -1) {
-            this.selectedIndex.set(idx);
-            return;
-          }
-        }
-      }
-
-      this.selectedIndex.set(0);
-    });
-  }
-
-  @HostListener('document:keydown', ['$event'])
-  onGlobalKeydown(event: KeyboardEvent): void {
-    if (!this.isBrowser) return;
-
-    if ((event.metaKey || event.ctrlKey) && event.key === 'k') {
-      event.preventDefault();
-      this.service.toggle();
-      return;
-    }
-
-    if (event.key === '/' && !this.isInputFocused()) {
-      event.preventDefault();
-      this.service.open();
-      return;
-    }
-
-    if (event.key === 'Escape' && this.service.isOpen()) {
-      event.preventDefault();
-      this.close();
-    }
-  }
-
-  protected onInputKeydown(event: KeyboardEvent): void {
-    const items = this.filteredItems();
-
-    switch (event.key) {
-      case 'ArrowDown':
-        event.preventDefault();
-        this.selectedIndex.update((i) => Math.min(i + 1, items.length - 1));
-        this.scrollSelectedIntoView();
-        break;
-
-      case 'ArrowUp':
-        event.preventDefault();
-        this.selectedIndex.update((i) => Math.max(i - 1, 0));
-        this.scrollSelectedIntoView();
-        break;
-
-      case 'Enter':
-        event.preventDefault();
-        const selected = items[this.selectedIndex()];
-        if (selected) {
-          this.executeItem(selected);
-        }
-        break;
-
-      case 'Escape':
-        event.preventDefault();
-        this.close();
-        break;
-    }
-  }
-
-  private scrollSelectedIntoView(): void {
-    const container = this.listContainer()?.nativeElement;
-    if (!container) return;
-
-    const selectedButton = container.querySelector(
-      `[data-index="${this.selectedIndex()}"]`
-    ) as HTMLElement | null;
-
-    if (selectedButton) {
-      selectedButton.scrollIntoView({ block: 'nearest' });
-    }
-  }
-
-  protected onQueryChange(event: Event): void {
-    const value = (event.target as HTMLInputElement).value;
-    this.query.set(value);
-  }
-
-  protected onBackdropClick(event: MouseEvent): void {
-    if (event.target === event.currentTarget) {
-      this.close();
-    }
-  }
-
-  protected executeItem(item: GigamenuItem): void {
-    // Record the selection for frecency learning (use search term, not full query)
-    const searchTerm = this.searchTerm();
-    this.frecency.recordSelection(searchTerm, item.id);
-
-    // Get args before closing (which resets query)
-    const args = this.args() || undefined;
-
-    this.close();
-    item.action(args);
-  }
-
-  // Template context getters
-  protected getItemContext(item: GigamenuItem, index: number): GigamenuItemContext {
-    return {
-      $implicit: item,
-      index,
-      selected: this.selectedIndex() === index,
-    };
-  }
-
-  protected getEmptyContext(): GigamenuEmptyContext {
-    return {
-      $implicit: this.query(),
-    };
-  }
-
-  protected getHeaderContext(): GigamenuHeaderContext {
-    return {
-      $implicit: this.query(),
-      searchTerm: this.searchTerm(),
-      args: this.args(),
-      onQueryChange: (value: string) => this.query.set(value),
-      onKeydown: (event: KeyboardEvent) => this.onInputKeydown(event),
-      placeholder: this.service.config().placeholder ?? '',
-    };
-  }
-
-  protected getFooterContext(): GigamenuFooterContext {
-    return {
-      $implicit: this.filteredItems().length,
-      total: this.service.items().length,
-    };
-  }
-
-  protected getPanelContext(): GigamenuPanelContext {
-    return {
-      $implicit: this.filteredItems(),
-      query: this.query(),
-      searchTerm: this.searchTerm(),
-      args: this.args(),
-      selectedIndex: this.selectedIndex(),
-      executeItem: (item: GigamenuItem) => this.executeItem(item),
-      setSelectedIndex: (index: number) => this.selectedIndex.set(index),
-      setQuery: (query: string) => this.query.set(query),
-      close: () => this.close(),
-      placeholder: this.service.config().placeholder ?? '',
-    };
-  }
-
-  private close(): void {
-    this.service.close();
-    this.query.set('');
-    this.selectedIndex.set(0);
-  }
-
-  private sortByFrecency(items: GigamenuItem[], scores: Map<string, number>): GigamenuItem[] {
-    if (scores.size === 0) return items;
-
-    return [...items].sort((a, b) => {
-      const scoreA = scores.get(a.id) ?? 0;
-      const scoreB = scores.get(b.id) ?? 0;
-      return scoreB - scoreA;
-    });
-  }
-
-  private matchesQuery(item: GigamenuItem, query: string): boolean {
-    const searchableText = [
-      item.label,
-      item.description,
-      ...(item.keywords ?? []),
-    ]
-      .filter(Boolean)
-      .join(' ')
-      .toLowerCase();
-
-    const words = query.split(/\s+/);
-    return words.every((word) => searchableText.includes(word));
-  }
-
-  private isInputFocused(): boolean {
-    const activeElement = document.activeElement;
-    if (!activeElement) return false;
-
-    const tagName = activeElement.tagName.toLowerCase();
-    return (
-      tagName === 'input' ||
-      tagName === 'textarea' ||
-      (activeElement as HTMLElement).isContentEditable
-    );
-  }
-}

package/src/lib/gigamenu.service.ts

@@ -1,143 +0,0 @@
-import { Injectable, signal, computed } from '@angular/core';
-import { Router, Route, Routes } from '@angular/router';
-import {
-  GigamenuItem,
-  GigamenuCommand,
-  GigamenuPage,
-  GigamenuConfig,
-  DEFAULT_CONFIG,
-  DiscoverRoutesOptions,
-  RouteInfo,
-} from './types';
-
-@Injectable({ providedIn: 'root' })
-export class GigamenuService {
-  private readonly _items = signal<Map<string, GigamenuItem>>(new Map());
-  private readonly _isOpen = signal(false);
-  private readonly _config = signal<GigamenuConfig>(DEFAULT_CONFIG);
-
-  readonly items = computed(() => Array.from(this._items().values()));
-  readonly isOpen = this._isOpen.asReadonly();
-  readonly config = this._config.asReadonly();
-
-  constructor(private readonly router: Router) {}
-
-  configure(config: Partial<GigamenuConfig>): void {
-    this._config.update((current) => ({ ...current, ...config }));
-  }
-
-  open(): void {
-    this._isOpen.set(true);
-  }
-
-  close(): void {
-    this._isOpen.set(false);
-  }
-
-  toggle(): void {
-    this._isOpen.update((v) => !v);
-  }
-
-  registerItem(item: GigamenuItem): void {
-    this._items.update((items) => {
-      const newItems = new Map(items);
-      newItems.set(item.id, item);
-      return newItems;
-    });
-  }
-
-  unregisterItem(id: string): void {
-    this._items.update((items) => {
-      const newItems = new Map(items);
-      newItems.delete(id);
-      return newItems;
-    });
-  }
-
-  registerCommand(command: GigamenuCommand): void {
-    this.registerItem({
-      ...command,
-      category: 'command',
-    });
-  }
-
-  registerPage(page: GigamenuPage): void {
-    this.registerItem({
-      ...page,
-      category: 'page',
-      action: () => this.router.navigate([page.path]),
-    });
-  }
-
-  discoverRoutes(options?: DiscoverRoutesOptions): void;
-  discoverRoutes(routes?: Routes, options?: DiscoverRoutesOptions): void;
-  discoverRoutes(
-    routesOrOptions?: Routes | DiscoverRoutesOptions,
-    maybeOptions?: DiscoverRoutesOptions
-  ): void {
-    let routes: Routes;
-    let options: DiscoverRoutesOptions | undefined;
-
-    if (Array.isArray(routesOrOptions)) {
-      routes = routesOrOptions;
-      options = maybeOptions;
-    } else {
-      routes = this.router.config;
-      options = routesOrOptions;
-    }
-
-    this.extractPagesFromRoutes(routes, '', options?.filter);
-  }
-
-  private extractPagesFromRoutes(
-    routes: Routes,
-    parentPath: string,
-    filter?: (route: RouteInfo) => boolean
-  ): void {
-    for (const route of routes) {
-      if (route.redirectTo !== undefined) continue;
-
-      const fullPath = parentPath
-        ? `${parentPath}/${route.path ?? ''}`
-        : route.path ?? '';
-
-      if (route.path !== undefined && route.path !== '**') {
-        const routeInfo: RouteInfo = {
-          path: route.path,
-          fullPath: `/${fullPath}`,
-          data: route.data as Record<string, unknown> | undefined,
-          title: typeof route.title === 'string' ? route.title : undefined,
-        };
-
-        // Apply filter if provided
-        if (filter && !filter(routeInfo)) {
-          // Still process children even if this route is filtered
-          if (route.children) {
-            this.extractPagesFromRoutes(route.children, fullPath, filter);
-          }
-          continue;
-        }
-
-        const label = routeInfo.title || this.pathToLabel(route.path || 'Home');
-        this.registerPage({
-          id: `page:${fullPath || '/'}`,
-          label,
-          path: `/${fullPath}`,
-          description: `Navigate to ${label}`,
-        });
-      }
-
-      if (route.children) {
-        this.extractPagesFromRoutes(route.children, fullPath, filter);
-      }
-    }
-  }
-
-  private pathToLabel(path: string): string {
-    return path
-      .split('/')
-      .pop()!
-      .replace(/[-_]/g, ' ')
-      .replace(/\b\w/g, (c) => c.toUpperCase());
-  }
-}

package/src/lib/types.ts

@@ -1,101 +0,0 @@
-export type GigamenuItemCategory = 'page' | 'command';
-
-export interface GigamenuItem {
-  id: string;
-  label: string;
-  description?: string;
-  /** Emoji or text icon */
-  icon?: string;
-  /** CSS class for icon libraries (e.g., 'pi pi-home', 'fa fa-home') */
-  iconClass?: string;
-  keywords?: string[];
-  category: GigamenuItemCategory;
-  /** Action to execute. Receives args string if user typed text after the separator. */
-  action: (args?: string) => void;
-}
-
-export interface GigamenuPage extends Omit<GigamenuItem, 'category' | 'action'> {
-  path: string;
-}
-
-export interface GigamenuCommand extends Omit<GigamenuItem, 'category'> {
-  shortcut?: string;
-}
-
-export interface GigamenuConfig {
-  placeholder?: string;
-  maxResults?: number;
-  autoDiscoverRoutes?: boolean;
-  /** Separator between search query and arguments (default: ' ') */
-  argSeparator?: string;
-}
-
-export const DEFAULT_CONFIG: GigamenuConfig = {
-  placeholder: 'Search pages and commands...',
-  maxResults: 10,
-  autoDiscoverRoutes: true,
-  argSeparator: ' ',
-};
-
-/**
- * Base interface for defining a command in a separate file.
- * Each command file should export a constant implementing this interface.
- */
-export interface CommandDefinition {
-  readonly id: string;
-  readonly label: string;
-  readonly description?: string;
-  readonly icon?: string;
-  readonly iconClass?: string;
-  readonly keywords?: string[];
-  readonly shortcut?: string;
-  execute(): void;
-}
-
-/**
- * Helper function to define a command with type safety.
- */
-export function defineCommand(command: CommandDefinition): CommandDefinition {
-  return command;
-}
-
-/**
- * Information about a route passed to the filter function.
- */
-export interface RouteInfo {
-  path: string;
-  fullPath: string;
-  data?: Record<string, unknown>;
-  title?: string;
-}
-
-/**
- * Filter function to include/exclude routes from discovery.
- * Return true to include the route, false to exclude it.
- */
-export type RouteFilter = (route: RouteInfo) => boolean;
-
-/**
- * Mapped page data returned from the map function.
- */
-export interface MappedPage {
-  label?: string;
-  description?: string;
-  icon?: string;
-  iconClass?: string;
-  keywords?: string[];
-}
-
-/**
- * Map function to customize page data for discovered routes.
- * Return partial page data to override defaults, or null to skip the route.
- */
-export type RouteMapper = (route: RouteInfo) => MappedPage | null;
-
-/**
- * Options for route discovery.
- */
-export interface DiscoverRoutesOptions {
-  filter?: RouteFilter;
-  map?: RouteMapper;
-}

package/src/public-api.ts

@@ -1,6 +0,0 @@
-export * from './lib/types';
-export { defineCommand } from './lib/types';
-export * from './lib/gigamenu.service';
-export * from './lib/gigamenu.component';
-export * from './lib/frecency.service';
-export * from './lib/gigamenu-templates.directive';

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022", "DOM"],
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "experimentalDecorators": true,
-    "useDefineForClassFields": false
-  }
-}

package/tsconfig.lib.json

@@ -1,12 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "out-tsc/lib",
-    "declaration": true,
-    "declarationMap": true,
-    "inlineSources": true,
-    "baseUrl": "."
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["**/*.spec.ts"]
-}

package/tsconfig.lib.prod.json

@@ -1,6 +0,0 @@
-{
-  "extends": "./tsconfig.lib.json",
-  "compilerOptions": {
-    "declarationMap": false
-  }
-}