@stacksjs/stx 0.2.21 → 0.2.26

package/dist/component-renderer.d.ts

@@ -1,18 +1 @@
-import type { StxOptions } from './types';
-/**
- * Unified component processing entry point.
- *
- * Processes all component-related syntax in the template in the correct order:
- * 1. Register builtin components (once)
- * 2. Process `@import` directives
- * 3. Process `@component` directives
- * 4. Process custom element tags (builtins and file-based)
- *
- * @param template - The template string to process
- * @param context - Template variable context
- * @param filePath - Absolute path of the template being processed
- * @param options - Compiler options
- * @param dependencies - Set to track file dependencies for cache invalidation
- * @returns The processed template with all components rendered
- */
-export declare function processComponents(template: string, context: Record<string, any>, filePath: string, options: StxOptions, dependencies: Set<string>): Promise<string>;
+

package/dist/composables/use-fetch.d.ts

@@ -1,32 +1,3 @@
-/**
- * Reactive fetch with loading/error states
- */
-export declare function useFetch<T = unknown>(url: string | (() => string), options?: FetchOptions<T>): FetchRef<T>;
-/**
- * Generic async data fetcher
- */
-export declare function useAsyncData<T>(fetcher: () => Promise<T>, options?: {
-    immediate?: boolean
-    transform?: (data: T) => T
-    default?: T
-    key?: string
-    cacheTime?: number
-  }): FetchRef<T>;
-/**
- * POST request helper
- */
-export declare function usePost<T = unknown, B = unknown>(url: string, options?: Omit<FetchOptions<T>, 'method' | 'body'>): {
-  execute: (body?: B) => Promise<T | null>
-  state: FetchRef<T>
-};
-/**
- * Clear fetch cache
- */
-export declare function clearFetchCache(key?: string): void;
-/**
- * Prefetch data into cache
- */
-export declare function prefetch<T>(url: string, options?: FetchOptions<T>): Promise<void>;
 /**
  * useFetch - Reactive data fetching with loading/error states
  *

package/dist/composables/use-share.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Check if file sharing is supported
+ */
+declare function isFileShareSupported(): boolean;
 /**
  * Reactive share composable
  */

package/dist/craft-bridge.d.ts

@@ -296,6 +296,13 @@ else if (data.type === 'event' && data.method) {
 })();
 </script>
 `;
+declare const craftBridge: {
+  CRAFT_BRIDGE_SCRIPT: string
+  generateCraftBridgeScript: typeof generateCraftBridgeScript
+  processCraftDirective: typeof processCraftDirective
+  injectCraftBridge: typeof injectCraftBridge
+  isCraftEnvironment: typeof isCraftEnvironment
+};
 /**
  * Craft Bridge Integration for stx
  *

package/dist/craft-compiler.d.ts

@@ -3,6 +3,10 @@ import type { CompiledTemplate } from './craft-ssr';
  * Compile stx template to native Craft code
  */
 export declare function compileToNative(template: string | CompiledTemplate, config?: Partial<CompilerConfig>): Promise<CompiledNativeCode>;
+/**
+ * Tree shake unused components
+ */
+declare function treeShake(ir: NativeIRNode, _deps: CompilerDependencyNode[]): NativeIRNode;
 /**
  * Create hot reload server
  */
@@ -11,6 +15,15 @@ export declare function createHotReloadServer(_config: HotReloadConfig): {
   stop: () => Promise<void>
   notifyChange: (path: string) => void
 };
+/**
+ * Default native component definitions
+ */
+declare const NATIVE_COMPONENTS: Map<string, NativeComponentDefinition>;
+declare const craftCompiler: {
+  compileToNative: typeof compileToNative
+  createHotReloadServer: typeof createHotReloadServer
+  NATIVE_COMPONENTS: typeof NATIVE_COMPONENTS
+};
 /**
  * Compiler configuration
  */

package/dist/craft-components.d.ts

@@ -370,6 +370,13 @@ export declare const CRAFT_COMPONENT_STYLES: `
 }
 </style>
 `;
+declare const craftComponents: {
+  CRAFT_COMPONENTS: typeof CRAFT_COMPONENTS
+  CRAFT_COMPONENT_STYLES: string
+  processCraftComponents: typeof processCraftComponents
+  registerCraftComponent: typeof registerCraftComponent
+  getCraftComponents: typeof getCraftComponents
+};
 /* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
 /**
  * Craft Native Components for stx

package/dist/craft-ssr.d.ts

@@ -39,6 +39,19 @@ export declare function getSSRCacheStats(): {
   renderCacheSize: number
   totalEntries: number
 };
+// ============================================================================
+// Export
+// ============================================================================
+declare const craftSSR: {
+  compileTemplate: typeof compileTemplate
+  renderSSR: typeof renderSSR
+  generateCraftOptimizations: typeof generateCraftOptimizations
+  prerenderForCraft: typeof prerenderForCraft
+  clearTemplateCache: typeof clearTemplateCache
+  clearRenderCache: typeof clearRenderCache
+  clearAllCaches: typeof clearAllCaches
+  getSSRCacheStats: typeof getSSRCacheStats
+};
 /**
  * Represents a node in the Craft component tree
  */

package/dist/database.d.ts

@@ -149,6 +149,7 @@ export declare function processDatabaseDirectives(template: string, context: Rec
  * Get schema builder
  */
 export declare function schema(): SchemaBuilder;
+declare const queryLog: never[];
 /**
  * Database connection configuration
  */

package/dist/dev-server/crosswind.d.ts

@@ -6,7 +6,31 @@ export declare function loadCrosswind(): Promise<CrosswindModule | null>;
 /**
  * Reset the Crosswind module cache (useful for testing)
  */
+export declare function resetCssCache(): void;
 export declare function resetCrosswindCache(): void;
+/**
+ * Load crosswind config from the working directory.
+ *
+ * Uses `bunfig` for resolution so crosswind configs compose the same way as
+ * `stx.config.ts` and other stacks configs — a single source of truth for
+ * config loading across the stack.
+ *
+ * Pre-check: we only hand off to bunfig once we've confirmed a
+ * `crosswind.config.*` file actually exists in the target directory. When
+ * stx is run from a parent repo root (e.g. running an example from the
+ * monorepo root, or a page rendered before the app dir is known) bunfig's
+ * built-in search would span 250+ paths up the tree and, on miss, log a
+ * large stack-style error dump. The file-existence pre-check keeps the
+ * common "no config file" case silent and fast.
+ */
+/**
+ * Load the user's crosswind config via bunfig — our shared config loader.
+ * bunfig's name-based search already covers `config/crosswind.ts`,
+ * `.config/crosswind.ts`, and root-level `crosswind.config.{ts,js,mjs,cjs}`,
+ * so we don't need to maintain a parallel list of paths here. Returns `null`
+ * when no config file is present, so callers can fall through to defaults
+ * without surfacing a "not found" warning to the user.
+ */
 export declare function loadCrosswindConfig(cwd: string): Promise<CrosswindConfig | null>;
 /**
  * Build Crosswind CSS using the build() API

package/dist/dev-server/types.d.ts

@@ -63,6 +63,8 @@ export declare interface DevServerOptions {
   cache?: boolean
   hotReload?: boolean
   hmrPort?: number
+  profile?: boolean
+  debugDirectives?: boolean
 }
 /**
  * Server instance returned by serve functions

package/dist/devtools.d.ts

@@ -53,6 +53,42 @@ export declare function measurePerformance<T>(name: string, fn: () => T, compone
  * Measure async execution time.
  */
 export declare function measurePerformanceAsync<T>(name: string, fn: () => Promise<T>, componentId?: string): Promise<T>;
+/**
+ * Select a component for inspection.
+ */
+declare function selectComponent(id: string): ComponentInfo | undefined;
+/**
+ * Select a store for inspection.
+ */
+declare function selectStore(id: string): StoreInfo | undefined;
+/**
+ * Inspect a DOM element to find its component.
+ */
+declare function inspectElement(element: HTMLElement): ComponentInfo | undefined;
+/**
+ * Highlight a component in the page.
+ */
+declare function highlightComponent(id: string): void;
+/**
+ * Clear component highlight.
+ */
+declare function clearHighlight(): void;
+/**
+ * Log the component tree to console.
+ */
+declare function logComponentTree(): void;
+/**
+ * Log store state to console.
+ */
+declare function logStoreState(storeId?: string): void;
+/**
+ * Time travel to a previous store state.
+ */
+declare function timeTravel(historyIndex: number, storeId: string): void;
+// =============================================================================
+// DevTools State
+// =============================================================================
+declare const devToolsState: DevToolsState;
 /* eslint-disable no-console, prefer-const, style/max-statements-per-line */
 /**
  * STX DevTools Integration

package/dist/docs.d.ts

@@ -1,5 +1,4 @@
-import { config } from './config';
-import type { ComponentDoc, ComponentPropDoc, DirectiveDoc, DocGeneratorConfig, TemplateDoc } from './types';
+import type { ComponentDoc, ComponentPropDoc, DirectiveDoc, TemplateDoc } from './types';
 /**
  * Extract component properties from a component file
  */
@@ -36,21 +35,3 @@ export declare function formatDocsAsMarkdown(componentDocs?: ComponentDoc[], tem
  * Format documentation as HTML
  */
 export declare function formatDocsAsHtml(componentDocs?: ComponentDoc[], templateDocs?: TemplateDoc[], directiveDocs?: DirectiveDoc[], extraContent?: string): string;
-/**
- * Format documentation as JSON
- */
-export declare function formatDocsAsJson(componentDocs?: ComponentDoc[], templateDocs?: TemplateDoc[], directiveDocs?: DirectiveDoc[], extraContent?: string): string;
-/**
- * Generate documentation
- */
-export declare function generateDocs(options: {
-  componentsDir?: string
-  templatesDir?: string
-  webComponentsConfig?: any
-  customDirectives?: any[]
-  config: Partial<DocGeneratorConfig>
-}): Promise<boolean>;
-/**
- * Documentation generation command handler for CLI
- */
-export declare function docsCommand(options: any): Promise<boolean>;

package/dist/forms.d.ts

@@ -112,13 +112,13 @@ export declare const defaultFormClasses: FormClassConfig;
  * Enhanced validation rules registry with full validation support
  */
 export declare const enhancedValidationRules: {
-  required: { name: 'required'; validate: (value) => unknown; toHtml5: () => unknown; message: 'This field is required' };
-  email: { name: 'email'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter a valid email address' };
-  url: { name: 'url'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter a valid URL' };
-  numeric: { name: 'numeric'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter a number' };
-  integer: { name: 'integer'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter a whole number' };
-  alpha: { name: 'alpha'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter only letters' };
-  alphanumeric: { name: 'alphanumeric'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter only letters and numbers' };
+  required: { name: 'required'; validate: (value) => unknown; toHtml5: () => readonly ['required']; message: 'This field is required' };
+  email: { name: 'email'; validate: (value) => unknown; toHtml5: () => readonly ['type="email"']; message: 'Please enter a valid email address' };
+  url: { name: 'url'; validate: (value) => unknown; toHtml5: () => readonly ['type="url"']; message: 'Please enter a valid URL' };
+  numeric: { name: 'numeric'; validate: (value) => unknown; toHtml5: () => readonly ['type="number"']; message: 'Please enter a number' };
+  integer: { name: 'integer'; validate: (value) => unknown; toHtml5: () => readonly ['type="number"', 'step="1"']; message: 'Please enter a whole number' };
+  alpha: { name: 'alpha'; validate: (value) => unknown; toHtml5: () => readonly ['pattern="[a-zA-Z]+"']; message: 'Please enter only letters' };
+  alphanumeric: { name: 'alphanumeric'; validate: (value) => unknown; toHtml5: () => readonly ['pattern="[a-zA-Z0-9]+"']; message: 'Please enter only letters and numbers' };
   min: { name: 'min'; validate: (value, params) => unknown; toHtml5: (params) => readonly [`minlength="${params[0]}"`, `min="${params[0]}"`]; message: 'Must be at least {{param}} characters' };
   max: { name: 'max'; validate: (value, params) => unknown; toHtml5: (params) => readonly [`maxlength="${params[0]}"`, `max="${params[0]}"`]; message: 'Must be no more than {{param}} characters' };
   between: { name: 'between'; validate: (value, params) => unknown; toHtml5: (params) => readonly [`minlength="${params[0]}"`, `maxlength="${params[1]}"`]; message: 'Must be between {{min}} and {{max}}' };
@@ -126,11 +126,11 @@ export declare const enhancedValidationRules: {
   in: { name: 'in'; validate: (value, params) => unknown; message: 'Must be one of: {{values}}' };
   notIn: { name: 'notIn'; validate: (value, params) => unknown; message: 'Must not be: {{values}}' };
   regex: { name: 'regex'; validate: (value, params) => unknown; toHtml5: (params) => readonly [`pattern="${params[0]}"`]; message: 'Invalid format' };
-  date: { name: 'date'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter a valid date' };
+  date: { name: 'date'; validate: (value) => unknown; toHtml5: () => readonly ['type="date"']; message: 'Please enter a valid date' };
   before: { name: 'before'; validate: (value, params) => unknown; toHtml5: (params) => readonly [`max="${params[0]}"`]; message: 'Must be before {{date}}' };
   after: { name: 'after'; validate: (value, params) => unknown; toHtml5: (params) => readonly [`min="${params[0]}"`]; message: 'Must be after {{date}}' };
   size: { name: 'size'; validate: (value, params) => unknown; message: 'Must be exactly {{size}}' };
-  phone: { name: 'phone'; validate: (value) => unknown; toHtml5: () => unknown; message: 'Please enter a valid phone number' }
+  phone: { name: 'phone'; validate: (value) => unknown; toHtml5: () => readonly ['type="tel"', 'pattern="\\+?\\(?\\d{1,4}\\)?[-\\s./\\d]*"']; message: 'Please enter a valid phone number' }
 };
 /**
  * Default CSS class names for form elements.

package/dist/hot-reload.d.ts

@@ -2,6 +2,10 @@
  * Generate the hot reload client script to inject into HTML
  */
 export declare function generateHotReloadScript(wsPort: number, options?: HotReloadOptions): string;
+/**
+ * Inject hot reload script into HTML content
+ */
+export declare function injectHotReload(html: string, wsPort: number, options?: HotReloadOptions): string;
 /**
  * Determine if a file change should trigger a CSS-only update
  */

package/dist/index.d.ts

@@ -30,6 +30,7 @@ export * from './runtime';
 export * from './forms';
 // Core modules
 export * from './env';
+export { getPublicEnv, getPublicEnvDefine } from './public-env';
 export * from './a11y';
 export * from './analytics';
 export * from './analyzer';