@stacksjs/stx 0.2.5 → 0.2.6

package/dist/csp.d.ts

@@ -108,7 +108,7 @@ export declare function getCspPreset(preset: CspPreset): CspConfig;
  * // }
  * ```
  */
-export declare function mergeCspDirectives(base: CspDirectives, override: CspDirectives): CspDirectives;
+export declare function mergeCspDirectives(base: CspDirectives, : CspDirectives): CspDirectives;
 /**
  * Inject CSP meta tag into HTML head
  *
@@ -226,4 +226,4 @@ export declare const cspNonceDirective: CustomDirective;
 /**
  * Default CSP configuration - moderate preset
  */
-export declare const defaultCspConfig: CspConfig;
+export declare const defaultCspConfig: CspConfig;

package/dist/csrf.d.ts

@@ -25,4 +25,4 @@ export declare function processCsrfDirectives(template: string): string;
 /**
  * Middleware-like function to verify CSRF token
  */
-export declare function verifyCsrfToken(token: string): boolean;
+export declare function verifyCsrfToken(token: string): boolean;

package/dist/custom-directives.d.ts

@@ -2,4 +2,4 @@ import type { StxOptions } from './types';
 /**
  * Process all custom directives registered in the app
  */
-export declare function processCustomDirectives(template: string, context: Record<string, any>, filePath: string, options: StxOptions): Promise<string>;
+export declare function processCustomDirectives(template: string, context: Record<string, any>, filePath: string, options: StxOptions): Promise<string>;

package/dist/database.d.ts

@@ -249,6 +249,7 @@ export declare interface ModelInstance {
   original: Row
   attributes: Row
   isDirty: (key?: string) => boolean
+  [key: string]: unknown
 }
 /**
  * Model class
@@ -285,38 +286,25 @@ export declare interface DatabaseAdapter {
 /**
  * Supported database drivers
  */
-export type DatabaseDriver = 'sqlite' | 'postgres' | 'mysql' | 'custom'
+export type DatabaseDriver = 'sqlite' | 'postgres' | 'mysql' | 'custom';
 /**
  * Query operator types
  */
-export type QueryOperator = '=' | '!=' | '<' | '<=' | '>' | '>=' | 'like' | 'in' | 'not in' | 'between' | 'is null' | 'is not null'
+export type QueryOperator = '=' | '!=' | '<' | '<=' | '>' | '>=' | 'like' | 'in' | 'not in' | 'between' | 'is null' | 'is not null';
 /**
  * Query result row
  */
-export type Row = Record<string, unknown>
+export type Row = Record<string, unknown>;
 /**
  * Fluent query builder class
  */
 export declare class QueryBuilder {
-  private _table: string;
-  private _columns: (string | RawExpression)[];
-  private _wheres: WhereCondition[];
-  private _orders: OrderByClause[];
-  private _joins: JoinClause[];
-  private _groupBy: string[];
-  private _having: WhereCondition[];
-  private _limit?: number;
-  private _offset?: number;
-  private _distinct: boolean;
-  private _connection?: string;
-  private _bindings: unknown[];
-  private _modelDefinition?: ModelDefinition;
   constructor(table?: string);
   table(name: string): this;
   from(name: string): this;
   connection(name: string): this;
-  select(columns: (string | RawExpression)[]): this;
-  addSelect(columns: (string | RawExpression)[]): this;
+  select(...columns: (string | RawExpression)[]): this;
+  addSelect(...columns: (string | RawExpression)[]): this;
   distinct(): this;
   where(column: string, operatorOrValue: QueryOperator | unknown, value?: unknown): this;
   orWhere(column: string, operatorOrValue: QueryOperator | unknown, value?: unknown): this;
@@ -331,7 +319,7 @@ export declare class QueryBuilder {
   rightJoin(table: string, first: string, operator: string, second: string): this;
   orderBy(column: string, direction?: 'asc' | 'desc'): this;
   orderByDesc(column: string): this;
-  groupBy(columns: string[]): this;
+  groupBy(...columns: string[]): this;
   having(column: string, operator: QueryOperator, value: unknown): this;
   limit(count: number): this;
   take(count: number): this;
@@ -359,8 +347,6 @@ export declare class QueryBuilder {
   delete(): Promise<number>;
   truncate(): Promise<void>;
   toSql(): { sql: string, bindings: unknown[] };
-  private buildWhereClause(): string;
-  private getCacheKey(sql: string, bindings: unknown[]): string;
   clone(): QueryBuilder;
 }
 /**
@@ -375,7 +361,6 @@ export declare class DatabaseError extends Error {
  * Schema builder for database migrations
  */
 export declare class SchemaBuilder {
-  private _connection?: string;
   connection(name: string): this;
   create(table: string, callback: (blueprint: Blueprint) => void): Promise<void>;
   drop(table: string): Promise<void>;
@@ -386,9 +371,6 @@ export declare class SchemaBuilder {
  * Table blueprint for schema definitions
  */
 export declare class Blueprint {
-  private columns: string[];
-  private indices: string[];
-  private table: string;
   constructor(table: string);
   id(name?: string): this;
   string(name: string, length?: number): this;
@@ -404,4 +386,4 @@ export declare class Blueprint {
   unique(columns: string | string[]): this;
   toCreateSQL(): string;
   getIndexSQL(): string[];
-}
+}

package/dist/defer.d.ts

@@ -1,4 +1,4 @@
 /**
  * Process @defer directives in template
  */
-export declare function processDeferDirectives(template: string, _context: Record<string, unknown>, _filePath: string): string;
+export declare function processDeferDirectives(template: string, _context: Record<string, unknown>, _filePath: string): string;

package/dist/deploy/config-generators.d.ts

@@ -72,4 +72,4 @@ export declare interface ProjectConfig {
   edgeFunctionsDir?: string
   nodeVersion?: string
   isSPA?: boolean
-}
+}

package/dist/deploy/index.d.ts

@@ -1,5 +1,5 @@
-import { createNetlifyClient, collectDeployFiles, createFileManifest, filterRequiredFiles, formatSize, getTotalSize,  } from './netlify';
-import { detectProjectConfig, createDefaultNetlifyConfig, generateNetlifyToml, writeNetlifyConfig, hasNetlifyConfig,  } from './config-generators';
+import { createNetlifyClient, collectDeployFiles, createFileManifest, filterRequiredFiles, formatSize, getTotalSize, type NetlifyClient, type NetlifyDeploy, type DeployFile } from './netlify';
+import { detectProjectConfig, createDefaultNetlifyConfig, generateNetlifyToml, writeNetlifyConfig, hasNetlifyConfig } from './config-generators';
 export type {
   NetlifyClient,
   NetlifySite,
@@ -66,6 +66,9 @@ export declare class DeployError extends Error {
   code: string;
   constructor(message: string, code: string);
 }
+// ============================================================================
+// Re-exports
+// ============================================================================
 export {
   createNetlifyClient,
   collectDeployFiles,
@@ -81,4 +84,4 @@ export {
   createDefaultNetlifyConfig,
   writeNetlifyConfig,
   hasNetlifyConfig,
-} from './config-generators';
+} from './config-generators';

package/dist/deploy/netlify.d.ts

@@ -106,4 +106,4 @@ export declare interface WaitOptions {
   timeout?: number
   pollInterval?: number
   onProgress?: (deploy: NetlifyDeploy) => void
-}
+}

package/dist/dev-server/crosswind.d.ts

@@ -51,4 +51,14 @@ declare interface CrosswindConfig {
   minify?: boolean
   preflights?: unknown[]
   safelist?: string[]
-}
+  [key: string]: unknown
+}
+declare interface CrosswindBuildResult {
+  css: string
+  classes: Set<string>
+  duration: number
+}
+declare interface CSSGenerator {
+  generate(className: string): void
+  toCSS(preflight: boolean, minify: boolean): string
+}

package/dist/dev-server/index.d.ts

@@ -1,7 +1,22 @@
+/**
+ * Dev Server Module
+ *
+ * This module provides a development server for STX templates and Markdown files.
+ * It has been split into focused sub-modules:
+ *
+ * - terminal-colors.ts - ANSI color codes for terminal output
+ * - crosswind.ts - Crosswind CSS generation
+ * - theme-selector.ts - Theme selector UI components
+ * - port-utils.ts - Port availability checking
+ * - native-window.ts - Native window handling
+ * - keyboard-shortcuts.ts - Keyboard shortcut handling
+ * - types.ts - Type definitions
+ */
+// Re-export all sub-modules
 export * from './terminal-colors';
 export * from './crosswind';
 export * from './theme-selector';
 export * from './port-utils';
 export * from './native-window';
 export * from './keyboard-shortcuts';
-export * from './types';
+export * from './types';

package/dist/dev-server/keyboard-shortcuts.d.ts

@@ -31,4 +31,4 @@ export declare interface KeyboardCommandHandlers {
   onClear?: () => void
   onQuit?: () => void
   onHelp?: () => void
-}
+}

package/dist/dev-server/native-window.d.ts

@@ -37,4 +37,4 @@ export declare interface NativeWindowConfig {
   nativeSidebar?: boolean
   sidebarWidth?: number
   sidebarConfig?: SidebarConfig
-}
+}

package/dist/dev-server/port-utils.d.ts

@@ -9,7 +9,7 @@ export declare function isPortAvailable(port: number): Promise<boolean>;
  * @param maxAttempts - Maximum number of ports to try (default: 20)
  * @throws Error if no available port is found within maxAttempts
  */
-export declare function findAvailablePort(startPort: number, maxAttempts?: any): Promise<number>;
+export declare function findAvailablePort(startPort: number, maxAttempts?: number): Promise<number>;
 /**
  * Find an available port within a specific range
  */
@@ -24,4 +24,4 @@ export declare const DEFAULT_PORT: 3000;
 export declare interface PortRange {
   start: number
   end: number
-}
+}

package/dist/dev-server/terminal-colors.d.ts

@@ -27,16 +27,13 @@ export declare function dim(text: string): string;
  * Provides consistent coloring for CLI messages
  */
 export declare const colors: {
-  // Reset
   reset: '\x1B[0m';
-  // Text styles
   bright: '\x1B[1m';
   dim: '\x1B[2m';
   underscore: '\x1B[4m';
   blink: '\x1B[5m';
   reverse: '\x1B[7m';
   hidden: '\x1B[8m';
-  // Foreground colors
   black: '\x1B[30m';
   red: '\x1B[31m';
   green: '\x1B[32m';
@@ -46,7 +43,6 @@ export declare const colors: {
   cyan: '\x1B[36m';
   white: '\x1B[37m';
   gray: '\x1B[90m';
-  // Background colors
   bgBlack: '\x1B[40m';
   bgRed: '\x1B[41m';
   bgGreen: '\x1B[42m';
@@ -57,4 +53,4 @@ export declare const colors: {
   bgWhite: '\x1B[47m';
   bgGray: '\x1B[100m'
 };
-export type ColorName = keyof typeof colors
+export type ColorName = keyof typeof colors;

package/dist/dev-server/theme-selector.d.ts

@@ -29,4 +29,4 @@ export declare function isDarkTheme(themeName: string): boolean;
 /**
  * List of dark theme keywords for theme detection
  */
-export declare const DARK_THEME_KEYWORDS: readonly ['dark', 'night', 'monokai', 'dracula', 'nord', 'material', 'ayu', 'one-dark', 'tokyo', 'gruvbox', 'solarized-dark'];
+export declare const DARK_THEME_KEYWORDS: readonly ['dark', 'night', 'monokai', 'dracula', 'nord', 'material', 'ayu', 'one-dark', 'tokyo', 'gruvbox', 'solarized-dark'];

package/dist/dev-server/types.d.ts

@@ -44,15 +44,10 @@ export declare const DEFAULT_DEV_OPTIONS: Required<Omit<DevServerOptions, 'stxOp
  */
 export declare interface MarkdownOptions {
   syntaxHighlighting?: {
-    /** Enable server-side syntax highlighting */
     serverSide?: boolean
-    /** Enable syntax highlighting (default: true) */
     enabled?: boolean
-    /** Default theme for code blocks */
     defaultTheme?: SyntaxHighlightTheme
-    /** Highlight code blocks with unknown languages */
     highlightUnknownLanguages?: boolean
-    /** Additional themes to make available */
     additionalThemes?: SyntaxHighlightTheme[]
   }
 }
@@ -81,12 +76,12 @@ export declare interface ServerInstance {
 /**
  * File watcher event types
  */
-export type WatchEventType = 'change' | 'rename' | 'delete' | 'add'
+export type WatchEventType = 'change' | 'rename' | 'delete' | 'add';
 /**
  * File watcher callback
  */
-export type WatchCallback = (eventType: WatchEventType, filename: string) => void
+export type WatchCallback = (eventType: WatchEventType, filename: string) => void;
 /**
  * Route handler function
  */
-export type RouteHandler = (request: Request) => Promise<Response> | Response
+export type RouteHandler = (request: Request) => Promise<Response> | Response;

package/dist/dev-server.d.ts

@@ -1,6 +1,3 @@
-import {  } from './dev-server/index';
-import {  } from './hot-reload';
-import {  } from './route-middleware';
 import type { SyntaxHighlightTheme } from './types';
 // Build and serve a specific stx file
 export declare function serveStxFile(filePath: string, options?: DevServerOptions): Promise<boolean>;
@@ -40,4 +37,4 @@ export declare interface DevServerOptions {
   cache?: boolean
   hotReload?: boolean
   hmrPort?: number
-}
+}

package/dist/devtools.d.ts

@@ -129,6 +129,9 @@ export declare interface DevToolsState {
   maxEvents: number
   maxPerformance: number
 }
+// =============================================================================
+// Exports
+// =============================================================================
 export {
   devToolsState,
   selectComponent,
@@ -139,4 +142,4 @@ export {
   logComponentTree,
   logStoreState,
   timeTravel,
-};
+};

package/dist/directive-api.d.ts

@@ -50,7 +50,7 @@ export declare function unregisterDirective(name: string): boolean;
  * })
  * ```
  */
-export declare function defineDirective<P extends DirectiveParams = DirectiveParams, T = unknown>(definition: FullDirectiveDefinition<P, T>): CustomDirective;
+export declare function defineDirective<P extends DirectiveParams = DirectiveParams, T = unknown,>(definition: FullDirectiveDefinition<P, T>): CustomDirective;
 /**
  * Define a client-only directive.
  */
@@ -104,8 +104,8 @@ export declare interface ClientDirectiveDefinition<T = unknown> {
   unmounted?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
 }
 /** Combined directive (server + client) */
-export declare interface FullDirectiveDefinition<P extends DirectiveParams = DirectiveParams, T = unknown> extends DirectiveDefinition<P> {
+export declare interface FullDirectiveDefinition<P extends DirectiveParams = DirectiveParams, T = unknown,> extends DirectiveDefinition<P> {
   client?: ClientDirectiveDefinition<T>
 }
 /** Directive parameter types */
-export type DirectiveParams = Record<string, unknown>
+export type DirectiveParams = Record<string, unknown>;

package/dist/docs.d.ts

@@ -11,7 +11,7 @@ export declare function extractComponentDescription(componentPath: string): Prom
 /**
  * Generate documentation for a component
  */
-export declare function generateComponentDoc(componentPath: string, isWebComponent?: any, webComponentTag?: string): Promise<ComponentDoc>;
+export declare function generateComponentDoc(componentPath: string, isWebComponent?: boolean, webComponentTag?: string): Promise<ComponentDoc>;
 /**
  * Find all component files in a directory
  */
@@ -53,4 +53,4 @@ export declare function generateDocs(options: {
 /**
  * Documentation generation command handler for CLI
  */
-export declare function docsCommand(options: any): Promise<boolean>;
+export declare function docsCommand(options: any): Promise<boolean>;

package/dist/dynamic-components.d.ts

@@ -11,4 +11,4 @@ import type { StxOptions } from './types';
  * @param dependencies - Dependency tracking set
  * @returns Processed template with dynamic components resolved
  */
-export declare function processDynamicComponents(template: string, context: Record<string, any>, filePath: string, options: StxOptions, dependencies?: Set<string>): Promise<string>;
+export declare function processDynamicComponents(template: string, context: Record<string, any>, filePath: string, options: StxOptions, dependencies?: Set<string>): Promise<string>;

package/dist/edge-runtime.d.ts

@@ -83,7 +83,7 @@ export declare function redirect(url: string, status?: 301 | 302 | 303 | 307 | 3
 /**
  * Not found response helper.
  */
-export declare function notFound(message?: any): Response;
+export declare function notFound(message?: string): Response;
 /** Edge runtime detection result */
 export declare interface RuntimeInfo {
   platform: EdgePlatform
@@ -191,10 +191,10 @@ export type EdgePlatform = | 'cloudflare'
   | 'fastly'
   | 'node'
   | 'bun'
-  | 'unknown'
+  | 'unknown';
 /** Middleware function */
 export type EdgeMiddleware = (
   request: Request,
   context: EdgeContext,
   next: () => Promise<Response>
-) => Promise<Response>
+) => Promise<Response>;

package/dist/env.d.ts

@@ -6,4 +6,4 @@ export declare function isProduction(): boolean;
  * Returns true when NOT in production mode, or when debug is enabled.
  * This covers development, test, and unset environments.
  */
-export declare function isDevelopment(): boolean;
+export declare function isDevelopment(): boolean;

package/dist/error-boundaries.d.ts

@@ -68,4 +68,4 @@ export declare interface ErrorBoundaryState {
   hasError: boolean
   error: Error | null
   info: ErrorInfo | null
-}
+}

package/dist/error-handling.d.ts

@@ -1 +1,14 @@
-export * from './errors';
+/**
+ * Error Handling Module
+ *
+ * This module has been refactored into smaller, more focused files.
+ * All exports are re-exported from the errors/ directory.
+ *
+ * @module error-handling
+ * @see ./errors/codes.ts - Error codes and localized messages
+ * @see ./errors/types.ts - Error classes and configuration
+ * @see ./errors/formatter.ts - Error formatting utilities
+ * @see ./errors/sanitizer.ts - Parameter sanitization
+ * @see ./errors/logger.ts - Error logging and recovery
+ */
+export * from './errors';

package/dist/errors/codes.d.ts

@@ -40,50 +40,35 @@ export declare function getErrorCodeName(code: number): string | undefined;
  * - 1600-1699: Expression errors
  */
 export declare const ErrorCodes: {
-  // Syntax errors (1000-1099)
   UNCLOSED_DIRECTIVE: 1001;
   UNCLOSED_EXPRESSION: 1002;
   INVALID_DIRECTIVE_SYNTAX: 1003;
   MALFORMED_EXPRESSION: 1004;
   UNEXPECTED_TOKEN: 1005;
-  // Runtime errors (1100-1199)
   UNDEFINED_VARIABLE: 1101;
   TYPE_ERROR: 1102;
   EVALUATION_ERROR: 1103;
   INFINITE_LOOP: 1104;
   CIRCULAR_REFERENCE: 1105;
-  // Security errors (1200-1299)
   UNSAFE_EXPRESSION: 1201;
   PATH_TRAVERSAL: 1202;
   XSS_ATTEMPT: 1203;
   CODE_INJECTION: 1204;
   DOM_API_VIOLATION: 1205;
-  // File errors (1300-1399)
   FILE_NOT_FOUND: 1301;
   FILE_READ_ERROR: 1302;
   INVALID_FILE_PATH: 1303;
   PERMISSION_DENIED: 1304;
-  // Configuration errors (1400-1499)
   INVALID_CONFIG: 1401;
   MISSING_REQUIRED_CONFIG: 1402;
   DEPRECATED_CONFIG: 1403;
-  // Component errors (1500-1599)
   COMPONENT_NOT_FOUND: 1501;
   INVALID_PROPS: 1502;
   COMPONENT_RENDER_ERROR: 1503;
-  // Expression errors (1600-1699)
   FILTER_NOT_FOUND: 1601;
   INVALID_FILTER_ARGS: 1602;
   EXPRESSION_TIMEOUT: 1603
 };
-/**
- * Error Codes and Localized Messages
- *
- * Provides numeric error codes for programmatic error handling
- * and localized error message templates.
- *
- * @module errors/codes
- */
 /**
  * Error message template with placeholder support
  * Placeholders use {{name}} syntax
@@ -95,5 +80,5 @@ export declare interface ErrorMessageTemplate {
 /**
  * Localized error messages by error code
  */
-export type ErrorMessages = Record<number, ErrorMessageTemplate>
-export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes]
+export type ErrorMessages = Record<number, ErrorMessageTemplate>;
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];

package/dist/errors/formatter.d.ts

@@ -61,4 +61,4 @@ export declare interface StandardizedError {
 /**
  * Error output format options
  */
-export type ErrorOutputFormat = 'html' | 'text' | 'json' | 'console'
+export type ErrorOutputFormat = 'html' | 'text' | 'json' | 'console';

package/dist/errors/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Error Handling Module
+ *
+ * Provides comprehensive error handling utilities for the stx framework.
+ *
+ * @module errors
+ */
+// Error codes and localization
 export {
   clearErrorMessages,
   type ErrorCode,
@@ -11,6 +19,7 @@ export {
   registerErrorMessages,
   setErrorLocale,
 } from './codes';
+// Error formatting
 export {
   consoleError,
   createEnhancedError,
@@ -22,6 +31,7 @@ export {
   safeExecuteAsync,
   type StandardizedError,
 } from './formatter';
+// Logger and recovery
 export {
   devHelpers,
   type ErrorLogEntry,
@@ -30,6 +40,7 @@ export {
   type ErrorLoggerOptions,
   errorRecovery,
 } from './logger';
+// Sanitization
 export {
   sanitizeComponentProps,
   sanitizeDirectiveParam,
@@ -40,6 +51,7 @@ export {
   type SanitizeOptions,
   validators,
 } from './sanitizer';
+// Error types and classes
 export {
   configureErrorHandling,
   type ErrorConfig,
@@ -53,4 +65,4 @@ export {
   StxSecurityError,
   StxSyntaxError,
   StxValidationError,
-} from './types';
+} from './types';

package/dist/errors/logger.d.ts

@@ -47,23 +47,10 @@ export declare interface DevHelpers {
  * Error logging and monitoring with optional file persistence
  */
 export declare class ErrorLogger {
-  private errors: ErrorLogEntry[];
-  private maxErrors: number;
-  private enableFileLogging: boolean;
-  private logFilePath: string;
-  private logFormat: 'json' | 'text';
-  private maxFileSize: number;
-  private maxLogFiles: number;
-  private minLevel: 'all' | 'error' | 'warning';
-  private writeQueue: Promise<void>;
   constructor(options?: ErrorLoggerOptions);
   configure(options: ErrorLoggerOptions): void;
   log(error: Error, context?: unknown, level?: 'error' | 'warning' | 'info'): void;
-  private shouldLog(level: 'error' | 'warning' | 'info'): boolean;
-  private formatEntry(entry: ErrorLogEntry): string;
-  private writeToFile(entry: ErrorLogEntry): void;
-  private rotateIfNeeded(fs: typeof import('node:fs')): Promise<void>;
-  getRecentErrors(limit?: any): ErrorLogEntry[];
+  getRecentErrors(limit?: number): ErrorLogEntry[];
   getErrorsByType(errorType: string): ErrorLogEntry[];
   getErrorsByLevel(level: 'error' | 'warning' | 'info'): ErrorLogEntry[];
   clear(): void;
@@ -71,4 +58,4 @@ export declare class ErrorLogger {
   getStats(): { total: number, byType: Record<string, number>, byLevel: Record<string, number> };
   exportToFile(filePath: string, format?: 'json' | 'text'): Promise<void>;
   flush(): Promise<void>;
-}
+}

package/dist/errors/sanitizer.d.ts

@@ -40,4 +40,4 @@ export declare interface SanitizedParam {
   value: string
   modified: boolean
   warnings: string[]
-}
+}

package/dist/errors/types.d.ts

@@ -76,4 +76,4 @@ export declare class StxFileError extends StxError {
 export declare class StxValidationError extends StxError {
   readonly isFatal: boolean;
   constructor(message: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
-}
+}

package/dist/events.d.ts

@@ -103,4 +103,4 @@ export declare interface EventModifiers {
   mouse: string | null
   debounce: number | null
   throttle: number | null
-}
+}