@hyperfixi/vite-plugin 2.0.0 → 2.2.0

package/dist/index.d.cts

@@ -75,6 +75,22 @@ interface HyperfixiPluginOptions {
      * Enable verbose logging during development.
      */
     debug?: boolean;
+    /**
+     * Enable server-bridge route generation alongside bundle generation.
+     * Requires `@hyperfixi/server-bridge` to be installed as a peer dependency.
+     * If not installed, a warning is logged and the feature is silently skipped.
+     *
+     * @example
+     * ```typescript
+     * hyperfixi({
+     *   serverBridge: {
+     *     framework: 'express',
+     *     output: './server/routes',
+     *   }
+     * })
+     * ```
+     */
+    serverBridge?: ServerBridgeOptions;
     /**
      * Enable semantic parsing for multilingual support.
      * - false: No semantic parsing (default, current behavior)
@@ -109,6 +125,26 @@ interface HyperfixiPluginOptions {
      * Useful for dynamic content not detectable at build time.
      */
     extraLanguages?: string[];
+    /**
+     * Register additional domains for scanning.
+     * Each domain declares its attribute patterns and keywords for detection.
+     * Runs alongside the default hyperscript scanner.
+     *
+     * @example
+     * ```typescript
+     * hyperfixi({
+     *   domains: [
+     *     {
+     *       domain: 'sql',
+     *       attributes: ['data-sql'],
+     *       scriptTypes: ['text/sql-dsl'],
+     *       keywords: { en: ['select', 'insert', 'update', 'delete'] },
+     *     },
+     *   ],
+     * })
+     * ```
+     */
+    domains?: DomainScanRule[];
     /**
      * Custom language keyword definitions.
      * Use this to add new languages or extend/override existing keyword detection.
@@ -206,6 +242,142 @@ interface AggregatedUsage {
     /** Map of file paths to their usage */
     fileUsage: Map<string, FileUsage>;
 }
+/**
+ * Configuration for a domain's scanning rules in the Vite plugin.
+ */
+interface DomainScanRule {
+    /** Domain name */
+    readonly domain: string;
+    /** Attribute names to scan for (e.g., ['data-sql', '_sql']) */
+    readonly attributes: readonly string[];
+    /** Script tag types to scan for (e.g., ['text/sql-dsl']) */
+    readonly scriptTypes?: readonly string[];
+    /** Keywords for command detection, keyed by language code */
+    readonly keywords?: Readonly<Record<string, readonly string[]>>;
+}
+/**
+ * Per-domain usage detected in a single file.
+ */
+interface DomainFileUsage {
+    /** Domain name */
+    readonly domain: string;
+    /** Detected keywords/commands */
+    readonly detectedKeywords: Set<string>;
+    /** Languages detected */
+    readonly detectedLanguages: Set<string>;
+    /** Number of snippets found */
+    readonly snippetCount: number;
+}
+/**
+ * Aggregated usage across all files for a single domain.
+ */
+interface DomainAggregatedUsage {
+    /** Domain name */
+    readonly domain: string;
+    /** All detected keywords across files */
+    readonly detectedKeywords: Set<string>;
+    /** All detected languages across files */
+    readonly detectedLanguages: Set<string>;
+    /** Number of files with this domain's usage */
+    readonly fileCount: number;
+    /** Total snippets across all files */
+    readonly totalSnippets: number;
+}
+/**
+ * Options for server-bridge route generation.
+ */
+interface ServerBridgeOptions {
+    /** Target server framework (default: 'express') */
+    framework?: 'express' | 'hono' | 'openapi' | 'django' | 'fastapi';
+    /** Output directory for generated route files (default: './server/routes') */
+    output?: string;
+    /** Generate TypeScript (default: true) */
+    typescript?: boolean;
+    /** URL patterns to ignore */
+    ignore?: string[];
+}
+
+/**
+ * Domain Scanner for Vite Plugin
+ *
+ * Scans source files for domain-specific DSL usage based on configurable
+ * attribute patterns and keyword sets. Runs alongside the existing
+ * hyperscript Scanner as an opt-in feature.
+ */
+
+/**
+ * Scanner that detects domain-specific syntax in source files.
+ * Complements the existing hyperscript Scanner.
+ */
+declare class DomainScanner {
+    private rules;
+    /** Pre-compiled regex for fast hasAnyDomainUsage check */
+    private quickCheckPattern;
+    constructor(rules: readonly DomainScanRule[]);
+    /**
+     * Fast pre-check: does this code contain any domain-related attributes?
+     */
+    hasAnyDomainUsage(code: string): boolean;
+    /**
+     * Scan a file for all registered domain syntaxes.
+     * Returns one DomainFileUsage per domain that had matches.
+     */
+    scan(code: string, _id: string): DomainFileUsage[];
+}
+/**
+ * Convert a DomainDescriptor's scanConfig to a DomainScanRule.
+ * Returns null if the descriptor has no scanConfig.
+ *
+ * This allows DomainDescriptors from the framework to be used
+ * directly with the Vite plugin scanner.
+ */
+declare function descriptorToScanRule(descriptor: {
+    name: string;
+    scanConfig?: {
+        attributes: readonly string[];
+        scriptTypes?: readonly string[];
+        keywords?: Readonly<Record<string, readonly string[]>>;
+    };
+}): DomainScanRule | null;
+
+/**
+ * Domain Aggregator
+ *
+ * Aggregates per-domain usage across files, following the same
+ * pattern as the existing hyperscript Aggregator.
+ */
+
+/**
+ * Aggregates domain usage across multiple files.
+ */
+declare class DomainAggregator {
+    private fileUsage;
+    private cache;
+    /**
+     * Add or update domain usage for a file.
+     * Returns true if usage changed (invalidates cache).
+     */
+    add(filePath: string, usage: DomainFileUsage[]): boolean;
+    /**
+     * Remove a file's domain usage.
+     * Returns true if the file was tracked.
+     */
+    remove(filePath: string): boolean;
+    /**
+     * Get aggregated usage across all files.
+     * Result is cached until add/remove changes it.
+     */
+    getUsage(): DomainAggregatedUsage[];
+    /**
+     * Get aggregated usage for a specific domain.
+     */
+    getUsageForDomain(domain: string): DomainAggregatedUsage | null;
+    /**
+     * Clear all tracked data.
+     */
+    clear(): void;
+    private isEqual;
+}
 
 /**
  * Compiler
@@ -401,4 +573,4 @@ declare function getOptimalRegion(languages: Set<SupportedLanguage>): 'western'
  */
 declare function hyperfixi(options?: HyperfixiPluginOptions): Plugin;
 
-export { type AggregatedUsage, type CompileOptions, type CompiledHandler, type CustomLanguageKeywords, type FileUsage, type HyperfixiPluginOptions, REGIONS, SUPPORTED_LANGUAGES, type SupportedLanguage, clearCustomKeywords, clearSemanticParser, hyperfixi as default, detectLanguages, getAllLanguageCodes, getKeywordsForLanguage, getOptimalRegion, hasSemanticParser, hyperfixi, isNonLatinLanguage, registerCustomKeywords, setSemanticParser };
+export { type AggregatedUsage, type CompileOptions, type CompiledHandler, type CustomLanguageKeywords, type DomainAggregatedUsage, DomainAggregator, type DomainFileUsage, type DomainScanRule, DomainScanner, type FileUsage, type HyperfixiPluginOptions, REGIONS, SUPPORTED_LANGUAGES, type ServerBridgeOptions, type SupportedLanguage, clearCustomKeywords, clearSemanticParser, hyperfixi as default, descriptorToScanRule, detectLanguages, getAllLanguageCodes, getKeywordsForLanguage, getOptimalRegion, hasSemanticParser, hyperfixi, isNonLatinLanguage, registerCustomKeywords, setSemanticParser };

package/dist/index.d.ts

@@ -75,6 +75,22 @@ interface HyperfixiPluginOptions {
      * Enable verbose logging during development.
      */
     debug?: boolean;
+    /**
+     * Enable server-bridge route generation alongside bundle generation.
+     * Requires `@hyperfixi/server-bridge` to be installed as a peer dependency.
+     * If not installed, a warning is logged and the feature is silently skipped.
+     *
+     * @example
+     * ```typescript
+     * hyperfixi({
+     *   serverBridge: {
+     *     framework: 'express',
+     *     output: './server/routes',
+     *   }
+     * })
+     * ```
+     */
+    serverBridge?: ServerBridgeOptions;
     /**
      * Enable semantic parsing for multilingual support.
      * - false: No semantic parsing (default, current behavior)
@@ -109,6 +125,26 @@ interface HyperfixiPluginOptions {
      * Useful for dynamic content not detectable at build time.
      */
     extraLanguages?: string[];
+    /**
+     * Register additional domains for scanning.
+     * Each domain declares its attribute patterns and keywords for detection.
+     * Runs alongside the default hyperscript scanner.
+     *
+     * @example
+     * ```typescript
+     * hyperfixi({
+     *   domains: [
+     *     {
+     *       domain: 'sql',
+     *       attributes: ['data-sql'],
+     *       scriptTypes: ['text/sql-dsl'],
+     *       keywords: { en: ['select', 'insert', 'update', 'delete'] },
+     *     },
+     *   ],
+     * })
+     * ```
+     */
+    domains?: DomainScanRule[];
     /**
      * Custom language keyword definitions.
      * Use this to add new languages or extend/override existing keyword detection.
@@ -206,6 +242,142 @@ interface AggregatedUsage {
     /** Map of file paths to their usage */
     fileUsage: Map<string, FileUsage>;
 }
+/**
+ * Configuration for a domain's scanning rules in the Vite plugin.
+ */
+interface DomainScanRule {
+    /** Domain name */
+    readonly domain: string;
+    /** Attribute names to scan for (e.g., ['data-sql', '_sql']) */
+    readonly attributes: readonly string[];
+    /** Script tag types to scan for (e.g., ['text/sql-dsl']) */
+    readonly scriptTypes?: readonly string[];
+    /** Keywords for command detection, keyed by language code */
+    readonly keywords?: Readonly<Record<string, readonly string[]>>;
+}
+/**
+ * Per-domain usage detected in a single file.
+ */
+interface DomainFileUsage {
+    /** Domain name */
+    readonly domain: string;
+    /** Detected keywords/commands */
+    readonly detectedKeywords: Set<string>;
+    /** Languages detected */
+    readonly detectedLanguages: Set<string>;
+    /** Number of snippets found */
+    readonly snippetCount: number;
+}
+/**
+ * Aggregated usage across all files for a single domain.
+ */
+interface DomainAggregatedUsage {
+    /** Domain name */
+    readonly domain: string;
+    /** All detected keywords across files */
+    readonly detectedKeywords: Set<string>;
+    /** All detected languages across files */
+    readonly detectedLanguages: Set<string>;
+    /** Number of files with this domain's usage */
+    readonly fileCount: number;
+    /** Total snippets across all files */
+    readonly totalSnippets: number;
+}
+/**
+ * Options for server-bridge route generation.
+ */
+interface ServerBridgeOptions {
+    /** Target server framework (default: 'express') */
+    framework?: 'express' | 'hono' | 'openapi' | 'django' | 'fastapi';
+    /** Output directory for generated route files (default: './server/routes') */
+    output?: string;
+    /** Generate TypeScript (default: true) */
+    typescript?: boolean;
+    /** URL patterns to ignore */
+    ignore?: string[];
+}
+
+/**
+ * Domain Scanner for Vite Plugin
+ *
+ * Scans source files for domain-specific DSL usage based on configurable
+ * attribute patterns and keyword sets. Runs alongside the existing
+ * hyperscript Scanner as an opt-in feature.
+ */
+
+/**
+ * Scanner that detects domain-specific syntax in source files.
+ * Complements the existing hyperscript Scanner.
+ */
+declare class DomainScanner {
+    private rules;
+    /** Pre-compiled regex for fast hasAnyDomainUsage check */
+    private quickCheckPattern;
+    constructor(rules: readonly DomainScanRule[]);
+    /**
+     * Fast pre-check: does this code contain any domain-related attributes?
+     */
+    hasAnyDomainUsage(code: string): boolean;
+    /**
+     * Scan a file for all registered domain syntaxes.
+     * Returns one DomainFileUsage per domain that had matches.
+     */
+    scan(code: string, _id: string): DomainFileUsage[];
+}
+/**
+ * Convert a DomainDescriptor's scanConfig to a DomainScanRule.
+ * Returns null if the descriptor has no scanConfig.
+ *
+ * This allows DomainDescriptors from the framework to be used
+ * directly with the Vite plugin scanner.
+ */
+declare function descriptorToScanRule(descriptor: {
+    name: string;
+    scanConfig?: {
+        attributes: readonly string[];
+        scriptTypes?: readonly string[];
+        keywords?: Readonly<Record<string, readonly string[]>>;
+    };
+}): DomainScanRule | null;
+
+/**
+ * Domain Aggregator
+ *
+ * Aggregates per-domain usage across files, following the same
+ * pattern as the existing hyperscript Aggregator.
+ */
+
+/**
+ * Aggregates domain usage across multiple files.
+ */
+declare class DomainAggregator {
+    private fileUsage;
+    private cache;
+    /**
+     * Add or update domain usage for a file.
+     * Returns true if usage changed (invalidates cache).
+     */
+    add(filePath: string, usage: DomainFileUsage[]): boolean;
+    /**
+     * Remove a file's domain usage.
+     * Returns true if the file was tracked.
+     */
+    remove(filePath: string): boolean;
+    /**
+     * Get aggregated usage across all files.
+     * Result is cached until add/remove changes it.
+     */
+    getUsage(): DomainAggregatedUsage[];
+    /**
+     * Get aggregated usage for a specific domain.
+     */
+    getUsageForDomain(domain: string): DomainAggregatedUsage | null;
+    /**
+     * Clear all tracked data.
+     */
+    clear(): void;
+    private isEqual;
+}
 
 /**
  * Compiler
@@ -401,4 +573,4 @@ declare function getOptimalRegion(languages: Set<SupportedLanguage>): 'western'
  */
 declare function hyperfixi(options?: HyperfixiPluginOptions): Plugin;
 
-export { type AggregatedUsage, type CompileOptions, type CompiledHandler, type CustomLanguageKeywords, type FileUsage, type HyperfixiPluginOptions, REGIONS, SUPPORTED_LANGUAGES, type SupportedLanguage, clearCustomKeywords, clearSemanticParser, hyperfixi as default, detectLanguages, getAllLanguageCodes, getKeywordsForLanguage, getOptimalRegion, hasSemanticParser, hyperfixi, isNonLatinLanguage, registerCustomKeywords, setSemanticParser };
+export { type AggregatedUsage, type CompileOptions, type CompiledHandler, type CustomLanguageKeywords, type DomainAggregatedUsage, DomainAggregator, type DomainFileUsage, type DomainScanRule, DomainScanner, type FileUsage, type HyperfixiPluginOptions, REGIONS, SUPPORTED_LANGUAGES, type ServerBridgeOptions, type SupportedLanguage, clearCustomKeywords, clearSemanticParser, hyperfixi as default, descriptorToScanRule, detectLanguages, getAllLanguageCodes, getKeywordsForLanguage, getOptimalRegion, hasSemanticParser, hyperfixi, isNonLatinLanguage, registerCustomKeywords, setSemanticParser };