@stacksjs/stx 0.2.4 → 0.2.6

package/dist/story/props-validation.d.ts

@@ -42,4 +42,14 @@ export declare interface ValidationError {
 export declare interface ValidationWarning {
   prop: string
   message: string
-}
+}
+declare type  = : string,
+  options?: string[],
+): string | null {
+  // Handle null/undefined
+  if (value === null || value === undefined) {
+    if (type.includes('null') || type.includes('undefined') || type.includes('?')) {
+      return null
+    }
+    return `Expected ${type}, got ${value === null ? 'null' : 'undefined'}`
+  }

package/dist/story/renderer.d.ts

@@ -50,4 +50,4 @@ export declare interface StoryRenderResult {
   js: string
   errors: string[]
   duration: number
-}
+}

package/dist/story/search-index.d.ts

@@ -23,7 +23,7 @@ export declare function searchIndex(index: PersistedSearchIndex, query: string):
 /**
  * Get or build search index
  */
-export declare function getOrBuildSearchIndex(ctx: StoryContext, storyFiles: ServerStoryFile[], components: Map<string, AnalyzedComponent>, forceRebuild?: any): Promise<SearchIndexEntry[]>;
+export declare function getOrBuildSearchIndex(ctx: StoryContext, storyFiles: ServerStoryFile[], components: Map<string, AnalyzedComponent>, forceRebuild?: boolean): Promise<SearchIndexEntry[]>;
 /**
  * Search index entry
  */
@@ -44,4 +44,4 @@ export declare interface PersistedSearchIndex {
   created: number
   updated: number
   entries: SearchIndexEntry[]
-}
+}

package/dist/story/search.d.ts

@@ -10,7 +10,7 @@ export declare function buildComponentSearchIndex(components: AnalyzedComponent[
 /**
  * Search the index
  */
-export declare function search(query: string, limit?: any): SearchResult[];
+export declare function search(query: string, limit?: number): SearchResult[];
 /**
  * Get recent searches from localStorage (client-side)
  */
@@ -42,4 +42,4 @@ export declare interface SearchResult {
   variantId?: string
   score: number
   match: string
-}
+}

package/dist/story/server.d.ts

@@ -18,4 +18,4 @@ export declare interface StoryServer {
   server: ReturnType<typeof Bun.serve>
   url: string
   close: () => Promise<void>
-}
+}

package/dist/story/setup.d.ts

@@ -44,4 +44,4 @@ export declare interface SetupContext {
 /**
  * Setup function signature
  */
-export type SetupFunction = (ctx: SetupContext) => void | Promise<void>
+export type SetupFunction = (ctx: SetupContext) => void | Promise<void>;

package/dist/story/snapshots.d.ts

@@ -62,4 +62,4 @@ export declare interface DiffResult {
   diffImagePath?: string
   changedPixels: number
   totalPixels: number
-}
+}

package/dist/story/testing.d.ts

@@ -55,4 +55,4 @@ export declare interface SnapshotMeta {
   component: string
   timestamp: number
   hash: string
-}
+}

package/dist/story/theme.d.ts

@@ -65,4 +65,4 @@ export declare interface ThemeConfig {
   fontFamily: string
   codeFontFamily: string
   borderRadius: string
-}
+}

package/dist/story/types.d.ts

@@ -1,7 +1,3 @@
-/**
- * STX Story - Component showcase and testing
- * Type definitions for the story feature
- */
 /**
  * Tree group configuration for organizing stories
  */
@@ -32,18 +28,13 @@ export declare interface BackgroundPreset {
 export declare interface StoryThemeConfig {
   title?: string
   logo?: {
-    /** Square logo (for favicon/small displays) */
     square?: string
-    /** Light theme logo */
     light?: string
-    /** Dark theme logo */
     dark?: string
   }
   favicon?: string
   colors?: {
-    /** Primary accent color shades */
     primary?: Record<string, string>
-    /** Gray color shades */
     gray?: Record<string, string>
   }
   defaultColorScheme?: 'light' | 'dark' | 'auto'
@@ -228,11 +219,11 @@ export type StoryLayout = | { type: 'single', iframe?: boolean }
 /**
  * Any tree node type
  */
-export type ServerTreeNode = ServerTreeGroup | ServerTreeFolder | ServerTreeLeaf
+export type ServerTreeNode = ServerTreeGroup | ServerTreeFolder | ServerTreeLeaf;
 /**
  * Complete server tree
  */
-export type ServerTree = ServerTreeNode[]
+export type ServerTree = ServerTreeNode[];
 /**
  * Control type for prop editing
  */
@@ -246,4 +237,4 @@ export type ControlType = | 'text'
   | 'json'
   | 'textarea'
   | 'slider'
-  | 'buttongroup'
+  | 'buttongroup';

package/dist/story/ui/code-panel.d.ts

@@ -39,4 +39,4 @@ export declare function getOpenInVSCodeScript(filePath: string): string;
 /**
  * Code panel tabs
  */
-export type CodePanelTab = 'source' | 'story' | 'compiled' | 'props'
+export type CodePanelTab = 'source' | 'story' | 'compiled' | 'props';

package/dist/story/ui/controls-panel.d.ts

@@ -22,4 +22,4 @@ export declare interface ControlsPanelState {
   collapsed: boolean
   values: Record<string, any>
   filter: string
-}
+}

package/dist/story/ui/index.d.ts

@@ -1,4 +1,8 @@
+/**
+ * STX Story - UI Components
+ * All UI-related exports
+ */
 export * from './code-panel';
 export * from './controls-panel';
 export * from './navigation';
-export * from './preview';
+export * from './preview';

package/dist/story/ui/navigation.d.ts

@@ -52,4 +52,4 @@ export declare interface NavigationState {
   maxRecent: number
   searchQuery: string
   focusedIndex: number
-}
+}

package/dist/story/ui/preview.d.ts

@@ -43,4 +43,4 @@ export declare interface PreviewState {
   showRuler: boolean
   showOutline: boolean
   props: Record<string, any>
-}
+}

package/dist/story/visual-testing.d.ts

@@ -42,4 +42,4 @@ export declare interface VisualTestFailure {
   actualPath?: string
   diffPath?: string
   diffPercentage?: number
-}
+}

package/dist/streaming.d.ts

@@ -28,57 +28,6 @@ export declare function streamTemplateSimple(templatePath: string, data?: Record
  * @param options stx options
  */
 export declare function createStreamRenderer(templatePath: string, options?: StxOptions): Promise<StreamRenderer>;
-/**
- * Register streaming and hydration directives
- */
-export declare function registerStreamingDirectives(options?: StxOptions): CustomDirective[];
-/**
- * Process section directives
- * @param content Template content
- * @param context Data context
- * @param filePath Template file path
- * @param _options stx options
- */
-export declare function processSectionDirectives(content: string, context: Record<string, any>, filePath: string, _options?: StxOptions): Promise<string>;
-/**
- * Wrap a ReadableStream<string> in a proper Response with chunked transfer encoding headers.
- *
- * Makes it trivial to use streaming from a Bun server handler:
- *
- * @example
- * ```typescript
- * const server = Bun.serve({
- *   async fetch(req) {
- *     const stream = await streamTemplate('index.stx', { title: 'Home' })
- *     return streamToResponse(stream)
- *   }
- * })
- * ```
- *
- * @param stream - The template ReadableStream
- * @param init - Optional additional ResponseInit (headers, status, etc.)
- * @returns A Response with proper streaming headers
- */
-export declare function streamToResponse(stream: ReadableStream<string>, init?: ResponseInit): Response;
-/**
- * Generate client-side hydration runtime script.
- *
- * This script handles:
- * - Finding islands in the DOM
- * - Loading island components based on priority
- * - Hydrating islands with their props
- *
- * Usage: Include the generated script in your page, then call
- * `window.__stx.hydrate()` when ready.
- *
- * @example
- * ```html
- * <script>
- *   {{ generateHydrationRuntime({ mode: 'full' }) }}
- * </script>
- * ```
- */
-export declare function generateHydrationRuntime(config?: HydrationRuntimeConfig): string;
 /**
  * Custom directive for marking suspense boundaries in streaming templates.
  *
@@ -100,11 +49,3 @@ export declare const streamingSuspenseDirective: CustomDirective;
  * Custom directive for creating islands (for partial hydration)
  */
 export declare const islandDirective: CustomDirective;
-/**
- * Configuration for hydration runtime generation
- */
-export declare interface HydrationRuntimeConfig {
-  mode: 'full' | 'loader'
-  components?: Record<string, string>
-  dynamicImports?: boolean
-}

package/dist/suspense.d.ts

@@ -80,4 +80,4 @@ export declare interface SSRSuspenseBoundary {
   id: string
   fallback: string
   content: Promise<string>
-}
+}

package/dist/teleport.d.ts

@@ -6,4 +6,4 @@ export declare function processTeleportDirectives(template: string, context: Rec
  * Ensure teleport targets exist in the document
  * Call this to create common teleport targets if they don't exist
  */
-export declare function ensureTeleportTargets(): string;
+export declare function ensureTeleportTargets(): string;

package/dist/testing.d.ts

@@ -86,116 +86,98 @@ export declare function createTestContext(options?: {
 export declare function cleanup(): void;
 /**
  * Fire events on elements.
+ * @defaultValue
+ * ```ts
+ * {
+ *   async click: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *     options?: MouseEventInit,
+ *   ) => unknown,
+ *   async dblClick: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *     options?: MouseEventInit,
+ *   ) => unknown,
+ *   async input: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *     value: string,
+ *   ) => unknown,
+ *   async change: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *     value?: string,
+ *   ) => unknown,
+ *   async submit: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *   ) => unknown,
+ *   async focus: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *   ) => unknown,
+ *   async blur: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *   ) => unknown,
+ *   async keyDown: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *     key: string,
+ *     options?: KeyboardEventInit,
+ *   ) => unknown,
+ *   async keyUp: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *     key: string,
+ *     options?: KeyboardEventInit,
+ *   ) => unknown,
+ *   async custom: (
+ *     target: HTMLElement | ElementWrapper | ComponentWrapper | null,
+ *     eventName: string,
+ *     options?: FireEventOptions,
+ *   ) => unknown
+ * }
+ * ```
  */
 export declare const fireEvent: {
   /**
    * Fire a click event.
    */
-  async click(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-    options?: MouseEventInit,
-  ): unknown;
+  async click: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, options?: MouseEventInit, ) => unknown;
   /**
    * Fire a double click event.
    */
-  async dblClick(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-    options?: MouseEventInit,
-  ): unknown;
+  async dblClick: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, options?: MouseEventInit, ) => unknown;
   /**
    * Fire an input event.
    */
-  async input(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-    value: string,
-  ): unknown;
+  async input: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, value: string, ) => unknown;
   /**
    * Fire a change event.
    */
-  async change(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-    value?: string,
-  ): unknown;
+  async change: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, value?: string, ) => unknown;
   /**
    * Fire a submit event.
    */
-  async submit(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-  ): unknown;
+  async submit: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, ) => unknown;
   /**
    * Fire a focus event.
    */
-  async focus(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-  ): unknown;
+  async focus: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, ) => unknown;
   /**
    * Fire a blur event.
    */
-  async blur(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-  ): unknown;
+  async blur: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, ) => unknown;
   /**
    * Fire a keydown event.
    */
-  async keyDown(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-    key: string,
-    options?: KeyboardEventInit,
-  ): unknown;
+  async keyDown: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, key: string, options?: KeyboardEventInit, ) => unknown;
   /**
    * Fire a keyup event.
    */
-  async keyUp(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-    key: string,
-    options?: KeyboardEventInit,
-  ): unknown;
+  async keyUp: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, key: string, options?: KeyboardEventInit, ) => unknown;
   /**
    * Fire a custom event.
    */
-  async custom(
-    target: HTMLElement | ElementWrapper | ComponentWrapper | null,
-    eventName: string,
-    options?: FireEventOptions,
-  ): unknown
+  async custom: ( target: HTMLElement | ElementWrapper | ComponentWrapper | null, eventName: string, options?: FireEventOptions, ) => unknown
 };
 /**
  * Create custom matchers for testing.
  */
-export declare const matchers: {
-  /**
-   * Check if wrapper contains text.
-   */
-  toContainText(wrapper: ComponentWrapper | ElementWrapper, text: string): unknown;
-  /**
-   * Check if wrapper has class.
-   */
-  toHaveClass(wrapper: ComponentWrapper | ElementWrapper, className: string): unknown;
-  /**
-   * Check if wrapper has attribute.
-   */
-  toHaveAttribute(
-    wrapper: ComponentWrapper | ElementWrapper,
-    name: string,
-    value?: string,
-  ): unknown;
-  /**
-   * Check if wrapper is visible.
-   */
-  toBeVisible(wrapper: ComponentWrapper | ElementWrapper): unknown;
-  /**
-   * Check if wrapper exists.
-   */
-  toExist(wrapper: ComponentWrapper | ElementWrapper | null): unknown;
-  /**
-   * Check if event was emitted.
-   */
-  toHaveEmitted(wrapper: ComponentWrapper, event: string, times?: number): unknown;
-  /**
-   * Check if event was emitted with payload.
-   */
-  toHaveEmittedWith(wrapper: ComponentWrapper, event: string, payload: unknown): (boolean { const emitted?) if (!emitted) return false return emitted.some((args)) => unknown
-};
+export declare const toHaveEmittedWith: unknown;
 /** Mount options */
 export declare interface MountOptions {
   props?: Record<string, unknown>
@@ -220,8 +202,8 @@ export declare interface ComponentWrapper {
   element: HTMLElement
   html(): string
   text(): string
-  find(selector: string): ElementWrapper<T> | null
-  findAll(selector: string): ElementWrapper<T>[]
+  find<T extends HTMLElement = HTMLElement>(selector: string): ElementWrapper<T> | null
+  findAll<T extends HTMLElement = HTMLElement>(selector: string): ElementWrapper<T>[]
   findComponent(name: string): ComponentWrapper | null
   findAllComponents(name: string): ComponentWrapper[]
   exists(): boolean
@@ -231,7 +213,7 @@ export declare interface ComponentWrapper {
   classes(): string[]
   classes(name: string): boolean
   props(): Record<string, unknown>
-  props(name: string): T | undefined
+  props<T = unknown>(name: string): T | undefined
   emitted(): Record<string, unknown[][]>
   emitted(event: string): unknown[][] | undefined
   setProps(props: Record<string, unknown>): Promise<void>
@@ -249,8 +231,8 @@ export declare interface ElementWrapper<T extends HTMLElement = HTMLElement> {
   element: T
   html(): string
   text(): string
-  find(selector: string): ElementWrapper<E> | null
-  findAll(selector: string): ElementWrapper<E>[]
+  find<E extends HTMLElement = HTMLElement>(selector: string): ElementWrapper<E> | null
+  findAll<E extends HTMLElement = HTMLElement>(selector: string): ElementWrapper<E>[]
   exists(): boolean
   isVisible(): boolean
   attributes(): Record<string, string>
@@ -286,4 +268,4 @@ export declare interface MockStore<T extends Record<string, unknown>> {
   reset(): void
   getHistory(): T[]
   subscribe(listener: (state: T) => void): () => void
-}
+}

package/dist/transitions.d.ts

@@ -84,4 +84,4 @@ export declare interface TransitionState {
   isEntering: boolean
   isLeaving: boolean
   isCancelled: boolean
-}
+}

package/dist/type-checker.d.ts

@@ -72,38 +72,14 @@ export type PrimitiveType = | 'string'
   | 'any'
   | 'unknown'
   | 'void'
-  | 'never'
+  | 'never';
 /**
  * Template Type Checker class
  */
 export declare class TemplateTypeChecker {
-  private options: TypeCheckerOptions;
-  private variables: Map<string, TypeDefinition>;
-  private errors: TypeCheckError[];
-  private warnings: TypeCheckError[];
-  private currentFile: string;
   constructor(options?: TypeCheckerOptions);
   checkFile(filePath: string): TypeCheckResult;
   checkTemplate(template: string, filePath?: string): TypeCheckResult;
-  private analyzeScript(script: string, scriptOffset: number): void;
-  private extractTypedVariables(line: string, lineNum: number): void;
-  private extractInterfaces(line: string, lines: string[], index: number, lineNum: number): void;
-  private extractTypeAliases(line: string, lineNum: number): void;
-  private parseTypeAnnotation(annotation: string): TypeDefinition;
-  private inferType(value: string): TypeDefinition;
-  private parseParams(paramsStr: string): Array<{ name: string, type: TypeDefinition, optional?: boolean }>;
-  private checkExpressions(template: string): void;
-  private checkExpression(expression: string, line: number, column: number): void;
-  private checkDirectives(template: string): void;
-  private resolvePropertyAccess(expr: string): TypeDefinition;
-  private isLiteral(expr: string): boolean;
-  private extractObjectLiteral(expr: string): Record<string, string>;
-  private splitByComma(str: string): string[];
-  private getLineNumber(position: number, template?: string): number;
-  private getColumn(position: number, template: string): number;
-  private addError(message: string, line: number, column: number, expression: string, expected?: string, received?: string): void;
-  private addWarning(message: string, line: number, column: number, expression: string, expected?: string, received?: string): void;
-  private getResult(): TypeCheckResult;
   addVariable(name: string, type: TypeDefinition): void;
   reset(): void;
-}
+}

package/dist/types/component-types.d.ts

@@ -20,7 +20,7 @@ export declare interface PropDefinition {
  * ```
  */
 export declare interface ComponentPropsSchema {
-
+  [propName: string]: PropDefinition
 }
 /**
  * Component definition with metadata
@@ -122,8 +122,8 @@ export declare interface DocGeneratorConfig {
 /**
  * Prop type definition for component prop validation
  */
-export type PropType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'function' | 'any'
+export type PropType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'function' | 'any';
 /**
  * Documentation format options
  */
-export type DocFormat = 'markdown' | 'html' | 'json'
+export type DocFormat = 'markdown' | 'html' | 'json';

package/dist/types/config-types.d.ts

@@ -118,57 +118,35 @@ export declare interface AnalyticsConfig {
   enabled: boolean
   driver: AnalyticsDriver
   fathom?: {
-    /** Fathom site ID */
     siteId: string
-    /** Custom script URL (default: https://cdn.usefathom.com/script.js) */
     scriptUrl?: string
-    /** Honor Do Not Track browser setting */
     honorDnt?: boolean
-    /** Defer script loading (default: true) */
     defer?: boolean
-    /** Enable SPA mode for client-side routing */
     spa?: boolean
-    /** Canonical URL override */
     canonical?: string
-    /** Auto-track page views (default: true) */
     auto?: boolean
   }
   googleAnalytics?: {
-    /** GA4 Measurement ID (e.g., G-XXXXXXXXXX) */
     measurementId: string
-    /** Enable debug mode */
     debug?: boolean
   }
   plausible?: {
-    /** Your domain (e.g., example.com) */
     domain: string
-    /** Custom script URL (default: https://plausible.io/js/script.js) */
     scriptUrl?: string
-    /** Track localhost */
     trackLocalhost?: boolean
-    /** Enable hash-based routing */
     hashMode?: boolean
   }
   selfHosted?: {
-    /** Site ID for tracking */
     siteId: string
-    /** API endpoint URL for collecting analytics */
     apiEndpoint: string
-    /** Honor Do Not Track browser setting */
     honorDnt?: boolean
-    /** Track hash changes as page views */
     trackHashChanges?: boolean
-    /** Track outbound link clicks */
     trackOutboundLinks?: boolean
   }
   custom?: {
-    /** Custom script URL */
     scriptUrl: string
-    /** Script ID attribute */
     scriptId?: string
-    /** Additional script attributes */
     attributes?: Record<string, string>
-    /** Inline script content (instead of external URL) */
     inlineScript?: string
   }
 }
@@ -221,18 +199,23 @@ export declare interface MarkdownConfig {
  */
 export declare interface FormConfig {
   classes?: {
-    /** Class for text inputs, textareas, and selects */
     input?: string
-    /** Class added to inputs with validation errors */
     inputError?: string
-    /** Class for checkboxes and radios */
     checkInput?: string
-    /** Class for labels */
     label?: string
-    /** Class for error message containers */
     errorFeedback?: string
   }
 }
+/**
+ * Strict mode configuration for DOM API validation.
+ * When enabled, stx warns (or errors) when client scripts use raw browser APIs
+ * instead of framework composables.
+ */
+export declare interface StrictModeConfig {
+  enabled: boolean
+  failOnViolation?: boolean
+  allowPatterns?: string[]
+}
 /**
  * stx configuration options
  */
@@ -241,6 +224,7 @@ export declare interface StxConfig {
   defaultTitle?: string
   defaultDescription?: string
   defaultImage?: string
+  ssr?: boolean
   cache?: boolean
   cacheDir?: string
   cacheVersion?: string
@@ -276,6 +260,7 @@ export declare interface StxConfig {
   heatmap?: Partial<HeatmapConfig>
   build?: Partial<BuildConfig>
   media?: Partial<MediaConfig>
+  strict?: boolean | StrictModeConfig
 }
 /**
  * SSG Build configuration for static site generation
@@ -300,7 +285,7 @@ export declare interface BuildConfig {
 /**
  * Analytics driver type
  */
-export type AnalyticsDriver = 'fathom' | 'google-analytics' | 'plausible' | 'self-hosted' | 'custom'
+export type AnalyticsDriver = 'fathom' | 'google-analytics' | 'plausible' | 'self-hosted' | 'custom';
 /**
  * Available syntax highlighting themes
  */
@@ -332,5 +317,5 @@ export type SyntaxHighlightTheme = | 'css-variables'
   | 'solarized-dark'
   | 'solarized-light'
   | 'vitesse-dark'
-  | 'vitesse-light'
-export type StxOptions = Partial<StxConfig>
+  | 'vitesse-light';
+export type StxOptions = Partial<StxConfig>;