@stacksjs/stx 0.2.4 → 0.2.6

package/dist/init.d.ts

@@ -36,4 +36,4 @@ declare interface InitOptions {
 /**
  * Built-in template presets
  */
-declare type TemplatePreset = 'basic' | 'component' | 'layout' | 'blog' | 'api' | 'app'
+declare type TemplatePreset = 'basic' | 'component' | 'layout' | 'blog' | 'api' | 'app';

package/dist/interactive.d.ts

@@ -11,4 +11,4 @@ export declare interface InteractiveOptions {
   verbose?: boolean
   historyFile?: string
   maxHistory?: number
-}
+}

package/dist/internal-markdown.d.ts

@@ -19,4 +19,4 @@ export declare interface FrontmatterResult {
 export declare interface MarkdownOptions {
   gfm?: boolean
   breaks?: boolean
-}
+}

package/dist/js-ts.d.ts

@@ -7,4 +7,4 @@ export declare function processJsDirectives(template: string, context: Record<st
  * Process TypeScript directives in templates
  * Executes TypeScript code on the server and removes the code blocks from output
  */
-export declare function processTsDirectives(template: string, context: Record<string, any>, filePath?: string): Promise<string>;
+export declare function processTsDirectives(template: string, context: Record<string, any>, filePath?: string): Promise<string>;

package/dist/jsx-runtime.d.ts

@@ -79,25 +79,6 @@ export declare const jsxs: unknown;
  * Development version of jsx with extra validation.
  */
 export declare const jsxDEV: unknown;
-/**
- * STX JSX Runtime
- *
- * Self-made JSX runtime for stx — no React, no Preact, no external dependencies.
- * This module provides the jsx/jsxs/Fragment functions that Bun's JSX transpiler calls,
- * plus renderToString() for SSR and renderToDOM() for client-side rendering.
- *
- * Usage in tsconfig.json:
- * ```json
- * {
- *   "compilerOptions": {
- *     "jsx": "react-jsx",
- *     "jsxImportSource": "@stacksjs/stx"
- *   }
- * }
- * ```
- *
- * @module jsx-runtime
- */
 /** Virtual DOM node representation */
 export declare interface VNode {
   type: string | ComponentFunction | typeof Fragment
@@ -107,4 +88,4 @@ export declare interface VNode {
   ref?: string | ((el: any) => void) | null
 }
 /** Function component type */
-export type ComponentFunction = (props: Record<string, any>) => VNode | string | null
+export type ComponentFunction = (props: Record<string, any>) => VNode | string | null;

package/dist/keep-alive.d.ts

@@ -84,4 +84,4 @@ export declare interface KeepAliveCache {
   max: number
   include: string[] | null
   exclude: string[] | null
-}
+}

package/dist/lazy-loader.d.ts

@@ -39,47 +39,18 @@ export declare interface DirectiveProcessor {
   name?: string
   hasEndTag?: boolean
 }
-/**
- * Lazy Loading for Directive Processors
- *
- * Provides lazy loading capabilities for directive processors to reduce
- * initial load time and memory usage.
- *
- * ## Features
- *
- * - On-demand loading of directive processors
- * - Module caching to prevent re-imports
- * - Support for both sync and async loading
- * - Automatic dependency resolution
- *
- * ## Usage
- *
- * ```typescript
- * const loader = new LazyLoader()
- *
- * // Register lazy directive
- * loader.register('markdown', () => import('./markdown'))
- *
- * // Load when needed
- * const markdown = await loader.load('markdown')
- * ```
- *
- * @module lazy-loader
- */
 /**
  * Module loader function
  */
-export type ModuleLoader<T = unknown> = () => Promise<T> | T
+export type ModuleLoader<T = unknown> = () => Promise<T> | T;
 /**
  * Module status
  */
-export type ModuleStatus = 'pending' | 'loading' | 'loaded' | 'error'
+export type ModuleStatus = 'pending' | 'loading' | 'loaded' | 'error';
 /**
  * Lazy loader for directive processors
  */
 export declare class LazyLoader<T = unknown> {
-  private modules: Map<string, ModuleInfo<T>>;
-  private options: LazyLoaderOptions;
   constructor(options?: LazyLoaderOptions);
   register(name: string, loader: ModuleLoader<T>, dependencies?: string[]): void;
   registerAll(modules: Record<string, ModuleLoader<T>>): void;
@@ -105,18 +76,15 @@ export declare class LazyLoader<T = unknown> {
       loadTime?: number
     }>
   };
-  private loadWithTimeout(name: string, loader: ModuleLoader<T>): Promise<T>;
 }
 /**
  * Lazy loader specifically for directive processors
  */
 export declare class DirectiveLoaderRegistry {
-  private loader: LazyLoader<DirectiveProcessor | { default: DirectiveProcessor }>;
-  private directiveMap: Map<string, string>;
   constructor(options?: LazyLoaderOptions);
   registerDirective(directiveName: string, moduleName: string, loader: ModuleLoader<DirectiveProcessor | { default: DirectiveProcessor }>): void;
   getProcessor(directiveName: string): Promise<DirectiveProcessor | null>;
   hasDirective(directiveName: string): boolean;
   getDirectiveNames(): string[];
   preloadDirectives(directiveNames: string[]): Promise<void>;
-}
+}

package/dist/loading-indicator.d.ts

@@ -33,8 +33,9 @@ export declare interface LoadingIndicatorInstance {
   clear: () => void
   state: LoadingIndicatorState
 }
+// Export for use in STX templates
 export default {
   useLoadingIndicator,
   initLoadingIndicator,
   generateLoadingIndicatorHtml,
-};
+};

package/dist/loops.d.ts

@@ -22,4 +22,4 @@ import type { StxOptions } from './types';
  * @param filePath - Path to template file for error messages
  * @param options - Optional stx configuration
  */
-export declare function processLoops(template: string, context: Record<string, any>, filePath: string, options?: StxOptions): string;
+export declare function processLoops(template: string, context: Record<string, any>, filePath: string, options?: StxOptions): string;

package/dist/markdown.d.ts

@@ -7,4 +7,4 @@ export declare function processMarkdownDirectives(template: string, context: Rec
  * Custom directive handler for markdown
  * Can be registered as a custom directive
  */
-export declare function markdownDirectiveHandler(content: string, params: string[], _context: Record<string, any>, _filePath: string): Promise<string>;
+export declare function markdownDirectiveHandler(content: string, params: string[], _context: Record<string, any>, _filePath: string): Promise<string>;

package/dist/media/client/blur-up.d.ts

@@ -62,4 +62,4 @@ export declare interface BlurUpOptions {
   removePlaceholder?: boolean
   loadedClass?: string
   loadingClass?: string
-}
+}

package/dist/media/client/index.d.ts

@@ -9,6 +9,16 @@ export declare function generateMediaRuntime(): { script: string; css: string };
  * Generate minified media runtime for production
  */
 export declare function generateMinifiedMediaRuntime(): { script: string; css: string };
+/**
+ * STX Media - Client-Side Runtime
+ *
+ * Client-side utilities for lazy loading, blur-up effects, and file uploads.
+ *
+ * @module media/client
+ */
+// =============================================================================
+// Lazy Loading
+// =============================================================================
 export {
   // Types
   type LazyLoadOptions,
@@ -33,6 +43,9 @@ export {
   // Runtime generation
   generateLazyLoadRuntime,
 } from './lazy-load';
+// =============================================================================
+// Blur-Up Effects
+// =============================================================================
 export {
   // Types
   type BlurUpOptions,
@@ -54,6 +67,9 @@ export {
   generateBlurUpRuntime,
   generateBlurUpCSS,
 } from './blur-up';
+// =============================================================================
+// Upload Handler
+// =============================================================================
 export {
   // Types
   type UploadHandlerOptions,
@@ -74,4 +90,4 @@ export {
 
   // Runtime generation
   generateUploadRuntime,
-} from './upload-handler';
+} from './upload-handler';

package/dist/media/client/lazy-load.d.ts

@@ -70,4 +70,4 @@ export declare interface LazyLoadOptions {
   onLoad?: (element: HTMLElement) => void
   onLoaded?: (element: HTMLElement) => void
   onError?: (element: HTMLElement, error: Error) => void
-}
+}

package/dist/media/client/upload-handler.d.ts

@@ -76,4 +76,4 @@ export declare interface FileValidationResult {
   valid: boolean
   error?: string
   code?: 'INVALID_TYPE' | 'FILE_TOO_LARGE' | 'FILE_TOO_SMALL'
-}
+}

package/dist/media/image/component.d.ts

@@ -1,6 +1,4 @@
-import {  } from './placeholder';
-import {  } from './srcset';
-import type { ImageRenderContext, ImageRenderResult, ImgProps, EnhancedImgProps, TsImagesConfig, ProcessedImageResult, ResponsiveVariantSet,  } from '../types';
+import type { ImageRenderContext, ImageRenderResult, ImgProps, EnhancedImgProps, TsImagesConfig, ProcessedImageResult, ResponsiveVariantSet } from '../types';
 /**
  * Render an optimized <Img> component
  *
@@ -43,4 +41,4 @@ export declare interface ExtendedImageRenderContext extends ImageRenderContext {
   tsImagesConfig?: TsImagesConfig
   processedResult?: ProcessedImageResult
   responsiveVariants?: ResponsiveVariantSet
-}
+}

package/dist/media/image/directive.d.ts

@@ -6,4 +6,4 @@ export declare function createImgDirective(): CustomDirective;
 /**
  * The @img directive instance
  */
-export declare const imgDirective: unknown;
+export declare const imgDirective: unknown;

package/dist/media/image/editing.d.ts

@@ -209,4 +209,4 @@ export declare const PRESETS: {
   blur: 200;
   q: 20
 }
-};
+};

package/dist/media/image/index.d.ts

@@ -1,4 +1,16 @@
+// Export types separately
 export type { ExtendedImageRenderContext } from './component';
+/**
+ * STX Media - Image Module
+ *
+ * Complete image optimization with responsive srcset, lazy loading,
+ * blur-up placeholders, and imgix-style URL transformations.
+ *
+ * @module media/image
+ */
+// =============================================================================
+// Component Exports
+// =============================================================================
 export {
   // Main render function
   renderImgComponent,
@@ -6,12 +18,18 @@ export {
   parseImgComponent,
   processImgComponents,
 } from './component';
+// =============================================================================
+// Directive Exports
+// =============================================================================
 export {
   // Directive factory
   createImgDirective,
   // Directive instance
   imgDirective,
 } from './directive';
+// =============================================================================
+// Srcset Exports
+// =============================================================================
 export {
   // Constants
   DEFAULT_WIDTHS,
@@ -50,6 +68,9 @@ export {
   getFormatExtension,
   detectFormat,
 } from './srcset';
+// =============================================================================
+// Placeholder Exports
+// =============================================================================
 export {
   // Constants
   DEFAULT_PLACEHOLDER_OPTIONS,
@@ -74,6 +95,9 @@ export {
   clearPlaceholderCache,
   getPlaceholderCacheStats,
 } from './placeholder';
+// =============================================================================
+// Editing API Exports
+// =============================================================================
 export {
   // URL building
   buildImageUrl as buildUrl,
@@ -115,4 +139,4 @@ export {
   // Validation
   validateParams,
   sanitizeParams,
-} from './editing';
+} from './editing';

package/dist/media/image/placeholder.d.ts

@@ -75,4 +75,4 @@ export declare const DEFAULT_PLACEHOLDER_OPTIONS: PlaceholderOptions;
 /**
  * CSS for blur-up transition
  */
-export declare const BLUR_UP_CSS: unknown;
+export declare const BLUR_UP_CSS: unknown;

package/dist/media/image/processor/cache.d.ts

@@ -1,5 +1,5 @@
-import {  } from '../../shared/cache';
-import type { EnhancedImgProps, ProcessedImageResult, TsImagesConfig,  } from '../../types';
+import { type CacheConfig } from '../../shared/cache';
+import type { EnhancedImgProps, ProcessedImageResult, TsImagesConfig } from '../../types';
 /**
  * Get cached image processing result
  */
@@ -23,10 +23,9 @@ export declare interface ImageCacheConfig extends CacheConfig {
  * Image processor cache class
  */
 export declare class ImageProcessorCache {
-  private config: ImageCacheConfig;
   constructor(config?: Partial<ImageCacheConfig>);
   get(src: string, options: Partial<EnhancedImgProps>): Promise<ProcessedImageResult | null>;
   set(src: string, options: Partial<EnhancedImgProps>, result: ProcessedImageResult): Promise<void>;
   clear(): Promise<void>;
   updateConfig(config: Partial<ImageCacheConfig>): void;
-}
+}

package/dist/media/image/processor/index.d.ts

@@ -1,3 +1,4 @@
+// Re-export types for convenience
 export type {
   EnhancedImgProps,
   ProcessedImageResult,
@@ -7,6 +8,13 @@ export type {
   ImageTransformationConfig,
   FormatQualitySettings,
 } from '../../types';
+/**
+ * STX Media - Image Processor
+ *
+ * Integration with ts-images for build-time image optimization.
+ *
+ * @module media/image/processor
+ */
 export { processImage, optimizeImage, applyTransformations } from './optimizer';
 export { generateResponsiveVariants, generateSrcset } from './responsive';
-export { getCachedImageResult, setCachedImageResult, clearImageCache, ImageProcessorCache } from './cache';
+export { getCachedImageResult, setCachedImageResult, clearImageCache, ImageProcessorCache } from './cache';

package/dist/media/image/processor/optimizer.d.ts

@@ -1,4 +1,4 @@
-import type { EnhancedImgProps, ProcessedImageResult, TsImagesConfig, ImageFormat, ImageTransformationConfig,  } from '../../types';
+import type { EnhancedImgProps, ProcessedImageResult, TsImagesConfig, ImageFormat, ImageTransformationConfig } from '../../types';
 /**
  * Process a single image with ts-images
  */
@@ -10,4 +10,4 @@ export declare function optimizeImage(src: string, format: ImageFormat, quality:
 /**
  * Apply transformations to an image
  */
-export declare function applyTransformations(src: string, transformations: ImageTransformationConfig[], tsImages?: typeof import('ts-images') | null): Promise<Buffer | null>;
+export declare function applyTransformations(src: string, transformations: ImageTransformationConfig[], tsImages?: typeof import('ts-images') | null): Promise<Buffer | null>;

package/dist/media/image/processor/responsive.d.ts

@@ -1,4 +1,4 @@
-import type { EnhancedImgProps, ResponsiveVariantSet, TsImagesConfig, ProcessedImageResult,  } from '../../types';
+import type { EnhancedImgProps, ResponsiveVariantSet, TsImagesConfig, ProcessedImageResult } from '../../types';
 /**
  * Generate responsive image variants using ts-images
  */
@@ -13,5 +13,6 @@ export declare function generateSrcset(variants: ProcessedImageResult['variants'
 export declare function generateArtDirectionSources(src: string, artDirection: NonNullable<EnhancedImgProps['artDirection']>, config: TsImagesConfig): Promise<Array<{ media: string; srcset: string; type: string }>>;
 /**
  * Default responsive breakpoints
+ * @defaultValue `[320, 480, 640, 768, 1024, 1280, 1536, 1920]`
  */
-export declare const DEFAULT_RESPONSIVE_WIDTHS: readonly [320, 480, 640, 768, 1024, 1280, 1536, 1920];
+export declare const DEFAULT_RESPONSIVE_WIDTHS: number[];

package/dist/media/image/srcset.d.ts

@@ -1,4 +1,4 @@
-import type { Breakpoint, ImageFormat, ImageParams, ImageVariant, SrcsetData, SrcsetOptions,  } from '../types';
+import type { Breakpoint, ImageFormat, ImageParams, ImageVariant, SrcsetData, SrcsetOptions } from '../types';
 /**
  * Generate a width-based srcset string
  *
@@ -111,12 +111,14 @@ export declare function getFormatExtension(format: ImageFormat): string;
 export declare function detectFormat(src: string): ImageFormat | undefined;
 /**
  * Default breakpoint widths for responsive images
+ * @defaultValue `[320, 480, 640, 768, 1024, 1280, 1536, 1920, 2560]`
  */
-export declare const DEFAULT_WIDTHS: readonly [320, 480, 640, 768, 1024, 1280, 1536, 1920, 2560];
+export declare const DEFAULT_WIDTHS: number[];
 /**
  * Default DPR values for fixed-width images
+ * @defaultValue `[1, 1.5, 2, 3]`
  */
-export declare const DEFAULT_DPR_VALUES: readonly [1, 1.5, 2, 3];
+export declare const DEFAULT_DPR_VALUES: number[];
 /**
  * Default output formats in order of preference
  */
@@ -155,4 +157,4 @@ export declare const COMMON_SIZES: {
   quarterDesktop: '(max-width: 480px) 100vw, (max-width: 768px) 50vw, 25vw';
   /** Content width (centered with max-width) */
   contentWidth: '(max-width: 768px) 100vw, (max-width: 1200px) 80vw, 960px'
-};
+};

package/dist/media/index.d.ts

@@ -1,4 +1,12 @@
 import type { MediaConfig } from './types';
+/*"
+ *   preview
+ * />
+ * ```
+ */
+// =============================================================================
+// Type Exports
+// =============================================================================
 export type {
   // Placeholder types
   PlaceholderStrategy,
@@ -96,12 +104,16 @@ export type {
   SrcsetOptions,
   SrcsetData,
 } from './types';
+// Export types separately
 export type { ExtendedVideoRenderContext } from './video';
 export type { CacheConfig, CacheEntry } from './shared';
 /**
  * Default media configuration
  */
 export declare const defaultMediaConfig: MediaConfig;
+// =============================================================================
+// Image Module
+// =============================================================================
 export {
   // Component
   renderImgComponent,
@@ -182,6 +194,9 @@ export {
   validateParams,
   sanitizeParams,
 } from './image';
+// =============================================================================
+// Image Processor Module (ts-images integration)
+// =============================================================================
 export {
   processImage,
   optimizeImage,
@@ -193,6 +208,9 @@ export {
   clearImageCache,
   ImageProcessorCache,
 } from './image/processor';
+// =============================================================================
+// Video Module
+// =============================================================================
 export {
   renderVideoComponent,
   parseVideoDirectiveOptions,
@@ -200,6 +218,9 @@ export {
   createVideoDirective,
   videoDirective,
 } from './video';
+// =============================================================================
+// Video Processor Module (ts-videos integration)
+// =============================================================================
 export {
   processVideo,
   analyzeVideo,
@@ -213,7 +234,13 @@ export {
   clearVideoCache,
   VideoProcessorCache,
 } from './video/processor';
+// =============================================================================
+// Upload Module
+// =============================================================================
 export { renderMediaUpload } from './upload';
+// =============================================================================
+// Protected Media Module
+// =============================================================================
 export {
   // URL signing
   signUrl,
@@ -243,7 +270,13 @@ export {
   // Runtime
   generateSignatureRuntime,
 } from './protected';
+// =============================================================================
+// Media Manager Module
+// =============================================================================
 export { generateMediaManagerEmbed, generateSimpleMediaPicker } from './manager/embed';
+// =============================================================================
+// Client Runtime Module
+// =============================================================================
 export {
   // Lazy loading
   isNativeLazySupported,
@@ -280,6 +313,9 @@ export {
   generateMediaRuntime,
   generateMinifiedMediaRuntime,
 } from './client';
+// =============================================================================
+// Shared Utilities
+// =============================================================================
 export {
   hashFile,
   hashBuffer,
@@ -292,4 +328,4 @@ export {
   clearCache,
   getCacheStats,
   pruneCache,
-} from './shared';
+} from './shared';

package/dist/media/manager/embed.d.ts

@@ -22,4 +22,4 @@ export declare function generateSimpleMediaPicker(options: {
   accept?: string
   multiple?: boolean
   onSelect?: string
-}): { html: string; script: string; css: string };
+}): { html: string; script: string; css: string };

package/dist/media/protected/component.d.ts

@@ -1,5 +1,4 @@
-import {  } from './signature';
-import type { ProtectedMediaProps,  } from '../types';
+import type { ProtectedMediaProps } from '../types';
 /**
  * Render a protected image component
  *
@@ -31,4 +30,4 @@ export declare function processProtectedMedia(content: string, signatureEndpoint
 /**
  * Parse @protected directive arguments
  */
-export declare function parseProtectedArgs(content: string, params: Record<string, unknown>, context: Record<string, unknown>): ProtectedMediaProps;
+export declare function parseProtectedArgs(content: string, params: Record<string, unknown>, context: Record<string, unknown>): ProtectedMediaProps;

package/dist/media/protected/index.d.ts

@@ -1,3 +1,13 @@
+/**
+ * STX Media - Protected Media Module
+ *
+ * Content protection via signed URLs and authentication.
+ *
+ * @module media/protected
+ */
+// =============================================================================
+// Signature Exports
+// =============================================================================
 export {
   // URL signing
   signUrl,
@@ -21,6 +31,9 @@ export {
   // Runtime
   generateSignatureRuntime,
 } from './signature';
+// =============================================================================
+// Component Exports
+// =============================================================================
 export {
   // Components
   renderProtectedImg,
@@ -31,4 +44,4 @@ export {
 
   // Directive helpers
   parseProtectedArgs,
-} from './component';
+} from './component';

package/dist/media/protected/signature.d.ts

@@ -1,4 +1,4 @@
-import type { BatchSignatureResult, ProtectedAuthContext, SignatureConfig, SignedUrl,  } from '../types';
+import type { BatchSignatureResult, ProtectedAuthContext, SignatureConfig, SignedUrl } from '../types';
 /**
  * Sign a single URL for protected access
  *
@@ -69,4 +69,4 @@ export declare function pruneSignatureCache(): number;
 /**
  * Generate client-side signature handler runtime
  */
-export declare function generateSignatureRuntime(): string;
+export declare function generateSignatureRuntime(): string;

package/dist/media/shared/cache.d.ts

@@ -51,4 +51,4 @@ export declare interface CacheConfig {
   directory: string
   maxAge: number
   maxSize: number
-}
+}

package/dist/media/shared/hash.d.ts

@@ -21,4 +21,4 @@ export declare function getFileMtime(filePath: string): Promise<number>;
 /**
  * Check if file exists
  */
-export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function fileExists(filePath: string): Promise<boolean>;

package/dist/media/shared/index.d.ts

@@ -1,2 +1,7 @@
+/**
+ * STX Media - Shared Utilities
+ *
+ * @module media/shared
+ */
 export * from './hash';
-export * from './cache';
+export * from './cache';