@stacksjs/stx 0.2.5 → 0.2.6

package/dist/precompiler.d.ts

@@ -1,6 +1,3 @@
-import { SourceMapGenerator } from './source-maps';
-import { TemplateParser,  } from './ast';
-import type { ASTNode, AttributeNode, ComponentNode, DirectiveNode, DocumentNode, ElementNode, ExpressionNode,  } from './ast';
 import type { SourceMapV3 } from './source-maps';
 // Export singleton instance
 export declare const compiler: TemplateCompiler;
@@ -25,84 +22,22 @@ export declare interface CompileResult {
   code: string
   map?: SourceMapV3
   analysis: {
-    /** Variables used in expressions */
     usedVariables: Set<string>
-    /** Directives used */
     usedDirectives: Set<string>
-    /** Components used */
     usedComponents: Set<string>
-    /** Whether template has dynamic content */
     isDynamic: boolean
-    /** Whether template uses slots */
     hasSlots: boolean
   }
 }
-declare interface CodegenContext {
-  code: string
-  indentLevel: number
-  sourceMapGenerator?: SourceMapGenerator
-  currentLine: number
-  currentColumn: number
-  sourceFile: string
-  mode: CompileMode
-  optimize: boolean
-  dev: boolean
-  usedVariables: Set<string>
-  usedDirectives: Set<string>
-  usedComponents: Set<string>
-  hasSlots: boolean
-  varCounter: number
-}
 /**
  * Compilation mode
  */
-export type CompileMode = 'ssr' | 'client' | 'universal'
+export type CompileMode = 'ssr' | 'client' | 'universal';
 /**
  * Template pre-compiler
  */
 export declare class TemplateCompiler {
-  private parser: TemplateParser;
   constructor();
   compile(template: string, options?: CompileOptions): CompileResult;
   compileFile(filePath: string, options?: CompileOptions): Promise<CompileResult>;
-  private createContext(options: {
-    sourceFile: string
-    mode: CompileMode
-    optimize: boolean
-    dev: boolean
-    sourceMaps: boolean
-  }): CodegenContext;
-  private generateRenderFunction(ast: DocumentNode, ctx: CodegenContext): string;
-  private analyzeAST(ast: DocumentNode, ctx: CodegenContext): void;
-  private generateNode(node: ASTNode, ctx: CodegenContext): string;
-  private generateText(text: string, _ctx: CodegenContext): string;
-  private generateExpression(node: ExpressionNode, _ctx: CodegenContext): string;
-  private generateDirective(node: DirectiveNode, ctx: CodegenContext): string;
-  private generateIf(condition: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateUnless(condition: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateForeach(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateFor(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateWhile(condition: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateIsset(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateEmpty(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateAuth(body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateGuest(body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateEnv(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateSwitch(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateSlot(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateSection(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generatePush(params: string | null, body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateOnce(body: ASTNode[] | null, ctx: CodegenContext): string;
-  private generateScript(body: ASTNode[] | null, _ctx: CodegenContext): string;
-  private generateStyle(node: { content: string, scoped: boolean }, _ctx: CodegenContext): string;
-  private generateElement(node: ElementNode, ctx: CodegenContext): string;
-  private generateAttribute(attr: AttributeNode, ctx: CodegenContext): string;
-  private parseAttributeValue(value: string, ctx: CodegenContext): string;
-  private generateComponent(node: ComponentNode, ctx: CodegenContext): string;
-  private splitConditionalBody(body: ASTNode[]): {
-    ifBody: ASTNode[]
-    elseifs: Array<{ condition: string, body: ASTNode[] }>
-    elseBody: ASTNode[]
-  };
-  private wrapModule(functionCode: string, functionName: string, format: 'esm' | 'cjs' | 'iife', _ctx: CodegenContext): string;
-}
+}

package/dist/process.d.ts

@@ -1,4 +1,4 @@
-import type { StxOptions } from './types';
+import type { StxOptions, StrictModeConfig } from './types';
 /**
  * Process all template directives with enhanced error handling and performance monitoring
  */
@@ -10,4 +10,14 @@ export declare function processJsonDirective(template: string, context: Record<s
 /**
  * Process @once directive blocks
  */
-export declare function processOnceDirective(template: string): string;
+export declare function processOnceDirective(template: string): string;
+/**
+ * Validate client script content for prohibited DOM API patterns.
+ * When strict mode is enabled with `failOnViolation`, throws an error.
+ * Otherwise, emits warnings.
+ *
+ * @param content - The script content to validate
+ * @param filePath - The file path for error reporting
+ * @param strict - Strict mode configuration
+ */
+export declare function validateClientScript(content: string, filePath: string, strict?: boolean | StrictModeConfig): void;

package/dist/production-build.d.ts

@@ -158,42 +158,6 @@ export declare interface AssetInfo {
  * Production Build orchestrator
  */
 export declare class ProductionBuild {
-  private config: ProductionBuildConfig;
-  private startTime: number;
-  private outputs: OutputFile[];
-  private chunks: ChunkInfo[];
-  private assets: AssetInfo[];
-  private warnings: string[];
-  private errors: string[];
-  private moduleGraph: Map<string, Set<string>>;
-  private assetHashes: Map<string, string>;
   constructor(config: ProductionBuildConfig);
   build(): Promise<BuildResult>;
-  private collectEntries(): Map<string, string>;
-  private buildEntry(name: string, entryPath: string): Promise<void>;
-  private resolveRelativePath(from: string, to: string): string;
-  private processTemplate(content: string, filePath: string): Promise<string>;
-  private processCss(content: string, filePath: string): Promise<string>;
-  private processScript(content: string, filePath: string): Promise<string>;
-  private extractCss(): Promise<void>;
-  private processAssets(): Promise<void>;
-  private performCodeSplitting(): Promise<void>;
-  private minifyOutputs(): Promise<void>;
-  private minifyJs(code: string): string;
-  private minifyCss(css: string): string;
-  private minifyHtml(html: string): string;
-  private generateSourceMaps(): Promise<void>;
-  private fingerprintAssets(): Promise<void>;
-  private compressOutputs(): Promise<void>;
-  private analyzeBundle(): Promise<void>;
-  private generateAnalysisHtml(analysis: any): string;
-  private generateAnalysisText(analysis: any): string;
-  private runPluginHook(hook: string, arg?: any): Promise<void>;
-  private runPluginTransform(code: string, id: string): Promise<string>;
-  private generateHash(content: string | Buffer): string;
-  private getOutputName(name: string, type: OutputFile['type'], hash: string): string;
-  private formatSize(bytes: number): string;
-  private ensureDir(dir: string): void;
-  private walkDir(dir: string, callback: (path: string) => void): void;
-  private getResult(): BuildResult;
-}
+}

package/dist/props.d.ts

@@ -140,33 +140,6 @@ export declare interface PropValidationResult {
   errors: PropValidationError[]
   warnings: string[]
 }
-/**
- * STX Props System
- *
- * Provides type-safe component props with runtime validation.
- *
- * @module props
- *
- * @example
- * ```html
- * <script>
- * import { defineProps } from 'stx'
- *
- * const props = defineProps<{
- *   title: string
- *   count?: number
- *   items: string[]
- * }>({
- *   title: { required: true },
- *   count: { default: 0 },
- *   items: { default: () => [] }
- * })
- * </script>
- *
- * <h1>{{ props.title }}</h1>
- * <p>Count: {{ props.count }}</p>
- * ```
- */
 /** Supported prop types */
 export type PropType<T> = | StringConstructor
   | NumberConstructor
@@ -177,7 +150,7 @@ export type PropType<T> = | StringConstructor
   | DateConstructor
   | SymbolConstructor
   | { new (...args: unknown[]): T }
-  | PropType<T>[]
+  | PropType<T>[];
 /** Props definition object */
 export type PropsDefinition<T> = {
   [K in keyof T]?: PropOptions<T[K]> | PropType<T[K]>
@@ -191,9 +164,9 @@ export type ExtractPropTypes<T extends PropsDefinition<unknown>> = {
       : unknown
 }
 /** Event handler type */
-export type EventHandler<T = unknown> = (payload: T) => void
+export type EventHandler<T = unknown> = (payload: T) => void;
 /** Emit function type */
 export type EmitFn<E extends Record<string, unknown>> = <K extends keyof E>(
   event: K,
   payload: E[K],
-) => void
+) => void;

package/dist/pwa/audit.d.ts

@@ -39,4 +39,4 @@ export declare interface AuditResult {
   failed: number
   warnings: number
   checks: AuditCheck[]
-}
+}

package/dist/pwa/directives.d.ts

@@ -26,4 +26,4 @@ export declare const pwaPushDirective: CustomDirective;
 /**
  * All PWA directives
  */
-export declare const pwaDirectives: CustomDirective[];
+export declare const pwaDirectives: CustomDirective[];

package/dist/pwa/icons.d.ts

@@ -18,16 +18,19 @@ export declare function getExpectedIconPaths(config: PwaIconConfig): string[];
 export declare function isSharpAvailable(): Promise<boolean>;
 /**
  * Default icon sizes for PWA
+ * @defaultValue `[72, 96, 128, 144, 152, 192, 384, 512]`
  */
-export declare const DEFAULT_ICON_SIZES: readonly [72, 96, 128, 144, 152, 192, 384, 512];
+export declare const DEFAULT_ICON_SIZES: number[];
 /**
  * Apple touch icon sizes
+ * @defaultValue `[120, 152, 167, 180]`
  */
-export declare const APPLE_TOUCH_ICON_SIZES: readonly [120, 152, 167, 180];
+export declare const APPLE_TOUCH_ICON_SIZES: number[];
 /**
  * Favicon sizes
+ * @defaultValue `[16, 32]`
  */
-export declare const FAVICON_SIZES: readonly [16, 32];
+export declare const FAVICON_SIZES: number[];
 /**
  * Icon generation result
  */
@@ -36,4 +39,4 @@ export declare interface IconGenerationResult {
   generatedFiles: string[]
   errors: string[]
   warnings: string[]
-}
+}

package/dist/pwa/index.d.ts

@@ -1,9 +1,33 @@
+/**
+ * STX PWA Module
+ *
+ * Progressive Web App support including service worker generation,
+ * manifest generation, icon processing, and Workbox integration.
+ *
+ * @module pwa
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   generateServiceWorkerAuto,
+ *   generateManifest,
+ *   generateWorkboxServiceWorker,
+ *   isWorkboxEnabled,
+ * } from 'stx/pwa'
+ * ```
+ */
+// ============================================================================
+// Service Worker
+// ============================================================================
 export {
   generateServiceWorker,
   generateServiceWorkerAuto,
   getServiceWorkerFileName,
   isWorkboxEnabled,
 } from './service-worker';
+// ============================================================================
+// Workbox Integration
+// ============================================================================
 export {
   generateWorkboxConfig,
   generateWorkboxServiceWorker,
@@ -29,31 +53,52 @@ export {
   type WorkboxRoute,
   type RuntimeCachingConfig,
 } from './workbox-strategies';
+// ============================================================================
+// Manifest
+// ============================================================================
 export {
   generateManifest,
 } from './manifest';
+// ============================================================================
+// Icons
+// ============================================================================
 export {
   generatePwaIcons,
   type IconGenerationResult,
 } from './icons';
+// ============================================================================
+// Precache
+// ============================================================================
 export {
   generatePrecacheManifest,
   generatePrecacheManifestJs,
   formatSize,
   type PrecacheEntry,
 } from './precache';
+// ============================================================================
+// Offline
+// ============================================================================
 export {
   generateOfflinePage,
 } from './offline';
+// ============================================================================
+// Injection
+// ============================================================================
 export {
   injectPwaTags,
   generateSwRegistrationScript,
 } from './inject';
+// ============================================================================
+// Audit
+// ============================================================================
 export {
   runPwaAudit,
   type AuditResult,
   type AuditCheck,
 } from './audit';
+// ============================================================================
+// Directives
+// ============================================================================
 export {
   pwaDirectives,
-} from './directives';
+} from './directives';

package/dist/pwa/inject.d.ts

@@ -19,4 +19,4 @@ export declare function generateManifestLink(): string;
 /**
  * Generate theme color meta tag
  */
-export declare function generateThemeColorMeta(color: string): string;
+export declare function generateThemeColorMeta(color: string): string;

package/dist/pwa/manifest.d.ts

@@ -101,4 +101,4 @@ export declare interface WebAppManifest {
   edge_side_panel?: {
     preferred_width?: number
   }
-}
+}

package/dist/pwa/offline.d.ts

@@ -5,4 +5,4 @@ import type { StxOptions } from '../types';
  * If a custom offline page is specified in config, it will be processed.
  * Otherwise, a default styled offline page is generated.
  */
-export declare function generateOfflinePage(options: StxOptions): Promise<string>;
+export declare function generateOfflinePage(options: StxOptions): Promise<string>;

package/dist/pwa/precache.d.ts

@@ -26,4 +26,4 @@ export declare interface PrecacheManifest {
   entries: PrecacheEntry[]
   totalSize: number
   fileCount: number
-}
+}

package/dist/pwa/service-worker.d.ts

@@ -18,4 +18,4 @@ export declare function isWorkboxEnabled(options: StxOptions): boolean;
  * @param outputDir - optional output directory for precache manifest
  * @returns Generated service worker JavaScript code
  */
-export declare function generateServiceWorkerAuto(options: StxOptions, outputDir?: string): string;
+export declare function generateServiceWorkerAuto(options: StxOptions, outputDir?: string): string;

package/dist/pwa/workbox-strategies.d.ts

@@ -97,4 +97,4 @@ export type StxCacheStrategy = | 'cache-first'
   | 'network-first'
   | 'stale-while-revalidate'
   | 'network-only'
-  | 'cache-only'
+  | 'cache-only';

package/dist/pwa/workbox.d.ts

@@ -1,4 +1,3 @@
-import {  } from './workbox-strategies';
 import type { StxOptions } from '../types';
 /**
  * Generate Workbox configuration from stx options
@@ -8,14 +7,6 @@ export declare function generateWorkboxConfig(options: StxOptions, outputDir?: s
  * Generate Workbox service worker JavaScript code
  */
 export declare function generateWorkboxServiceWorker(options: StxOptions, outputDir?: string): string;
-/**
- * Check if Workbox mode is enabled in config
- */
-export declare function isWorkboxEnabled(options: StxOptions): boolean;
-/**
- * Get the appropriate service worker generator based on config
- */
-export declare function getServiceWorkerGenerator(options: StxOptions): (options: StxOptions, outputDir?: string) => string;
 // ============================================================================
 // Types
 // ============================================================================
@@ -49,4 +40,4 @@ export declare interface RuntimeCacheRule {
     }
     networkTimeoutSeconds?: number
   }
-}
+}

package/dist/pwa.d.ts

@@ -48,4 +48,4 @@ export * from './pwa/inject';
 export * from './pwa/manifest';
 export * from './pwa/offline';
 export * from './pwa/precache';
-export * from './pwa/service-worker';
+export * from './pwa/service-worker';