@stacksjs/stx 0.2.5 → 0.2.6

package/dist/a11y.d.ts

@@ -73,7 +73,7 @@ export declare function autoFixA11y(html: string, config?: A11yAutoFixConfig): A
  * @param writeBack - Whether to write the fixed content back to the file
  * @returns Fix result
  */
-export declare function autoFixA11yFile(filePath: string, config?: A11yAutoFixConfig, writeBack?: any): Promise<A11yFixResult>;
+export declare function autoFixA11yFile(filePath: string, config?: A11yAutoFixConfig, writeBack?: boolean): Promise<A11yFixResult>;
 /**
  * Auto-fix accessibility issues in a directory of files.
  *
@@ -96,10 +96,6 @@ export declare function autoFixA11yDirectory(directory: string, config?: A11yAut
  * Register all a11y directives
  */
 export declare function registerA11yDirectives(): CustomDirective[];
-/**
- * A11y directive for adding accessibility hints
- */
-export declare const a11yDirective: CustomDirective;
 /**
  * Screen reader directive for screen reader only content
  */
@@ -141,4 +137,4 @@ export declare interface A11yAutoFixConfig {
   fixPositiveTabindex?: boolean
   fixButtonFocusable?: boolean
   defaultLang?: string
-}
+}

package/dist/analytics.d.ts

@@ -37,4 +37,4 @@ export declare function injectAnalytics(html: string, options: StxOptions): stri
 /**
  * Custom @analytics directive for explicit placement
  */
-export declare const analyticsDirective: CustomDirective;
+export declare const analyticsDirective: CustomDirective;

package/dist/analyzer.d.ts

@@ -61,4 +61,4 @@ export declare interface ProjectSummary {
   issuesByCategory: Record<string, number>
   performanceScore: number
   recommendations: string[]
-}
+}

package/dist/animation.d.ts

@@ -1,8 +1,4 @@
 import type { CustomDirective, StxOptions } from './types';
-/**
- * Process animation directives in the template
- */
-export declare function processAnimationDirectives(template: string, context: Record<string, any>, filePath: string, options: StxOptions): string;
 /**
  * Create an animation timeline for coordinated animations
  */
@@ -33,59 +29,6 @@ export declare const DEFAULT_TRANSITION_OPTIONS: {
   ease: string
   direction: string
 };
-/**
- * Transition directive for applying transitions to elements
- */
-export declare const transitionDirective: CustomDirective;
-/**
- * Scroll animation directive for triggering animations on scroll
- */
-export declare const scrollAnimateDirective: CustomDirective;
-/**
- * Animation group directive for coordinating multiple animations
- */
-export declare const animationGroupDirective: CustomDirective;
-/**
- * Motion preferences directive for controlling animation preferences
- */
-export declare const motionDirective: CustomDirective;
-/** Preset spring configurations */
-export declare const SPRING_PRESETS: {
-  default: {
-  stiffness: 100;
-  damping: 10;
-  mass: 1
-};
-  gentle: {
-  stiffness: 120;
-  damping: 14;
-  mass: 1
-};
-  wobbly: {
-  stiffness: 180;
-  damping: 12;
-  mass: 1
-};
-  stiff: {
-  stiffness: 210;
-  damping: 20;
-  mass: 1
-};
-  slow: {
-  stiffness: 280;
-  damping: 60;
-  mass: 1
-};
-  molasses: {
-  stiffness: 280;
-  damping: 120;
-  mass: 1
-}
-};
-/**
- * @keyframe directive for custom keyframe animations
- */
-export declare const keyframeDirective: CustomDirective;
 /**
  * @stagger directive for staggered child animations
  */
@@ -94,34 +37,15 @@ export declare const staggerDirective: CustomDirective;
  * @spring directive for spring physics animations
  */
 export declare const springDirective: CustomDirective;
-/** Keyframe definition */
-export declare interface Keyframe {
-  offset?: number
-  properties: Record<string, string | number>
-  easing?: string
-}
-/** Animation timeline entry */
-export declare interface TimelineEntry {
-  selector: string
-  keyframes: Keyframe[]
-  options: KeyframeAnimationOptions
-}
-/** Keyframe animation options */
-export declare interface KeyframeAnimationOptions {
-  duration: number
-  delay?: number
-  easing?: string
-  iterations?: number | 'infinite'
-  direction?: 'normal' | 'reverse' | 'alternate' | 'alternate-reverse'
-  fill?: 'none' | 'forwards' | 'backwards' | 'both'
-}
-/** Spring animation config */
-export declare interface SpringConfig {
-  stiffness: number
-  damping: number
-  mass: number
-  velocity?: number
-}
+declare type  = : TransitionType,
+  options: {
+    duration?: number
+    delay?: number
+    ease?: TransitionEase
+    direction?: TransitionDirection
+    custom?: string
+  } = {},
+): string {;
 /**
  * Available transition types that can be used with @transition directive
  */
@@ -151,4 +75,4 @@ export declare enum TransitionEase {
   EaseOut = 'ease-out',
   EaseInOut = 'ease-in-out',
   Spring = 'spring',
-}
+}

package/dist/app.d.ts

@@ -24,7 +24,7 @@ export declare interface StxAppPlugin {
 /** The stx application instance */
 export declare interface StxApp {
   use(plugin: StxPluginInput, ...options: any[]): StxApp
-  provide(key: string | symbol, value: T): StxApp
+  provide<T>(key: string | symbol, value: T): StxApp
   component(name: string, definition?: any): StxApp | any
   directive(name: string, definition?: CustomDirective | Record<string, any>): StxApp | any
   mount(rootContainer?: string | Element): StxApp
@@ -41,11 +41,9 @@ export declare interface StxAppConfig {
   globalProperties: Record<string, any>
   performance: boolean
   compilerOptions: {
-    /** Custom element tag pattern */
     isCustomElement?: (tag: string) => boolean
-    /** Whitespace handling */
     whitespace?: 'condense' | 'preserve'
   }
 }
 /** Plugin can be an object with install() or a plain function */
-export type StxPluginInput = StxAppPlugin | ((app: StxApp, ...options: any[]) => void)
+export type StxPluginInput = StxAppPlugin | ((app: StxApp, ...options: any[]) => void);

package/dist/assets.d.ts

@@ -16,4 +16,4 @@ export declare const markdownCache: Map<string, {
   content: string
   data: Record<string, any>
   updatedAt: number
-}>;
+}>;

package/dist/ast.d.ts

@@ -242,7 +242,7 @@ export type ASTNode = | DocumentNode
   | AttributeNode
   | CommentNode
   | ScriptNode
-  | StyleNode
+  | StyleNode;
 /**
  * Token types for lexer (reserved for future tokenizer implementation)
  */
@@ -256,31 +256,10 @@ declare type _TokenType = | 'TEXT'
   | 'TAG_OPEN'
   | 'TAG_CLOSE'
   | 'TAG_SELF_CLOSE'
-  | 'EOF'
+  | 'EOF';
 /**
  * Simple template parser
  */
 export declare class TemplateParser {
-  private source: string;
-  private pos: number;
-  private line: number;
-  private column: number;
-  private filePath?: string;
   parse(template: string, filePath?: string): DocumentNode;
-  private parseChildren(stopAt?: RegExp): ASTNode[];
-  private parseNext(): ASTNode | null;
-  private parseText(): TextNode | null;
-  private parseExpression(escaped: boolean): ExpressionNode;
-  private parseDirective(): DirectiveNode;
-  private parseParenthesized(): string;
-  private parseStxComment(): CommentNode;
-  private parseHtmlComment(): CommentNode;
-  private parseTag(): ElementNode | ComponentNode;
-  private parseAttributes(): AttributeNode[];
-  private parseAttribute(): AttributeNode | null;
-  private parseScript(): ScriptNode;
-  private parseStyle(): StyleNode;
-  private advance(count?: number): void;
-  private skipWhitespace(): void;
-  private getPosition(): Position;
-}
+}

package/dist/async-components.d.ts

@@ -98,4 +98,4 @@ export declare interface DefineAsyncComponentOptions {
 }
 export declare interface AsyncComponentDefinition extends DefineAsyncComponentOptions {
   __asyncComponent: true
-}
+}

package/dist/auth.d.ts

@@ -7,4 +7,4 @@
  * @param {Record<string, any>} context - The context object containing variables
  * @returns The evaluated result
  */
-export declare function evaluateAuthExpression(expression: string, context: Record<string, any>): any;
+export declare function evaluateAuthExpression(expression: string, context: Record<string, any>): any;

package/dist/browser-composables.d.ts

@@ -30,7 +30,6 @@ export declare function useSessionStorage<T>(key: string, defaultValue: T): { va
 export declare function useEventListener<K extends keyof WindowEventMap>(event: K, handler: (e: WindowEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
 export declare function useEventListener<K extends keyof DocumentEventMap>(target: Document, event: K, handler: (e: DocumentEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
 export declare function useEventListener<K extends keyof HTMLElementEventMap>(target: MaybeRef<HTMLElement | null>, event: K, handler: (e: HTMLElementEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
-export declare function useEventListener(...args: any[]): () => void;
 /**
  * Detect clicks outside an element.
  *
@@ -192,7 +191,7 @@ export declare function useTimeout(callback: () => void, delay: number): {
  * setOpen(false) // false
  * ```
  */
-export declare function useToggle(initial?: any): [{ value: boolean }, () => void, (value: boolean) => void];
+export declare function useToggle(initial?: boolean): [{ value: boolean }, () => void, (value: boolean) => void];
 /**
  * Counter with controls.
  *
@@ -204,7 +203,7 @@ export declare function useToggle(initial?: any): [{ value: boolean }, () => voi
  * dec() // 5
  * ```
  */
-export declare function useCounter(initial?: any, options?: { min?: number; max?: number }): {
+export declare function useCounter(initial?: number, options?: { min?: number; max?: number }): {
   count: { value: number }
   inc: (delta?: number) => void
   dec: (delta?: number) => void
@@ -296,6 +295,9 @@ export declare function useAsync<T>(fn: () => Promise<T>, options?: { immediate?
   error: { readonly value: Error | null }
   execute: () => Promise<T | null>
 };
+// =============================================================================
+// Async Composables
+// =============================================================================
 declare interface UseFetchOptions<T> {
   immediate?: boolean
   initialData?: T
@@ -311,4 +313,4 @@ declare interface UseFetchReturn<T> {
 // =============================================================================
 // Types
 // =============================================================================
-declare type MaybeRef<T> = T | { value: T }
+declare type MaybeRef<T> = T | { value: T }

package/dist/build-optimizer.d.ts

@@ -46,34 +46,6 @@ export declare function optimizeTemplate(template: string, options?: Optimizatio
  * Create optimized build for multiple templates.
  */
 export declare function createOptimizedBuild(templates: Map<string, string>, options?: OptimizationOptions): Promise<BuildResult>;
-/**
- * Build-Time Optimization Module
- *
- * Provides tree-shaking, dead code elimination, and compile-time optimizations
- * for stx templates to reduce bundle size and improve runtime performance.
- *
- * ## Features
- *
- * 1. **Tree-Shaking** - Remove unused directive handlers from compiled output
- * 2. **Dead Code Elimination** - Remove unreachable template branches
- * 3. **Constant Folding** - Pre-evaluate static expressions
- * 4. **String Pooling** - Deduplicate repeated string literals
- * 5. **HTML Minification** - Remove whitespace and comments from static HTML
- *
- * ## Usage
- *
- * ```typescript
- * import { optimizeTemplate, createOptimizedBuild } from 'stx/build-optimizer'
- *
- * // Optimize a single template
- * const optimized = optimizeTemplate(template, { treeShake: true })
- *
- * // Create optimized build for multiple templates
- * const build = await createOptimizedBuild(templates, options)
- * ```
- *
- * @module build-optimizer
- */
 /** Optimization options */
 export declare interface OptimizationOptions {
   treeShake?: boolean
@@ -120,7 +92,10 @@ declare interface DeadBranch {
   end: number
   reason: string
 }
+// =============================================================================
+// Export Analysis Functions
+// =============================================================================
 export {
   analyzeDirectiveUsage as analyzeUsage,
   findDeadBranches as findDeadCode,
-};
+};

package/dist/build-views.d.ts

@@ -11,6 +11,24 @@ export declare function buildViews(options: ViewBuildOptions): Promise<BuildResu
  * Watch views directory and rebuild on changes
  */
 export declare function watchViews(options: ViewBuildOptions, callback?: (result: BuildResult) => void): { close: () => void };
+/**
+ * Render a .stx email template to an email-ready HTML string
+ *
+ * Optimized for email rendering:
+ * - Disables SEO tag injection
+ * - Inlines utility classes as style attributes (via Crosswind)
+ * - Strips <style> and <script> blocks
+ * - Returns clean HTML + plain text suitable for email
+ *
+ * @example
+ * ```typescript
+ * const { html, text } = await renderEmail('resources/emails/welcome.stx', {
+ *   userName: 'John',
+ *   unsubscribeUrl: 'https://example.com/unsubscribe?token=abc',
+ * })
+ * ```
+ */
+export declare function renderEmail(templatePath: string, props?: Record<string, unknown>, options?: Partial<StxOptions>): Promise<{ html: string, text: string }>;
 export declare interface ViewBuildOptions {
   viewsDir: string
   outputDir: string
@@ -34,4 +52,5 @@ export declare interface BuildResult {
   errors: Array<{ file: string; error: string }>
   duration: number
 }
-export default buildViews;
+// Default export for convenience
+export default buildViews;

package/dist/bundle-analyzer/collector.d.ts

@@ -63,4 +63,4 @@ export declare interface CollectorOptions {
   detectDuplicates?: boolean
   topModulesCount?: number
 }
-export type ModuleType = 'js' | 'css' | 'html' | 'image' | 'font' | 'other'
+export type ModuleType = 'js' | 'css' | 'html' | 'image' | 'font' | 'other';

package/dist/bundle-analyzer/index.d.ts

@@ -1,6 +1,6 @@
-import { collectBundleStats, formatBytes, parseSize } from './collector';
-import { generateReport, analyzeBundle } from './report';
-import { generateTreemap, openInBrowser } from './treemap';
+import { collectBundleStats, formatBytes, parseSize, type CollectorOptions } from './collector';
+import { generateReport, analyzeBundle, type ReportOptions } from './report';
+import { generateTreemap, openInBrowser, type TreemapOptions } from './treemap';
 /**
  * Analyze a bundle directory and generate a report
  */
@@ -32,6 +32,36 @@ export declare interface AnalyzeOptions {
   topModules?: number
   parseImports?: boolean
 }
+/**
+ * STX Bundle Analyzer
+ *
+ * Analyze and visualize bundle composition for optimization.
+ *
+ * @module bundle-analyzer
+ *
+ * @example
+ * ```bash
+ * # Generate HTML treemap
+ * stx analyze dist/
+ *
+ * # JSON output for CI
+ * stx analyze dist/ --json
+ *
+ * # Check size threshold
+ * stx analyze dist/ --threshold 500KB
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { collectBundleStats, generateReport, generateTreemap } from 'stx/bundle-analyzer'
+ *
+ * const stats = await collectBundleStats('dist/')
+ * console.log(generateReport(stats, { format: 'text' }))
+ * ```
+ */
+// ============================================================================
+// Collector Exports
+// ============================================================================
 export {
   collectBundleStats,
   formatBytes,
@@ -44,6 +74,9 @@ export {
   type BundleStats,
   type CollectorOptions,
 } from './collector';
+// ============================================================================
+// Report Exports
+// ============================================================================
 export {
   generateReport,
   analyzeBundle,
@@ -53,8 +86,11 @@ export {
   type AnalysisIssue,
   type Recommendation,
 } from './report';
+// ============================================================================
+// Treemap Exports
+// ============================================================================
 export {
   generateTreemap,
   openInBrowser,
   type TreemapOptions,
-} from './treemap';
+} from './treemap';

package/dist/bundle-analyzer/report.d.ts

@@ -36,4 +36,4 @@ export declare interface Recommendation {
   description: string
   impact: 'high' | 'medium' | 'low'
   effort: 'low' | 'medium' | 'high'
-}
+}

package/dist/bundle-analyzer/treemap.d.ts

@@ -16,4 +16,4 @@ export declare interface TreemapOptions {
   title?: string
   gzip?: boolean
   colorScheme?: 'default' | 'pastel' | 'monochrome'
-}
+}

package/dist/caching.d.ts

@@ -27,4 +27,4 @@ declare interface CacheEntry {
   output: string
   mtime: number
   dependencies: Set<string>
-}
+}