@stacksjs/stx 0.2.4 → 0.2.6

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

@@ -46,7 +46,7 @@ export declare interface PermissionsContext {
  * Translation context for @translate, @t directives
  */
 export declare interface TranslationContext {
-
+  [locale: string]: Record<string, string>
 }
 /**
  * Base template context with common properties
@@ -62,12 +62,13 @@ export declare interface BaseTemplateContext {
   loop?: LoopContext
   $loop?: LoopContext
   slot?: string
+  [key: string]: unknown
 }
 /**
  * Template context type alias for backward compatibility
  * Use BaseTemplateContext for new code
  */
-export type TemplateContext = BaseTemplateContext
+export type TemplateContext = BaseTemplateContext;
 /**
  * Generic template context that allows specifying custom typed properties
  *
@@ -88,12 +89,12 @@ export type TemplateContext = BaseTemplateContext
  * }
  * ```
  */
-export type TypedContext<T extends Record<string, unknown>> = BaseTemplateContext & T
+export type TypedContext<T extends Record<string, unknown>> = BaseTemplateContext & T;
 /**
  * Utility type to extract the value type from a context key
  */
-export type ContextValue<C extends BaseTemplateContext, K extends keyof C> = C[K]
+export type ContextValue<C extends BaseTemplateContext, K extends keyof C> = C[K];
 /**
  * Utility type to make certain context properties required
  */
-export type RequireContextKeys<C extends BaseTemplateContext, K extends keyof C> = Required<Pick<C, K>> & Omit<C, K>
+export type RequireContextKeys<C extends BaseTemplateContext, K extends keyof C> = Required<Pick<C, K>> & Omit<C, K>;

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

@@ -72,8 +72,8 @@ export type CspSourceValue = | '\'self\''
   | 'http:'
   | 'ws:'
   | 'wss:'
-  | string
+  | string // Allow custom URLs and nonces like 'nonce-xxx' or 'sha256-xxx';
 /**
  * Preset CSP configurations for common use cases
  */
-export type CspPreset = 'strict' | 'moderate' | 'relaxed' | 'api'
+export type CspPreset = 'strict' | 'moderate' | 'relaxed' | 'api';

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

@@ -9,7 +9,7 @@ export declare function isDirectiveKind<K extends Directive['kind']>(directive:
  * Base directive type with common properties
  */
 declare interface BaseDirective {
-  kind: string
+  readonly kind: string
   raw: string
   start: number
   end: number
@@ -234,11 +234,11 @@ export type Directive = | ConditionalDirective
   | ScriptDirective
   | EnvDirective
   | I18nDirective
-  | UserCustomDirective
+  | UserCustomDirective;
 /**
  * Helper type to extract directive by kind
  */
-export type DirectiveOfKind<K extends Directive['kind']> = Extract<Directive, { kind: K }>
+export type DirectiveOfKind<K extends Directive['kind']> = Extract<Directive, { kind: K }>;
 /**
  * Custom directive handler function
  */
@@ -247,7 +247,7 @@ export type CustomDirectiveHandler = (
   params: string[],
   context: Record<string, unknown>,
   filePath: string
-) => string | Promise<string>
+) => string | Promise<string>;
 /**
  * Middleware handler function
  */
@@ -256,4 +256,4 @@ export type MiddlewareHandler = (
   context: Record<string, unknown>,
   filePath: string,
   options: import('./config-types').StxOptions
-) => string | Promise<string>
+) => string | Promise<string>;

package/dist/types/index.d.ts

@@ -1,3 +1,17 @@
+/**
+ * stx Types
+ *
+ * This file re-exports all types from domain-specific type files.
+ * For new code, prefer importing from specific type files for better code organization.
+ *
+ * @example
+ * // Import from specific file (preferred)
+ * import type { StxConfig } from './types/config-types'
+ *
+ * // Or import from index (backward compatible)
+ * import type { StxConfig } from './types'
+ */
+// Context types
 export type {
   AuthContext,
   BaseTemplateContext,
@@ -9,6 +23,7 @@ export type {
   TranslationContext,
   TypedContext,
 } from './context-types';
+// Directive types
 export type {
   A11yDirective,
   AuthDirective,
@@ -33,6 +48,7 @@ export type {
   SwitchDirective,
   UserCustomDirective,
 } from './directive-types';
+// Component types
 export type {
   ComponentConfig,
   ComponentDefinition,
@@ -48,6 +64,7 @@ export type {
   WebComponent,
   WebComponentConfig,
 } from './component-types';
+// Config types
 export type {
   A11yConfig,
   AnalyticsConfig,
@@ -64,12 +81,14 @@ export type {
   SeoFeatureConfig,
   StreamingConfig,
   StreamRenderer,
+  StrictModeConfig,
   StxConfig,
   StxOptions,
   SyntaxHighlightingConfig,
   SyntaxHighlightTheme,
   TwitterConfig,
 } from './config-types';
+// PWA types
 export type {
   PwaBackgroundSyncConfig,
   PwaCacheStorageConfig,
@@ -89,10 +108,11 @@ export type {
   PwaShortcut,
   PwaUpdateConfig,
 } from './pwa-types';
+// CSP types
 export type {
   CspConfig,
   CspDirectives,
   CspPreset,
   CspSourceValue,
 } from './csp-types';
-export { isDirectiveKind } from './directive-types';
+export { isDirectiveKind } from './directive-types';

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

@@ -100,9 +100,7 @@ export declare interface PwaPushConfig {
   defaultIcon?: string
   defaultBadge?: string
   defaultOptions?: {
-    /** Enable vibration */
     vibrate?: number[]
-    /** Require interaction to dismiss */
     requireInteraction?: boolean
   }
 }
@@ -127,11 +125,8 @@ export declare interface PwaShareTargetConfig {
   method?: 'GET' | 'POST'
   enctype?: 'application/x-www-form-urlencoded' | 'multipart/form-data'
   params?: {
-    /** Parameter name for shared title */
     title?: string
-    /** Parameter name for shared text */
     text?: string
-    /** Parameter name for shared URL */
     url?: string
   }
   acceptFiles?: Array<{
@@ -215,4 +210,4 @@ export declare interface PwaConfig {
 /**
  * PWA caching strategy for service worker routes
  */
-export type PwaCacheStrategy = 'cache-first' | 'network-first' | 'stale-while-revalidate' | 'network-only' | 'cache-only'
+export type PwaCacheStrategy = 'cache-first' | 'network-first' | 'stale-while-revalidate' | 'network-only' | 'cache-only';

package/dist/types.d.ts

@@ -1 +1,28 @@
-export * from './types/index';
+/**
+ * stx Types
+ *
+ * This file re-exports all types from the modular types directory.
+ * The types have been split into domain-specific files for better organization:
+ *
+ * - types/context-types.ts - Template context and authentication types
+ * - types/directive-types.ts - All directive types (discriminated unions)
+ * - types/component-types.ts - Component system and documentation types
+ * - types/config-types.ts - Configuration types for stx options
+ * - types/pwa-types.ts - Progressive Web App configuration types
+ * - types/csp-types.ts - Content Security Policy types
+ *
+ * For new code, prefer importing from specific type files:
+ * @example
+ * ```typescript
+ * import type { StxConfig } from './types/config-types'
+ * import type { ConditionalDirective } from './types/directive-types'
+ * ```
+ *
+ * For backward compatibility, you can still import from this file:
+ * @example
+ * ```typescript
+ * import type { StxConfig, ConditionalDirective } from './types'
+ * ```
+ */
+// Re-export everything from the modular types
+export * from './types/index';

package/dist/typescript-templates.d.ts

@@ -141,38 +141,5 @@ export declare interface GeneratedTypes {
   content: string
   filename: string
 }
-/**
- * TypeScript-First Templates Module
- *
- * Provides compile-time type checking and TypeScript support for stx templates.
- *
- * ## Features
- *
- * 1. **Type-Safe Context** - Define typed interfaces for template context
- * 2. **Compile-Time Checking** - Validate expressions against context types
- * 3. **Type Inference** - Infer types from script blocks
- * 4. **Type Generation** - Generate TypeScript definitions from templates
- * 5. **IDE Support** - Enable autocomplete and type hints in editors
- *
- * ## Usage
- *
- * ```html
- * <!-- Define context type at top of template -->
- * @types
- * interface PageContext {
- *   title: string
- *   items: Array<{ id: number; name: string }>
- *   user?: { name: string; role: 'admin' | 'user' }
- * }
- * @endtypes
- *
- * <h1>{{ title }}</h1>
- * @foreach(items as item)
- *   <p>{{ item.name }}</p>  <!-- Type-checked! -->
- * @endforeach
- * ```
- *
- * @module typescript-templates
- */
 /** Supported TypeScript primitive types */
-export type TSPrimitiveType = 'string' | 'number' | 'boolean' | 'null' | 'undefined' | 'any' | 'unknown' | 'never' | 'void'
+export type TSPrimitiveType = 'string' | 'number' | 'boolean' | 'null' | 'undefined' | 'any' | 'unknown' | 'never' | 'void';

package/dist/utils.d.ts

@@ -58,6 +58,7 @@ export declare function clearComponentCache(): void;
  * Get component cache statistics
  */
 export declare function getComponentCacheStats(): { size: number, maxSize: number };
+// Re-export from extracted modules for backward compatibility
 export {
   extractDirectiveNames,
   getPositionInfo,
@@ -70,4 +71,4 @@ export {
   extractScriptFromTemplate,
   extractVariables,
   hasVariables,
-} from './variable-extractor';
+} from './variable-extractor';

package/dist/validator.d.ts

@@ -74,4 +74,4 @@ export declare interface TemplateValidationResult {
   valid: boolean
   errors: TemplateValidationError[]
   warnings: TemplateValidationError[]
-}
+}

package/dist/variable-extractor.d.ts

@@ -36,4 +36,4 @@ export declare function extractScriptFromTemplate(template: string): {
  * @param scriptContent - The script content
  * @returns Whether variables are present
  */
-export declare function hasVariables(scriptContent: string): boolean;
+export declare function hasVariables(scriptContent: string): boolean;

package/dist/view-composers.d.ts

@@ -168,4 +168,4 @@ export declare function clearComposers(): void;
  * }
  * ```
  */
-export type ViewComposerCallback = (context: Record<string, any>, filePath: string) => void | Promise<void>
+export type ViewComposerCallback = (context: Record<string, any>, filePath: string) => void | Promise<void>;

package/dist/virtual-scrolling.d.ts

@@ -93,6 +93,9 @@ export declare interface VirtualGridOptions {
   gap?: number
   overscan?: number
 }
+// ============================================================================
+// Exports
+// ============================================================================
 export default {
   createVirtualList,
   processVirtualListDirectives,
@@ -100,4 +103,4 @@ export default {
   processVirtualGridDirectives,
   generateVirtualListCSS,
   useVirtualList,
-};
+};

package/dist/visual-editor.d.ts

@@ -157,34 +157,6 @@ export declare interface InsertResult {
   content: string
   cursorPosition: EditorPosition
 }
-/**
- * Visual Editor Integration Module
- *
- * Provides APIs for visual template editing in IDEs and editors.
- * This module enables:
- * - Template AST visualization
- * - Component outline/structure view
- * - Drag-and-drop component editing
- * - Live preview support
- * - Template property inspection
- *
- * ## Usage
- *
- * ```typescript
- * import { analyzeTemplate, getTemplateOutline, generatePreview } from 'stx/visual-editor'
- *
- * // Analyze template structure
- * const analysis = analyzeTemplate(templateContent)
- *
- * // Get hierarchical outline
- * const outline = getTemplateOutline(templateContent)
- *
- * // Generate preview HTML
- * const preview = await generatePreview(templateContent, context)
- * ```
- *
- * @module visual-editor
- */
 /** Node types in template outline */
 export type OutlineNodeType = | 'document'
   | 'element'
@@ -196,7 +168,7 @@ export type OutlineNodeType = | 'document'
   | 'script'
   | 'style'
   | 'comment'
-  | 'text'
+  | 'text';
 /** Directive category for visual grouping */
 export type DirectiveCategory = | 'control-flow'
   | 'loop'
@@ -206,4 +178,4 @@ export type DirectiveCategory = | 'control-flow'
   | 'form'
   | 'seo'
   | 'i18n'
-  | 'custom'
+  | 'custom';

package/dist/visual-testing.d.ts

@@ -98,6 +98,9 @@ export declare interface ReportConfig {
   title?: string
   includeScreenshots?: boolean
 }
+// =============================================================================
+// Exports
+// =============================================================================
 export default {
   createSnapshotTester,
   createVisualRegressionTester,
@@ -106,4 +109,4 @@ export default {
   snapshot,
   snapshotJson,
   defaultViewports,
-};
+};

package/dist/vue-template.d.ts

@@ -13,4 +13,4 @@ export declare function hasVueTemplateSyntax(template: string): boolean;
  * @param template - The template string potentially containing Vue directives
  * @returns The template with Vue directives converted to stx equivalents
  */
-export declare function processVueTemplate(template: string): string;
+export declare function processVueTemplate(template: string): string;

package/dist/web-components/css-scoping.d.ts

@@ -51,4 +51,4 @@ export declare interface CssScopingOptions {
   preserveHost?: boolean
   scopeKeyframes?: boolean
   scopeCustomProperties?: boolean
-}
+}

package/dist/web-components/index.d.ts

@@ -5,6 +5,15 @@ export type {
   ReactiveProperty,
   WatchDefinition,
 } from './reactive-generator';
+/**
+ * Web Components Module
+ *
+ * Provides utilities for building web components from stx templates.
+ * This module has been split into focused sub-modules:
+ *
+ * - css-scoping.ts - CSS scoping and style isolation
+ * - reactive-generator.ts - Reactive component code generation
+ */
 export {
   extractStyleFromTemplate,
   generateComponentId,
@@ -17,4 +26,4 @@ export {
   generateReactiveComponentTS,
   generateReactiveMixin,
   generateReactiveRuntime,
-} from './reactive-generator';
+} from './reactive-generator';

package/dist/web-components/reactive-generator.d.ts

@@ -69,4 +69,4 @@ export declare interface ReactiveComponentOptions {
     adopted?: string
     attributeChanged?: string
   }
-}
+}

package/dist/web-components.d.ts

@@ -226,4 +226,4 @@ export declare interface ParsedSFCComponent {
 /**
  * CSS scoping strategy
  */
-export type CssScopingStrategy = 'shadow' | 'prefix' | 'attribute' | 'bem'
+export type CssScopingStrategy = 'shadow' | 'prefix' | 'attribute' | 'bem';

package/dist/x-element.d.ts

@@ -5,17 +5,24 @@
  * - x-data: Define reactive data scope
  * - x-model: Two-way binding for inputs
  * - x-text: Reactive text content
- * - @event: Event handling (e.g., @click, @submit)
+ * - x-show: Toggle visibility based on expression
+ * - :class: Bind CSS classes from object expression
+ * - :disabled, :href, :src, etc.: Bind any attribute
+ * - @event: Event handling (e.g., @click, @submit.prevent)
  *
  * Note: Use @if, @for, @foreach for server-side rendering.
  * x-element is only for client-side interactivity that SSR can't handle.
  *
  * @example
  * ```html
- * <div x-data="{ name: '', count: 0 }">
- *   <input x-model="name" />
- *   <p>Hello, <span x-text="name"></span>!</p>
- *   <button @click="count++">Count: <span x-text="count"></span></button>
+ * <div x-data="{ email: '', loading: false, success: false }">
+ *   <form @submit.prevent="subscribe()">
+ *     <input x-model="email" type="email" />
+ *     <button type="submit" :disabled="loading">
+ *       <span x-text="loading ? 'Sending...' : 'Subscribe'"></span>
+ *     </button>
+ *   </form>
+ *   <p x-show="success" x-text="'Thanks for subscribing!'"></p>
  * </div>
  * ```
  */
@@ -32,4 +39,4 @@ export declare function hasXElementDirectives(template: string): boolean;
  * Process x-element directives in template
  * Injects the runtime if x-* directives are found
  */
-export declare function processXElementDirectives(template: string): string;
+export declare function processXElementDirectives(template: string): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx",
   "type": "module",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "A performant UI Framework. Powered by Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -104,9 +104,9 @@
   },
   "dependencies": {
     "@stacksjs/clapp": "^0.2.0",
-    "@stacksjs/desktop": "0.2.4",
-    "@stacksjs/sanitizer": "0.2.4",
-    "bun-plugin-stx": "0.2.4",
+    "@stacksjs/desktop": "0.2.6",
+    "@stacksjs/sanitizer": "0.2.6",
+    "bun-plugin-stx": "0.2.6",
     "bunfig": "^0.15.6",
     "ts-syntax-highlighter": "^0.2.1"
   }