@stacksjs/stx 0.2.154 → 0.2.156

package/dist/story/output.d.ts

@@ -1,3 +1,33 @@
+/**
+ * STX Story - Pretty terminal output
+ * ANSI color codes for terminal styling without external dependencies
+ */
+declare const colors: {
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+};
+declare const styles: {
+    bold: string;
+    dim: string;
+    italic: string;
+    underline: string;
+    inverse: string;
+    strikethrough: string;
+};
 /**
  * Apply color to text
  */
@@ -6,6 +36,18 @@ export declare function color(text: string, colorName: keyof typeof colors): str
  * Apply style to text
  */
 export declare function style(text: string, styleName: keyof typeof styles): string;
+export declare const red: (text: string) => string;
+export declare const green: (text: string) => string;
+export declare const yellow: (text: string) => string;
+export declare const blue: (text: string) => string;
+export declare const magenta: (text: string) => string;
+export declare const cyan: (text: string) => string;
+export declare const white: (text: string) => string;
+export declare const gray: (text: string) => string;
+export declare const bold: (text: string) => string;
+export declare const dim: (text: string) => string;
+export declare const italic: (text: string) => string;
+export declare const underline: (text: string) => string;
 /**
  * Print the STX Story banner
  */
@@ -58,9 +100,9 @@ export declare function clearConsole(): void;
  * Create a spinner
  */
 export declare function createSpinner(text: string): {
-  start: () => void
-  stop: (success?: boolean) => void
-  update: (newText: string) => void
+    start: () => void;
+    stop: (success?: boolean) => void;
+    update: (newText: string) => void;
 };
 /**
  * Format duration in human-readable format
@@ -70,44 +112,4 @@ export declare function formatDuration(ms: number): string;
  * Format file size in human-readable format
  */
 export declare function formatSize(bytes: number): string;
-// Colors
-declare const colors: {
-  black: string;
-  red: string;
-  green: string;
-  yellow: string;
-  blue: string;
-  magenta: string;
-  cyan: string;
-  white: string;
-  gray: string;
-  brightRed: string;
-  brightGreen: string;
-  brightYellow: string;
-  brightBlue: string;
-  brightMagenta: string;
-  brightCyan: string;
-  brightWhite: string
-};
-// Styles
-declare const styles: {
-  bold: string;
-  dim: string;
-  italic: string;
-  underline: string;
-  inverse: string;
-  strikethrough: string
-};
-// Convenience functions
-export declare const red: (text: string) => string;
-export declare const green: (text: string) => string;
-export declare const yellow: (text: string) => string;
-export declare const blue: (text: string) => string;
-export declare const magenta: (text: string) => string;
-export declare const cyan: (text: string) => string;
-export declare const white: (text: string) => string;
-export declare const gray: (text: string) => string;
-export declare const bold: (text: string) => string;
-export declare const dim: (text: string) => string;
-export declare const italic: (text: string) => string;
-export declare const underline: (text: string) => string;
+export {};

package/dist/story/performance.d.ts

@@ -1,19 +1,3 @@
-/**
- * Generate performance panel HTML
- */
-export declare function getPerformancePanelHtml(metrics: ComponentMetrics[]): string;
-/**
- * Generate performance panel styles
- */
-export declare function getPerformancePanelStyles(): string;
-/**
- * Generate performance client script
- */
-export declare function getPerformanceScript(): string;
-/**
- * Global profiler instance
- */
-export declare const profiler: PerformanceProfiler;
 /**
  * STX Story - Component Performance Profiling
  * Track render times, re-render counts, and memory usage
@@ -21,47 +5,125 @@ export declare const profiler: PerformanceProfiler;
 /**
  * Performance metrics for a component
  */
-export declare interface ComponentMetrics {
-  componentId: string
-  componentName: string
-  renderCount: number
-  totalRenderTime: number
-  avgRenderTime: number
-  minRenderTime: number
-  maxRenderTime: number
-  lastRenderTime: number
-  memoryUsage?: number
-  history: RenderRecord[]
+export interface ComponentMetrics {
+    /** Component ID */
+    componentId: string;
+    /** Component name */
+    componentName: string;
+    /** Render count */
+    renderCount: number;
+    /** Total render time in ms */
+    totalRenderTime: number;
+    /** Average render time in ms */
+    avgRenderTime: number;
+    /** Min render time in ms */
+    minRenderTime: number;
+    /** Max render time in ms */
+    maxRenderTime: number;
+    /** Last render time in ms */
+    lastRenderTime: number;
+    /** Memory usage in bytes (if available) */
+    memoryUsage?: number;
+    /** Render history */
+    history: RenderRecord[];
 }
 /**
  * Single render record
  */
-export declare interface RenderRecord {
-  timestamp: number
-  duration: number
-  props?: Record<string, any>
-  memory?: number
+export interface RenderRecord {
+    /** Timestamp */
+    timestamp: number;
+    /** Render duration in ms */
+    duration: number;
+    /** Props that triggered render */
+    props?: Record<string, any>;
+    /** Memory snapshot */
+    memory?: number;
 }
 /**
  * Performance profiler
  */
 export declare class PerformanceProfiler {
-  setEnabled(enabled: boolean): void;
-  recordRender(componentId: string, componentName: string, duration: number, props?: Record<string, any>): void;
-  getMetrics(componentId: string): ComponentMetrics | undefined;
-  getAllMetrics(): ComponentMetrics[];
-  getSlowestComponents(limit?: number): ComponentMetrics[];
-  getMostRenderedComponents(limit?: number): ComponentMetrics[];
-  clear(): void;
-  clearComponent(componentId: string): void;
-  exportMetrics(): string;
-  createTimer(componentId: string, componentName: string): RenderTimer;
+    private metrics;
+    private maxHistorySize;
+    private enabled;
+    /**
+     * Enable/disable profiling
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Record a render
+     */
+    recordRender(componentId: string, componentName: string, duration: number, props?: Record<string, any>): void;
+    /**
+     * Get metrics for a component
+     */
+    getMetrics(componentId: string): ComponentMetrics | undefined;
+    /**
+     * Get all metrics
+     */
+    getAllMetrics(): ComponentMetrics[];
+    /**
+     * Get slowest components
+     */
+    getSlowestComponents(limit?: number): ComponentMetrics[];
+    /**
+     * Get most rendered components
+     */
+    getMostRenderedComponents(limit?: number): ComponentMetrics[];
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    /**
+     * Clear metrics for a component
+     */
+    clearComponent(componentId: string): void;
+    /**
+     * Get memory usage (if available)
+     */
+    private getMemoryUsage;
+    /**
+     * Export metrics as JSON
+     */
+    exportMetrics(): string;
+    /**
+     * Create a render timer
+     */
+    createTimer(componentId: string, componentName: string): RenderTimer;
 }
 /**
  * Render timer helper
  */
 export declare class RenderTimer {
-  constructor(profiler: PerformanceProfiler, componentId: string, componentName: string);
-  setProps(props: Record<string, any>): this;
-  end(): number;
+    private profiler;
+    private componentId;
+    private componentName;
+    private startTime;
+    private props?;
+    constructor(profiler: PerformanceProfiler, componentId: string, componentName: string);
+    /**
+     * Set props for this render
+     */
+    setProps(props: Record<string, any>): this;
+    /**
+     * End timing and record
+     */
+    end(): number;
 }
+/**
+ * Global profiler instance
+ */
+export declare const profiler: PerformanceProfiler;
+/**
+ * Generate performance panel HTML
+ */
+export declare function getPerformancePanelHtml(metrics: ComponentMetrics[]): string;
+/**
+ * Generate performance panel styles
+ */
+export declare function getPerformancePanelStyles(): string;
+/**
+ * Generate performance client script
+ */
+export declare function getPerformanceScript(): string;

package/dist/story/presets.d.ts

@@ -1,57 +1,123 @@
 /**
- * Generate presets panel HTML
- */
-export declare function getPresetsPanelHtml(presets: PropPreset[]): string;
-/**
- * Generate presets panel styles
+ * STX Story - Prop Presets
+ * Save and load prop configurations for quick testing
  */
-export declare function getPresetsPanelStyles(): string;
-/**
- * Generate presets client script
- */
-export declare function getPresetsScript(): string;
 /**
  * Prop preset
  */
-export declare interface PropPreset {
-  id: string
-  name: string
-  description?: string
-  props: Record<string, any>
-  componentId?: string
-  created: number
-  lastUsed?: number
-  usageCount: number
-  tags?: string[]
+export interface PropPreset {
+    /** Preset ID */
+    id: string;
+    /** Preset name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Props values */
+    props: Record<string, any>;
+    /** Component this preset is for */
+    componentId?: string;
+    /** Created timestamp */
+    created: number;
+    /** Last used timestamp */
+    lastUsed?: number;
+    /** Usage count */
+    usageCount: number;
+    /** Tags for organization */
+    tags?: string[];
 }
 /**
  * Presets storage
  */
-export declare interface PresetsStorage {
-  version: number
-  presets: PropPreset[]
-  recentIds: string[]
+export interface PresetsStorage {
+    /** Version for migrations */
+    version: number;
+    /** All presets */
+    presets: PropPreset[];
+    /** Recently used preset IDs */
+    recentIds: string[];
 }
 /**
  * Presets manager
  */
 export declare class PresetsManager {
-  constructor(rootDir: string);
-  save(): Promise<void>;
-  createPreset(name: string, props: Record<string, any>, options?: {
-      description?: string
-      componentId?: string
-      tags?: string[]
+    private storage;
+    private storagePath;
+    private dirty;
+    constructor(rootDir: string);
+    /**
+     * Load storage from disk
+     */
+    private loadStorage;
+    /**
+     * Migrate storage to current version
+     */
+    private migrateStorage;
+    /**
+     * Save storage to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Create a new preset
+     */
+    createPreset(name: string, props: Record<string, any>, options?: {
+        description?: string;
+        componentId?: string;
+        tags?: string[];
     }): PropPreset;
-  getPreset(id: string): PropPreset | undefined;
-  getAllPresets(): PropPreset[];
-  getPresetsForComponent(componentId: string): PropPreset[];
-  getRecentPresets(): PropPreset[];
-  usePreset(id: string): PropPreset | undefined;
-  updatePreset(id: string, updates: Partial<Omit<PropPreset, 'id' | 'created'>>): PropPreset | undefined;
-  deletePreset(id: string): boolean;
-  searchPresets(query: string): PropPreset[];
-  getMostUsedPresets(limit?: number): PropPreset[];
-  exportPresets(ids?: string[]): string;
-  importPresets(json: string, overwrite?: boolean): number;
+    /**
+     * Get a preset by ID
+     */
+    getPreset(id: string): PropPreset | undefined;
+    /**
+     * Get all presets
+     */
+    getAllPresets(): PropPreset[];
+    /**
+     * Get presets for a specific component
+     */
+    getPresetsForComponent(componentId: string): PropPreset[];
+    /**
+     * Get recent presets
+     */
+    getRecentPresets(): PropPreset[];
+    /**
+     * Use a preset (updates usage stats)
+     */
+    usePreset(id: string): PropPreset | undefined;
+    /**
+     * Update a preset
+     */
+    updatePreset(id: string, updates: Partial<Omit<PropPreset, 'id' | 'created'>>): PropPreset | undefined;
+    /**
+     * Delete a preset
+     */
+    deletePreset(id: string): boolean;
+    /**
+     * Search presets
+     */
+    searchPresets(query: string): PropPreset[];
+    /**
+     * Get most used presets
+     */
+    getMostUsedPresets(limit?: number): PropPreset[];
+    /**
+     * Export presets to JSON
+     */
+    exportPresets(ids?: string[]): string;
+    /**
+     * Import presets from JSON
+     */
+    importPresets(json: string, overwrite?: boolean): number;
 }
+/**
+ * Generate presets panel HTML
+ */
+export declare function getPresetsPanelHtml(presets: PropPreset[]): string;
+/**
+ * Generate presets panel styles
+ */
+export declare function getPresetsPanelStyles(): string;
+/**
+ * Generate presets client script
+ */
+export declare function getPresetsScript(): string;

package/dist/story/renderer.d.ts

@@ -1,8 +1,39 @@
+/**
+ * STX Story - Component Renderer
+ * Real component rendering using the STX process module
+ */
 import type { ServerStoryFile, StoryContext } from './types';
+/**
+ * Story render options
+ */
+export interface StoryRenderOptions {
+    /** Props to pass to the component */
+    props?: Record<string, any>;
+    /** Slots content */
+    slots?: Record<string, string>;
+    /** Include global styles */
+    includeStyles?: boolean;
+    /** Include Crosswind CSS */
+    includeCrosswind?: boolean;
+}
+/**
+ * Story render result
+ */
+export interface StoryRenderResult {
+    /** Rendered HTML */
+    html: string;
+    /** CSS extracted from component */
+    css: string;
+    /** JavaScript extracted from component */
+    js: string;
+    /** Errors during rendering */
+    errors: string[];
+    /** Render duration in ms */
+    duration: number;
+}
 /**
  * Render a story component with props
  */
-// eslint-disable-next-line pickier/no-unused-vars
 export declare function renderStoryComponent(ctx: StoryContext, componentPath: string, options?: StoryRenderOptions): Promise<StoryRenderResult>;
 /**
  * Render a story variant
@@ -11,7 +42,6 @@ export declare function renderStoryVariant(ctx: StoryContext, story: ServerStory
 /**
  * Render an inline template string
  */
-// eslint-disable-next-line pickier/no-unused-vars
 export declare function renderInlineTemplate(ctx: StoryContext, template: string, props?: Record<string, any>): Promise<StoryRenderResult>;
 /**
  * Clear the story component cache
@@ -20,7 +50,10 @@ export declare function clearStoryCache(): void;
 /**
  * Get cache statistics
  */
-export declare function getCacheStats(): { size: number, entries: string[] };
+export declare function getCacheStats(): {
+    size: number;
+    entries: string[];
+};
 /**
  * Preload components into cache
  */
@@ -29,27 +62,8 @@ export declare function preloadComponents(paths: string[]): Promise<number>;
  * Generate preview HTML document
  */
 export declare function generatePreviewDocument(result: StoryRenderResult, options?: {
-    title?: string
-    theme?: 'light' | 'dark'
-    background?: string
-    crosswindCss?: string
-  }): string;
-/**
- * Story render options
- */
-export declare interface StoryRenderOptions {
-  props?: Record<string, any>
-  slots?: Record<string, string>
-  includeStyles?: boolean
-  includeCrosswind?: boolean
-}
-/**
- * Story render result
- */
-export declare interface StoryRenderResult {
-  html: string
-  css: string
-  js: string
-  errors: string[]
-  duration: number
-}
+    title?: string;
+    theme?: 'light' | 'dark';
+    background?: string;
+    crosswindCss?: string;
+}): string;

package/dist/story/search.d.ts

@@ -1,4 +1,27 @@
+/**
+ * STX Story - Search functionality
+ * Full-text search across stories and components
+ */
 import type { AnalyzedComponent, StoryContext } from './types';
+/**
+ * Search result item
+ */
+export interface SearchResult {
+    /** Result type */
+    type: 'story' | 'component' | 'prop' | 'slot';
+    /** Display title */
+    title: string;
+    /** Description or context */
+    description?: string;
+    /** Story file ID */
+    storyId: string;
+    /** Variant ID (if applicable) */
+    variantId?: string;
+    /** Match score (higher is better) */
+    score: number;
+    /** Matched text */
+    match: string;
+}
 /**
  * Build search index from story files
  */
@@ -31,15 +54,3 @@ export declare function exportSearchIndex(): string;
  * Import search index from JSON
  */
 export declare function importSearchIndex(json: string): void;
-/**
- * Search result item
- */
-export declare interface SearchResult {
-  type: 'story' | 'component' | 'prop' | 'slot'
-  title: string
-  description?: string
-  storyId: string
-  variantId?: string
-  score: number
-  match: string
-}

package/dist/story/server.d.ts

@@ -1,21 +1,31 @@
-import type { StoryContext } from './types';
 /**
- * Create and start the story server
+ * STX Story - Development server
+ * Serves the story UI and handles API requests with WebSocket HMR
  */
-export declare function createStoryServer(ctx: StoryContext, options: ServerOptions): Promise<StoryServer>;
+import type { StoryContext } from './types';
 /**
  * Server options
  */
-export declare interface ServerOptions {
-  port: number
-  open?: boolean
-  host?: string | boolean
+export interface ServerOptions {
+    /** Port to listen on */
+    port: number;
+    /** Open browser automatically */
+    open?: boolean;
+    /** Host to bind to */
+    host?: string | boolean;
 }
 /**
  * Story server instance
  */
-export declare interface StoryServer {
-  server: ReturnType<typeof Bun.serve>
-  url: string
-  close: () => Promise<void>
+export interface StoryServer {
+    /** Bun server instance */
+    server: ReturnType<typeof Bun.serve>;
+    /** Server URL */
+    url: string;
+    /** Close the server */
+    close: () => Promise<void>;
 }
+/**
+ * Create and start the story server
+ */
+export declare function createStoryServer(ctx: StoryContext, options: ServerOptions): Promise<StoryServer>;

package/dist/story/setup.d.ts

@@ -1,4 +1,27 @@
+/**
+ * STX Story - Setup file support
+ * Handles global story setup configuration
+ */
 import type { StoryContext } from './types';
+/**
+ * Setup function signature
+ */
+export type SetupFunction = (ctx: SetupContext) => void | Promise<void>;
+/**
+ * Context passed to setup function
+ */
+export interface SetupContext {
+    /** Story context */
+    storyContext: StoryContext;
+    /** Register a global component */
+    registerComponent: (name: string, component: any) => void;
+    /** Add global CSS */
+    addCSS: (css: string) => void;
+    /** Add global script */
+    addScript: (script: string) => void;
+    /** Set global state */
+    setState: (key: string, value: any) => void;
+}
 /**
  * Load and execute the setup file
  */
@@ -31,18 +54,3 @@ export declare function resetSetup(): void;
  * Generate HTML for global setup (CSS + scripts)
  */
 export declare function getSetupHTML(): string;
-/**
- * Context passed to setup function
- */
-export declare interface SetupContext {
-  storyContext: StoryContext
-  registerComponent: (name: string, component: any) => void
-  addCSS: (css: string) => void
-  addScript: (script: string) => void
-  setState: (key: string, value: any) => void
-}
-/**
- * Setup function signature
- */
-// eslint-disable-next-line pickier/no-unused-vars
-export type SetupFunction = (ctx: SetupContext) => void | Promise<void>;