@stacksjs/stx 0.2.5 → 0.2.6

package/dist/reactive-bindings.d.ts

@@ -21,4 +21,4 @@ declare interface ProcessedBindings {
   html: string
   bindings: BindingInfo[]
   stores: Set<string>
-}
+}

package/dist/reactive.d.ts

@@ -97,4 +97,4 @@ export declare interface TransitionConfig {
   leaveStart?: string
   leaveEnd?: string
   duration?: number
-}
+}

package/dist/reactivity.d.ts

@@ -163,53 +163,6 @@ export declare function unmountInstance(instance: ComponentInstance): Promise<vo
  * This is injected into the page to enable reactivity.
  */
 export declare function generateClientRuntime(): string;
-/**
- * Vue-Style Reactivity Module
- *
- * Provides Vue 3 Composition API-style reactivity for STX templates.
- * This module is designed to feel familiar to Vue developers while
- * leveraging STX's template processing capabilities.
- *
- * ## Core Primitives
- *
- * - `ref()` - Create a reactive reference
- * - `reactive()` - Create a reactive object
- * - `computed()` - Create a computed value
- * - `watch()` - Watch reactive sources
- * - `watchEffect()` - Auto-track dependencies
- *
- * ## Lifecycle Hooks
- *
- * - `onBeforeMount()` - Before DOM insertion
- * - `onMounted()` - Component in DOM
- * - `onBeforeUpdate()` - Before re-render
- * - `onUpdated()` - After re-render
- * - `onBeforeUnmount()` - Before cleanup
- * - `onUnmounted()` - After cleanup
- *
- * ## Usage
- *
- * ```html
- * <script client>
- *   import { ref, onMounted, watch } from 'stx'
- *
- *   const count = ref(0)
- *   const users = ref([])
- *
- *   onMounted(async () => {
- *     users.value = await fetch('/api/users').then(r => r.json())
- *   })
- *
- *   watch(count, (newVal, oldVal) => {
- *     console.log(`Count changed: ${oldVal} -> ${newVal}`)
- *   })
- * </script>
- *
- * <button @click="count++">Count: {{ count }}</button>
- * ```
- *
- * @module reactivity
- */
 /** Reactive reference wrapper */
 export declare interface Ref<T> {
   value: T
@@ -243,11 +196,14 @@ export declare interface ReactiveScope {
   cleanups: (() => void)[]
 }
 /** Subscriber callback */
-export type WatchCallback<T> = (newValue: T, oldValue: T | undefined) => void
+export type WatchCallback<T> = (newValue: T, oldValue: T | undefined) => void;
 /** Lifecycle hook callback */
-export type LifecycleHook = () => void | Promise<void>
+export type LifecycleHook = () => void | Promise<void>;
+// =============================================================================
+// Exports
+// =============================================================================
 export {
   ref as createRef,
   reactive as createReactive,
   computed as createComputed,
-};
+};

package/dist/release.d.ts

@@ -1 +1 @@
-export declare const gitHash: string;
+export declare const gitHash: string;

package/dist/route-middleware.d.ts

@@ -219,14 +219,14 @@ export declare interface MiddlewareResult {
 /**
  * Middleware execution mode
  */
-export type MiddlewareMode = 'universal' | 'server' | 'client'
+export type MiddlewareMode = 'universal' | 'server' | 'client';
 /**
  * Middleware handler function
  */
 export type RouteMiddlewareHandler = (
   context: MiddlewareContext
-) => void | Promise<void> | NavigationResult | Promise<NavigationResult | void>
+) => void | Promise<void> | NavigationResult | Promise<NavigationResult | void>;
 /**
  * Result from middleware (redirect or abort)
  */
-export type NavigationResult = NavigateToResult | AbortNavigationResult
+export type NavigationResult = NavigateToResult | AbortNavigationResult;

package/dist/router.d.ts

@@ -28,4 +28,4 @@ export declare interface RouteMatch {
 export declare interface RouterOptions {
   pagesDir?: string
   extensions?: string[]
-}
+}

package/dist/routes.d.ts

@@ -13,7 +13,7 @@ export declare function defineRoutes(routeDefinitions: Record<string, string | R
 /**
  * Generate a URL for a named route with parameters
  */
-export declare function route(name: string, params?: Record<string, any>, absolute?: any): string;
+export declare function route(name: string, params?: Record<string, any>, absolute?: boolean): string;
 /**
  * Create a route URL directive processor for stx templates
  */
@@ -26,4 +26,4 @@ declare interface RouteDefinition {
   path: string
   name?: string
   params?: Record<string, any>
-}
+}

package/dist/runtime.d.ts

@@ -25,7 +25,7 @@ export declare function getStoreNames(): string[];
 /**
  * Wait for a store to be ready (for async initialization)
  */
-export declare function waitForStore<T = unknown>(name: string, timeout?: any): Promise<StoreRef<T>>;
+export declare function waitForStore<T = unknown>(name: string, timeout?: number): Promise<StoreRef<T>>;
 /**
  * Get current route parameters
  *
@@ -130,11 +130,11 @@ export declare interface StoreRef<T = unknown> {
 // Route Params
 // =============================================================================
 export declare interface RouteParams {
-
+  [key: string]: string
 }
 // =============================================================================
 // Middleware State
 // =============================================================================
 export declare interface MiddlewareState {
-
-}
+  [key: string]: unknown
+}

package/dist/safe-evaluator.d.ts

@@ -118,13 +118,10 @@ export declare function isForExpressionSafe(expression: string): boolean;
  * @returns A function that executes the loop safely
  */
 export declare function createSafeLoopFunction(loopType: 'for' | 'while', expression: string, body: string, contextKeys: string[], maxIterations?: number): (...args: unknown[]) => string;
-/**
- * Safe expression evaluator that reduces security risks from using new Function()
- */
 /**
  * Safe evaluator configuration options
  */
 export declare interface SafeEvaluatorConfig {
   maxSanitizeDepth: number
   allowBracketNotation: boolean
-}
+}

package/dist/scaffolding.d.ts

@@ -110,4 +110,4 @@ export declare interface ScaffoldResult {
 /**
  * Project template options
  */
-export type ProjectTemplate = 'default' | 'minimal' | 'full' | 'blog' | 'dashboard' | 'landing'
+export type ProjectTemplate = 'default' | 'minimal' | 'full' | 'blog' | 'dashboard' | 'landing';

package/dist/seo.d.ts

@@ -105,10 +105,6 @@ export declare const metaDirective: CustomDirective;
  * SEO structured data directive for JSON-LD generation
  */
 export declare const structuredDataDirective: CustomDirective;
-declare interface StructuredData {
-  '@context': string
-  '@type': string
-}
 /**
  * URL entry for sitemap
  */
@@ -143,4 +139,4 @@ export declare interface RobotsOptions {
   rules: RobotsRule[]
   sitemap?: string | string[]
   host?: string
-}
+}

package/dist/serve.d.ts

@@ -32,4 +32,4 @@ export declare interface ServeResult {
   server: Server<any>
   stop: () => void
   url: string
-}
+}

package/dist/server-components.d.ts

@@ -131,4 +131,4 @@ declare interface SuspenseState {
   promise?: Promise<unknown>
   result?: string
   error?: Error
-}
+}

package/dist/signals.d.ts

@@ -274,169 +274,6 @@ export declare function generateSignalsRuntime(): string;
  * @returns Human-readable JavaScript runtime code
  */
 export declare function generateSignalsRuntimeDev(): string;
-/**
- * STX Signals - Reactive State Management
- * =========================================
- *
- * A simple, intuitive reactivity system for STX templates.
- * Signals provide fine-grained reactivity with automatic dependency tracking
- * and seamless template integration.
- *
- * ## Why Signals?
- *
- * - **No `.value` needed** - Read with `count()`, write with `count.set(5)`
- * - **Automatic tracking** - Dependencies are tracked automatically in effects
- * - **Fine-grained updates** - Only affected DOM nodes update, not the whole component
- * - **Simple API** - Just `state`, `derived`, and `effect`
- * - **Seamless syntax** - Same `@if`, `@for` directives work on server and client
- *
- * ## Quick Start
- *
- * ```html
- * <script>
- *   const count = state(0)
- *   const items = state(['Apple', 'Banana', 'Cherry'])
- *   const showList = state(true)
- *
- *   function increment() {
- *     count.update(n => n + 1)
- *   }
- *
- *   function addItem() {
- *     items.update(list => [...list, 'New Item'])
- *   }
- * </script>
- *
- * <button @click="increment">Count: {{ count }}</button>
- *
- * <button @click="showList.set(!showList())">Toggle List</button>
- *
- * @if="showList()"
- *   <ul>
- *     <li @for="item in items()">{{ item }}</li>
- *   </ul>
- * @endif
- *
- * <button @click="addItem">Add Item</button>
- * ```
- *
- * ## Core Concepts
- *
- * ### State
- * A state signal holds a reactive value. Read it by calling it as a function,
- * write it using `.set()` or `.update()`.
- *
- * ```typescript
- * const count = state(0)        // Create with initial value
- * console.log(count())          // Read: 0
- * count.set(5)                  // Write: set to 5
- * count.update(n => n + 1)      // Update: increment by 1
- * ```
- *
- * ### Derived
- * A derived signal computes its value from other signals. It automatically
- * updates when its dependencies change.
- *
- * ```typescript
- * const firstName = state('John')
- * const lastName = state('Doe')
- * const fullName = derived(() => `${firstName()} ${lastName()}`)
- *
- * console.log(fullName()) // "John Doe"
- * firstName.set('Jane')
- * console.log(fullName()) // "Jane Doe"
- * ```
- *
- * ### Effect
- * Effects run side effects when their dependencies change. They're perfect
- * for logging, API calls, or DOM manipulation.
- *
- * ```typescript
- * const searchQuery = state('')
- *
- * effect(() => {
- *   // This runs whenever searchQuery changes
- *   fetchResults(searchQuery())
- * })
- * ```
- *
- * ## Template Syntax (all use @ prefix)
- *
- * All directives work seamlessly on both server-side and client-side.
- * Server-side directives are processed at build time. Reactive directives
- * (those using signals) are handled by the client runtime.
- *
- * ### Text Interpolation
- * ```html
- * <p>{{ message }}</p>
- * <p>{{ user.name }}</p>
- * <p>{{ items().length }} items</p>
- * ```
- *
- * ### Conditional Rendering
- * ```html
- * <div @if="isVisible()">Shown when true</div>
- * <div @if="user()">Welcome, {{ user().name }}</div>
- * ```
- *
- * ### List Rendering
- * ```html
- * <ul>
- *   <li @for="item in items()">{{ item.name }}</li>
- * </ul>
- *
- * <div @for="item, index in items()">
- *   {{ index }}: {{ item }}
- * </div>
- * ```
- *
- * ### Visibility Toggle
- * ```html
- * <!-- @show keeps element in DOM but toggles display -->
- * <p @show="hasContent()">Toggles visibility</p>
- * ```
- *
- * ### Attribute Binding
- * ```html
- * <img @bind:src="imageUrl()" @bind:alt="imageAlt()">
- * <button @bind:disabled="isLoading()">Submit</button>
- * <div @class="{ active: isActive(), hidden: !visible() }">
- * ```
- *
- * ### Event Handling
- * ```html
- * <button @click="handleClick">Click me</button>
- * <input @input="updateValue" @keydown.enter="submit">
- * <form @submit.prevent="handleSubmit">
- * ```
- *
- * ### Two-Way Binding
- * ```html
- * <input @model="username">
- * <textarea @model="message"></textarea>
- * <select @model="selectedOption">
- * ```
- *
- * ### Text and HTML Content
- * ```html
- * <span @text="message()"></span>
- * <div @html="richContent()"></div>
- * ```
- *
- * ## Lifecycle Hooks
- *
- * ```typescript
- * onMount(() => {
- *   console.log('Component mounted')
- * })
- *
- * onDestroy(() => {
- *   console.log('Component destroyed')
- * })
- * ```
- *
- * @module signals
- */
 /**
  * A reactive state signal.
  *
@@ -455,7 +292,7 @@ export declare interface Signal<T> {
   set(value: T): void
   update(fn: (current: T) => T): void
   subscribe(callback: (value: T, prev: T) => void): () => void
-  _isSignal: true
+  readonly _isSignal: true
 }
 /**
  * A derived (computed) signal that automatically updates when dependencies change.
@@ -468,7 +305,7 @@ export declare interface Signal<T> {
  */
 export declare interface DerivedSignal<T> {
   (): T
-  _isDerived: true
+  readonly _isDerived: true
 }
 /**
  * Options for creating effects.
@@ -480,11 +317,14 @@ export declare interface EffectOptions {
 /**
  * Cleanup function returned by effects.
  */
-export type CleanupFn = () => void
+export type CleanupFn = () => void;
 /**
  * Lifecycle hook callback.
  */
-export type LifecycleCallback = () => void | CleanupFn | Promise<void>
+export type LifecycleCallback = () => void | CleanupFn | Promise<void>;
+// =============================================================================
+// Default Export
+// =============================================================================
 export default {
   state,
   derived,
@@ -498,4 +338,4 @@ export default {
   peek,
   generateSignalsRuntime,
   generateSignalsRuntimeDev
-};
+};

package/dist/slots.d.ts

@@ -55,9 +55,9 @@ export declare interface SlotDefinition {
   propsBinding?: string
 }
 export declare interface SlotProps {
-
+  [key: string]: unknown
 }
 export declare interface ParsedSlots {
   default: string
   named: Map<string, SlotDefinition>
-}
+}

package/dist/source-maps.d.ts

@@ -51,18 +51,11 @@ export declare interface SourceMapV3 {
  * Source map generator for stx templates
  */
 export declare class SourceMapGenerator {
-  private file: string;
-  private sourceRoot?: string;
-  private sources: string[];
-  private sourcesContent: Map<string, string>;
-  private names: string[];
-  private mappings: Mapping[];
   constructor(file: string, sourceRoot?: string);
   addSource(path: string, content?: string): number;
   addName(name: string): number;
   addMapping(mapping: Mapping): void;
   addMappingRange(generatedStart: Position, source: string, originalStart: Position, lineCount: number): void;
-  private generateMappings(): string;
   toJSON(): SourceMapV3;
   toString(): string;
   toDataURL(): string;
@@ -74,17 +67,7 @@ export declare class SourceMapGenerator {
  * Source map consumer for parsing and querying source maps
  */
 export declare class SourceMapConsumer {
-  private sourceMap: SourceMapV3;
-  private decodedMappings: Array<{
-    generatedLine: number
-    generatedColumn: number
-    sourceIndex: number
-    originalLine: number
-    originalColumn: number
-    nameIndex: number
-  }>;
   constructor(sourceMap: SourceMapV3 | string);
-  private decodeMappings(): void;
   originalPositionFor(generated: Position): {
     source: string | null
     line: number | null
@@ -96,15 +79,13 @@ export declare class SourceMapConsumer {
     column: number | null
   };
   sourceContentFor(source: string): string | null;
+  get sources(): string[];
+  get rawSourceMap(): SourceMapV3;
 }
 /**
  * Tracks positions during template transformation for source map generation
  */
 export declare class TemplateTracker {
-  private generator: SourceMapGenerator;
-  private currentGeneratedLine: any;
-  private currentGeneratedColumn: any;
-  private sourceFile: string;
   constructor(outputFile: string, sourceFile: string, sourceContent?: string);
   trackReplacement(originalLine: number, originalColumn: number, generatedContent: string): void;
   trackInclude(includeFile: string, includeContent: string, generatedContent: string): void;
@@ -114,4 +95,4 @@ export declare class TemplateTracker {
   getGenerator(): SourceMapGenerator;
   toJSON(): SourceMapV3;
   toInlineComment(): string;
-}
+}

package/dist/spa-shell.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generate a client-side SPA shell that wraps the raw template
+ * for client-side rendering.
+ */
+export declare function generateSpaShell(options: SpaShellOptions): string;
+/**
+ * SPA Shell Generator
+ *
+ * When `ssr: false` is set in the config, templates are not processed
+ * server-side. Instead, a client-side shell is served that contains:
+ * - A mount point for the application
+ * - The raw template in a <template> tag
+ * - Serialized context data for client-side hydration
+ * - A bootstrap script that initializes the signals runtime
+ */
+export declare interface SpaShellOptions {
+  template: string
+  context?: Record<string, unknown>
+  title?: string
+}

package/dist/ssg.d.ts

@@ -126,9 +126,6 @@ export declare interface CachedPage {
   headers?: Record<string, string>
 }
 declare class BuildCache {
-  private cacheDir: string;
-  private cache: Map<string, BuildCacheEntry>;
-  private loaded: any;
   constructor(cacheDir: string);
   load(): Promise<void>;
   save(): Promise<void>;
@@ -140,18 +137,19 @@ declare class BuildCache {
 // ISR Cache Implementation
 // =============================================================================
 declare class FileISRCache implements ISRCache {
-  private cacheDir: string;
   constructor(cacheDir: string);
-  private getFilePath(route: string): string;
   get(route: string): Promise<CachedPage | null>;
   set(route: string, page: CachedPage): Promise<void>;
   invalidate(route: string): Promise<void>;
   invalidatePattern(pattern: RegExp): Promise<void>;
   needsRevalidation(route: string): Promise<boolean>;
 }
+// =============================================================================
+// Exports
+// =============================================================================
 export default {
   generateStaticSite,
   createISRHandler,
   defineStaticPaths,
   createMarkdownLoader,
-};
+};