@stacksjs/stx 0.2.9 → 0.2.11

package/dist/document-shell.d.ts

@@ -0,0 +1,33 @@
+import type { AppHeadConfig } from './types/config-types';
+/**
+ * Generate the full HTML document shell wrapping page content.
+ *
+ * @param content - The rendered page/layout HTML (no document wrapper)
+ * @param headConfig - Head configuration from stx.config.ts
+ * @param options - Additional options for script/style injection
+ * @returns Complete HTML document
+ */
+export declare function generateDocumentShell(content: string, headConfig?: AppHeadConfig, options?: {
+    /** Page-specific title (overrides config) */
+    title?: string
+    /** Extra styles to inject in <head> (e.g. Crosswind CSS, scoped styles) */
+    styles?: string[]
+    /** Extra scripts to inject before </body> (e.g. signals runtime, router) */
+    bodyScripts?: string[]
+    /** Extra scripts/tags for <head> */
+    headScripts?: string[]
+    /** Stacks to inject (from @push directives) */
+    headStack?: string
+    bodyStack?: string
+  }): string;
+/**
+ * Check if HTML already has a document shell (<!DOCTYPE> or <html>).
+ * Templates that extend layouts with document shells should not be double-wrapped.
+ */
+export declare function hasDocumentShell(html: string): boolean;
+/**
+ * Wrap HTML in a document shell if it doesn't already have one.
+ * This is the main entry point — called at the top level after all
+ * directive processing is complete.
+ */
+export declare function ensureDocumentShell(html: string, headConfig?: AppHeadConfig, options?: Parameters<typeof generateDocumentShell>[2]): string;

package/dist/error-boundaries.d.ts

@@ -11,6 +11,7 @@
  * Or with options:
  *   @errorBoundary(id: 'my-boundary', logErrors: false)
  */
+// eslint-disable-next-line pickier/no-unused-vars
 export declare function processErrorBoundaryDirectives(template: string, context?: Record<string, unknown>, _filePath?: string): string;
 /**
  * Wrap content in a try/catch for SSR error handling.

package/dist/events.d.ts

@@ -33,6 +33,7 @@ export declare function processEventDirectives(template: string, context: Record
  * Check if a template contains event directives
  */
 export declare function hasEventDirectives(template: string): boolean;
+/* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
 /**
  * Event Directives Module
  *

package/dist/expressions.d.ts

@@ -46,6 +46,37 @@ export declare function escapeHtml(unsafe: string): string;
  * or has reactive attributes (@if, @for) with function call expressions
  */
 export declare function usesSignalsInScript(template: string): boolean;
+/**
+ * Interpolate server-side `{{ expr }}` / `{!! expr !!}` expressions inside a
+ * `<script>` body, using the same evaluator as the main template.
+ *
+ * This makes server data available to client scripts without manual data-island
+ * plumbing — write `const PRICE = {{ car.price }}` and get `const PRICE = 42`.
+ *
+ * JavaScript-aware rules (different from HTML `{{ }}`):
+ *   - `{{ expr }}` → `JSON.stringify(value)`. Strings become valid JS string
+ *     literals, numbers/booleans pass through, objects/arrays become JSON
+ *     literals. Safe to drop into any JS expression position.
+ *   - `{!! expr !!}` → raw `String(value)`. Use when you want the value spliced
+ *     verbatim (e.g. you've already serialized it yourself).
+ *   - Expressions that fail to evaluate (reference a client-only signal, a
+ *     loop variable, or anything not in context) are left **untouched** so the
+ *     client runtime can process them later. This mirrors the "preserve for
+ *     client" semantics of the main expression processor when signals are in use.
+ *
+ * Only the content strictly between `<script>` and `</script>` is touched —
+ * attributes and surrounding HTML are left alone.
+ */
+export declare function interpolateScriptExpressions(scriptBody: string, context: Record<string, any>): string;
+/**
+ * Interpolate server expressions inside every `<script>` tag in a template,
+ * skipping any script that opts out via `data-raw`, `type="application/json"`,
+ * or a `src=` attribute (external scripts don't have inline content to template).
+ *
+ * Each matched script has its body passed through {@link interpolateScriptExpressions}.
+ * Attributes and tag structure are never modified.
+ */
+export declare function interpolateScriptsInTemplate(template: string, context: Record<string, any>, options?: InterpolateScriptsOptions): string;
 /**
  * Process template expressions including variables, filters, and operations
  */
@@ -96,8 +127,15 @@ export declare const defaultFilters: {
   abs: (value: any, _context: Record<string, any>) => unknown;
   round: (value: any, _context: Record<string, any>, decimals?: number) => unknown
 };
+/**
+ * Options for {@link interpolateScriptsInTemplate}.
+ */
+export declare interface InterpolateScriptsOptions {
+  skipServer?: boolean
+}
 /**
  * Add basic filter support to expressions
  * Filter functions receive the value to transform, optional args, and the context object
  */
+// eslint-disable-next-line pickier/no-unused-vars
 export type FilterFunction = (value: any, context: Record<string, any>, ...args: any[]) => any;

package/dist/forms-validation.d.ts

@@ -125,7 +125,9 @@ declare interface FormState<T extends Record<string, Validator>> {
 // =============================================================================
 // Types
 // =============================================================================
+// eslint-disable-next-line pickier/no-unused-vars
 declare type ValidatorFn = (value: unknown, formValues?: Record<string, unknown>) => true | string;
+// eslint-disable-next-line pickier/no-unused-vars
 declare type AsyncValidatorFn = (value: unknown, formValues?: Record<string, unknown>) => Promise<true | string>;
 // =============================================================================
 // Validator Class

package/dist/head.d.ts

@@ -117,6 +117,7 @@ export declare function processTitleDirective(content: string, context: Record<s
  * ```
  */
 export declare function processMetaDirective(content: string, context: Record<string, unknown>): string;
+/* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
 /**
  * STX Head Management
  *

package/dist/hot-reload.d.ts

@@ -22,6 +22,7 @@ export declare function getHmrServer(options?: HotReloadOptions): HotReloadServe
  * Stop and clear the global HMR server
  */
 export declare function stopHmrServer(): void;
+/* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
 /**
  * Hot Reload Module
  *

package/dist/hydration-runtime.d.ts

@@ -22,6 +22,7 @@ export declare function extractComponentName(content: string): string | null;
  * Parses :prop="value" bindings.
  */
 export declare function extractBoundProps(content: string, context: Record<string, unknown>): Record<string, unknown>;
+/* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
 /**
  * Unified Hydration Runtime for Islands Architecture
  *

package/dist/hydration.d.ts

@@ -31,6 +31,7 @@ export declare function hydrate(options?: HydrationOptions): Promise<void>;
  * Generate hydration CSS
  */
 export declare function generateHydrationCSS(): string;
+/* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
 /**
  * STX Hydration Runtime
  *

package/dist/i18n.d.ts

@@ -103,7 +103,8 @@ export declare function loadTranslationLazy(locale: string, options: StxOptions)
  * const translations = getTranslationSync('en')
  * if (translations) {
  *   // Use translations
- * } else {
+ * }
+else {
  *   // Show loading state or fallback
  *   loadTranslationLazy('en', options).then(handleLoaded)
  * }
@@ -220,6 +221,7 @@ export declare function getTranslation(key: string, translations: Record<string,
 /**
  * Process @translate directive
  */
+// eslint-disable-next-line pickier/no-unused-vars
 export declare function processTranslateDirective(template: string, context: Record<string, any>, filePath: string, options: StxOptions): Promise<string>;
 /**
  * Create a translation filter for expressions

package/dist/image-optimization/build-plugin.d.ts

@@ -10,6 +10,7 @@ export declare function createImagePlugin(options?: ImageBuildOptions): BuildPlu
 export declare function optimizeImage(inputPath: string, outputDir: string, options?: ImageOptions): Promise<ProcessedImage>;
 /**
  * Optimize all images in a directory
+ // eslint-disable-next-line pickier/no-unused-vars
  */
 export declare function optimizeDirectory(inputDir: string, outputDir: string, options?: ImageBuildOptions): Promise<{
   processed: ProcessedImage[]

package/dist/index.d.ts

@@ -1,6 +1,9 @@
+/// <reference path="./stx.d.ts" />
+export type { Store, StoreOptions, PersistOptions, DefineStoreOptions } from './state-management';
 export type { StxComponentInstance, EmitFn } from './composition-api';
 export type { VNode } from './jsx-runtime';
 export type { StxApp, StxApp as App, StxAppPlugin, StxPluginInput, StxAppConfig } from './app';
+export type { StxPlugin, PluginContext, PluginSetupContext } from './plugin-system';
 // ============================================================
 // STX Core Exports
 // Note: Some modules have overlapping exports. If you need specific
@@ -32,9 +35,14 @@ export * from './analytics';
 export * from './analyzer';
 export * from './animation';
 export * from './assets';
+export * from './app-shell';
 export * from './async-components';
 export * from './auth';
+export * from './build';
+export * from './build-assets';
+export * from './build-mode-detector';
 export * from './build-optimizer';
+export * from './broadcasting';
 export * from './caching';
 export * from './components';
 export * from './config';
@@ -46,6 +54,7 @@ export * from './custom-directives';
 export * from './defer';
 export * from './deploy';
 export * from './dev-server';
+export * from './document-shell';
 export * from './directive-api';
 export * from './docs';
 export * from './edge-runtime';
@@ -64,13 +73,21 @@ export * from './loops';
 export * from './markdown';
 export * from './middleware';
 export * from './parser';
+export * from './manifest';
+export * from './placeholder';
 export * from './process';
 export * from './production-build';
+export * from './production-builder';
+export * from './production-server';
 export * from './release';
 export * from './router';
 export * from './scaffolding';
+export * from './script-classifier';
 export * from './seo';
 export * from './serve';
+export * from './style-scoping';
+export * from './template-compiler';
+export * from './template-hydrator';
 export * from './streaming';
 export * from './suspense';
 export * from './teleport';
@@ -89,6 +106,8 @@ export * from './component-hmr';
 export * from './hydration';
 // ssg moved to stx/ssg
 export * from './ssr';
+// State management — explicit exports to avoid conflicts with runtime.ts and reactivity.ts
+export { defineStore, useStore, createStore, getStore, getStoreNames, hasStore } from './state-management';
 // visual-testing moved to stx/visual-testing
 export * from './image-optimization';
 export * from './media';
@@ -96,12 +115,14 @@ export * from './media';
 export * from './build-views';
 export * from './signals';
 export * from './spa-shell';
-// Vue compatibility and JSX support
+// Vue compatibility, server bindings, and JSX support
 export * from './vue-template';
+export { processServerBindings } from './server-bindings';
 export { provide, inject, setGlobalProvide, defineEmits, defineExpose, nextTick, onErrorCaptured, handleError, useSlots, useAttrs, createProvideContext, generateCompositionRuntime } from './composition-api';
 export { jsx, jsxs, jsxDEV, Fragment, renderToString, renderToStream, renderToDOM, Show, For, Portal, h } from './jsx-runtime';
 export { createApp, createApp as createStxApp, defineCustomElement } from './app';
 export * from './dynamic-components';
+export { definePlugin, pluginManager } from './plugin-system';
 // These modules are exported first to establish their types
 export * from './render';
 export { generateCrosswindCSS, injectCrosswindCSS, extractClassNames } from './dev-server/crosswind';