npm - @stacksjs/stx - Versions diffs - 0.2.10 → 0.2.12 - Mend

@stacksjs/stx 0.2.10 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (129) hide show

package/README.md +16 -11
package/dist/a11y.d.ts +2 -1
package/dist/analyzer.d.ts +4 -0
package/dist/app-shell.d.ts +72 -0
package/dist/app.d.ts +1 -0
package/dist/broadcasting.d.ts +77 -0
package/dist/build-assets.d.ts +32 -0
package/dist/build-mode-detector.d.ts +26 -0
package/dist/build.d.ts +31 -0
package/dist/builtins/icon.d.ts +7 -0
package/dist/builtins/index.d.ts +21 -0
package/dist/builtins/stx-image.d.ts +2 -0
package/dist/builtins/stx-link.d.ts +2 -0
package/dist/builtins/stx-loading-indicator.d.ts +2 -0
package/dist/bundle-analyzer/index.d.ts +2 -0
package/dist/bundle-analyzer.js +20 -20
package/dist/caching.d.ts +27 -0
package/dist/cli.js +3942 -2608
package/dist/client-helpers.d.ts +7 -3
package/dist/client-script-bundler.d.ts +27 -0
package/dist/client-script.d.ts +5 -1
package/dist/client.d.ts +1 -0
package/dist/component-hmr.d.ts +1 -0
package/dist/component-processing.d.ts +107 -0
package/dist/component-registry.d.ts +54 -0
package/dist/component-renderer.d.ts +18 -0
package/dist/components/StxImage.stx +12 -0
package/dist/components/StxLink.stx +18 -8
package/dist/composables/index.d.ts +7 -0
package/dist/composables/use-broadcast-channel.d.ts +1 -0
package/dist/composables/use-channel.d.ts +67 -0
package/dist/composables/use-intersection-observer.d.ts +2 -0
package/dist/composables/use-keyboard.d.ts +1 -0
package/dist/composables/use-mouse.d.ts +1 -0
package/dist/composables/use-router.d.ts +4 -0
package/dist/composables/use-websocket.d.ts +1 -0
package/dist/composables.d.ts +2 -0
package/dist/composition-api.d.ts +1 -0
package/dist/computed.d.ts +1 -0
package/dist/config.d.ts +12 -1
package/dist/craft-bridge.d.ts +6 -3
package/dist/craft-components.d.ts +1 -0
package/dist/craft.js +39 -33
package/dist/deploy/index.d.ts +1 -0
package/dist/dev-server/crosswind.d.ts +2 -5
package/dist/dev-server/native-window.d.ts +19 -1
package/dist/dev-server/serve-app.d.ts +15 -0
package/dist/dev-server/serve-file.d.ts +3 -0
package/dist/dev-server/serve-markdown.d.ts +3 -0
package/dist/dev-server/serve-multi.d.ts +5 -0
package/dist/dev-server/types.d.ts +2 -0
package/dist/dev-server.d.ts +6 -40
package/dist/devtools.d.ts +1 -0
package/dist/directive-api.d.ts +1 -1
package/dist/document-shell.d.ts +33 -0
package/dist/error-boundaries.d.ts +1 -0
package/dist/events.d.ts +1 -0
package/dist/expressions.d.ts +38 -0
package/dist/forms-validation.d.ts +2 -0
package/dist/head.d.ts +1 -0
package/dist/hot-reload.d.ts +1 -0
package/dist/hydration-runtime.d.ts +1 -0
package/dist/hydration.d.ts +1 -0
package/dist/i18n.d.ts +3 -1
package/dist/image-optimization/build-plugin.d.ts +1 -0
package/dist/index.d.ts +22 -1
package/dist/index.js +5571 -4182
package/dist/inline-assets.d.ts +28 -0
package/dist/internal-markdown.d.ts +0 -4
package/dist/jsx-runtime.d.ts +1 -0
package/dist/keep-alive.d.ts +1 -0
package/dist/manifest.d.ts +41 -0
package/dist/markdown.d.ts +1 -0
package/dist/media/client/blur-up.d.ts +1 -0
package/dist/media/client/lazy-load.d.ts +1 -0
package/dist/media/client/upload-handler.d.ts +1 -0
package/dist/media/shared/cache.d.ts +2 -0
package/dist/media/video/index.d.ts +1 -0
package/dist/media/video/processor/thumbnail.d.ts +1 -0
package/dist/misc-directives.d.ts +49 -0
package/dist/parser/directive-parser.d.ts +13 -0
package/dist/performance-utils.d.ts +2 -0
package/dist/placeholder.d.ts +45 -0
package/dist/plugin-system.d.ts +32 -2
package/dist/process.d.ts +11 -1
package/dist/production-builder.d.ts +42 -0
package/dist/production-server.d.ts +19 -0
package/dist/props.d.ts +1 -0
package/dist/pwa.js +3883 -2679
package/dist/reactive.d.ts +2 -16
package/dist/reactivity.d.ts +1 -0
package/dist/render.d.ts +2 -1
package/dist/router.d.ts +1 -1
package/dist/runtime-injection.d.ts +20 -0
package/dist/runtime.d.ts +2 -2
package/dist/script-classifier.d.ts +35 -0
package/dist/script-validation.d.ts +16 -0
package/dist/server-bindings.d.ts +7 -0
package/dist/server-components.d.ts +4 -0
package/dist/signal-processing.d.ts +109 -0
package/dist/signals-api.d.ts +309 -0
package/dist/signals.d.ts +2 -309
package/dist/spa-shell.d.ts +1 -0
package/dist/ssg.js +3862 -2655
package/dist/ssr.d.ts +1 -0
package/dist/state-management.d.ts +27 -0
package/dist/store-imports.d.ts +24 -0
package/dist/store-loader.d.ts +16 -0
package/dist/story/bun-test.d.ts +1 -0
package/dist/story/compiled-output.d.ts +1 -0
package/dist/story/interactions.d.ts +1 -0
package/dist/story/renderer.d.ts +2 -0
package/dist/story/setup.d.ts +1 -0
package/dist/story/ui/code-panel.d.ts +1 -0
package/dist/stx.d.ts +437 -0
package/dist/style-scoping.d.ts +23 -0
package/dist/template-compiler.d.ts +31 -0
package/dist/template-hydrator.d.ts +18 -0
package/dist/transitions.d.ts +1 -0
package/dist/types/config-types.d.ts +62 -0
package/dist/validator.d.ts +1 -0
package/dist/variable-extractor.d.ts +1 -1
package/dist/view-composers.d.ts +1 -0
package/dist/virtual-scrolling.d.ts +1 -0
package/dist/visual-testing.js +2 -2
package/dist/web-components.d.ts +1 -0
package/dist/x-element.d.ts +1 -0
package/package.json +19 -7
package/stx.d.ts +437 -0

package/README.md CHANGED Viewed

@@ -728,25 +728,30 @@ Web components support several configuration options:
 ## TypeScript Support
-stx includes TypeScript declarations for importing .stx files. Make sure your `tsconfig.json` includes the necessary configuration:
+stx ships its TypeScript declarations as part of the package. As soon as
+`@stacksjs/stx` is installed, TypeScript automatically picks up:
+- `*.stx` and `*.md` module declarations (so `.stx` imports typecheck)
+- Ambient runtime globals injected into `<script client>` blocks: `state`,
+  `derived`, `effect`, `batch`, `onMount`, `onDestroy`, `defineStore`,
+  `useStore`, `useHead`, `useSeoMeta`, `navigate`, `useRoute`, etc.
+- The `window.stx` registry interface
+You do **not** need to create your own `stx.d.ts`. Just include `.stx`
+files in your `tsconfig.json`:
 ```jsonc
 {
   "compilerOptions": {
-    // ... your other options
-    "types": ["bun"]
+    "types": ["bun"],
+    "moduleResolution": "bundler"
   },
-  "files": ["src/stx.d.ts"],
-  "include": ["**/*.ts", "**/*.d.ts", "*.stx", "./**/*.stx"]
+  "include": ["**/*.ts", "**/*.stx"]
 }
 ```
-Create a declaration file (`src/stx.d.ts`):
-```ts
-// Allow importing .stx files
-declare module '*.stx';
-```
+If you have an old `stx.d.ts` from a previous version declaring `*.stx`
+or runtime globals, it's now redundant and can be deleted.
 ## Example Server

package/dist/a11y.d.ts CHANGED Viewed

@@ -19,7 +19,8 @@ export declare function getScreenReaderOnlyStyle(): string;
  * ```typescript
  * if (hasDOMSupport()) {
  *   console.log('Using full DOM-based a11y checking')
- * } else {
+ * }
+else {
  *   console.log('Using regex-based a11y checking (limited)')
  * }
  * ```

package/dist/analyzer.d.ts CHANGED Viewed

@@ -5,10 +5,14 @@ export declare function analyzeTemplate(filePath: string): Promise<AnalysisResul
 /**
  * Analyze multiple templates
  */
+// eslint-disable-next-line pickier/no-unused-vars
 export declare function analyzeProject(patterns?: string[], cwd?: string): Promise<{
   results: AnalysisResult[]
   summary: ProjectSummary
 }>;
+/**
+ * stx Template Analyzer - Analyze templates for performance, best practices, and potential issues
+ */
 export declare interface AnalysisResult {
   file: string
   metrics: TemplateMetrics

package/dist/app-shell.d.ts ADDED Viewed

@@ -0,0 +1,72 @@
+import type { StxOptions } from './types';
+/**
+ * Detect an app shell file in the given directory.
+ *
+ * @deprecated Use `layouts/default.stx` instead. The framework now auto-generates
+ * the document shell from `stx.config.ts` `app.head` configuration.
+ * The app.stx shell pattern is kept for backwards compatibility.
+ *
+ * Checks for `app.stx` in the project root (or configured shell path).
+ * Returns the absolute path if found, null otherwise.
+ */
+export declare function detectShell(appDir: string, shellConfig?: string | false): string | null;
+/**
+ * Process the app shell template and split it at the `<slot />` injection point.
+ *
+ * The shell is processed through `processDirectives()` with a placeholder
+ * for the slot, then split into before/after parts for fast page composition.
+ */
+export declare function processShell(shellPath: string, options: StxOptions): Promise<ProcessedShell | null>;
+/**
+ * Compose a full page by injecting page content into the processed shell.
+ *
+ * Wraps the page content in a document structure with the shell's layout,
+ * shell scripts, shell styles, and the router.
+ */
+export declare function composeShellWithPage(shell: ProcessedShell, pageContent: string, pageTitle?: string): string;
+/**
+ * Strip document wrapper (DOCTYPE, html, head, body) from page content,
+ * returning just the body content as a fragment.
+ *
+ * If the content has no document wrapper, it's returned as-is.
+ *
+ * Preserves:
+ * - `<script>` tags from `<body>` (page scripts)
+ * - `<style>` tags from `<head>` (page styles, moved to fragment)
+ * - Body content
+ *
+ * Strips:
+ * - `<!DOCTYPE>`, `<html>`, `<head>`, `<body>` wrappers
+ * - `<meta>`, `<title>`, `<link>` tags from `<head>`
+ */
+export declare function stripDocumentWrapper(html: string): string;
+/**
+ * Check if a request is an SPA navigation request (from the stx router).
+ */
+export declare function isSpaNavigation(request: Request): boolean;
+/**
+ * Extract the inner content of the router container element from a full HTML
+ * document, preserving any `<style>` tags found in `<head>`.
+ *
+ * This is what fragment files should contain — NOT the whole body. The SPA
+ * router injects fragments directly into the container element via innerHTML,
+ * so the fragment must already match the shape of the container's content.
+ * If you pass it the whole body (nav + main + footer), the router will dump
+ * all of that inside `<main>`, producing a duplicated nav.
+ *
+ * Falls back to `stripDocumentWrapper` if the container cannot be located.
+ *
+ * @param html - Full HTML document (with or without doctype/html/head/body)
+ * @param containerSelector - Tag name or selector for the router container (e.g. `main`)
+ */
+export declare function extractContainerContent(html: string, containerSelector?: string): string;
+/**
+ * Processed shell ready for page injection
+ */
+export declare interface ProcessedShell {
+  beforeSlot: string
+  afterSlot: string
+  filePath: string
+  shellScripts: string[]
+  shellStyles: string[]
+}

package/dist/app.d.ts CHANGED Viewed

@@ -61,4 +61,5 @@ export declare interface StxAppConfig {
   }
 }
 /** Plugin can be an object with install() or a plain function */
+// eslint-disable-next-line pickier/no-unused-vars
 export type StxPluginInput = StxAppPlugin | ((app: StxApp, ...options: any[]) => void);

package/dist/broadcasting.d.ts ADDED Viewed

@@ -0,0 +1,77 @@
+import { Broadcast, BroadcastServer, type ServerConfig } from 'ts-broadcasting';
+import type { BroadcastingConfig } from './types/config-types';
+export type {
+  ServerConfig,
+} from 'ts-broadcasting';
+/**
+ * Get the active BroadcastServer instance (or null if not started).
+ */
+export declare function getBroadcastServer(): BroadcastServer | null;
+/**
+ * Start the broadcasting WebSocket server.
+ *
+ * Called automatically by the stx dev-server when `broadcasting.enabled`
+ * is true in stx.config.ts. You normally don't need to call this yourself.
+ */
+export declare function startBroadcasting(config: BroadcastingConfig): Promise<BroadcastServer>;
+/**
+ * Stop the broadcasting server and clean up resources.
+ */
+export declare function stopBroadcasting(): Promise<void>;
+/**
+ * Load and execute a `routes/channels.ts` file, wiring up every
+ * channel definition to the running broadcasting server.
+ *
+ * Called automatically by the stx dev-server after `startBroadcasting()`.
+ */
+export declare function loadChannels(channelsPath: string): Promise<number>;
+/**
+ * Broadcast an event to a channel (or multiple channels).
+ *
+ * @example
+ * ```ts
+ * broadcast('chat', 'message.sent', { text: 'Hello!' })
+ * broadcast(['chat', 'admin'], 'alert', { level: 'warn' })
+ * ```
+ */
+export declare function broadcast<T = unknown>(channels: string | string[], event: string, data: T): void;
+/**
+ * Broadcast to a specific user's private channel.
+ *
+ * @example
+ * ```ts
+ * toUser(42, 'notification', { title: 'You have mail' })
+ * ```
+ */
+export declare function toUser<T = unknown>(userId: string | number, event: string, data: T): void;
+/**
+ * Broadcast to multiple users.
+ */
+export declare function toUsers<T = unknown>(userIds: Array<string | number>, event: string, data: T): void;
+/**
+ * Broadcast to a private channel.
+ */
+export declare function broadcastPrivate<T = unknown>(channelName: string, event: string, data: T): void;
+/**
+ * Broadcast to a presence channel.
+ */
+export declare function broadcastPresence<T = unknown>(channelName: string, event: string, data: T): void;
+// ── Types ──────────────────────────────────────────────────────
+export declare interface ChannelDefinition<T = unknown> {
+  event?: string
+  interval?: number
+  data?: () => T | Promise<T>
+  authorize?: (socket: any, params: Record<string, string>) => boolean | object | Promise<boolean | object>
+}
+export declare interface ChannelRegistrar {
+  channel: <T = unknown>(name: string, definition: ChannelDefinition<T>) => void
+}
+/**
+ * Register channel authorization (ad-hoc, outside routes/channels.ts).
+ */
+export { channel } from 'ts-broadcasting';
+// ── Re-exports for advanced usage ──────────────────────────────
+export {
+  Broadcast,
+  BroadcastServer,
+} from 'ts-broadcasting';

package/dist/build-assets.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+/**
+ * Generate a fingerprint hash from content.
+ * Uses SHA-256 truncated to 8 hex chars.
+ */
+export declare function fingerprint(content: string): string;
+/**
+ * Build the signals runtime as an external asset.
+ * This is identical for every page — no need to inline 20-40KB per page.
+ */
+export declare function buildRuntimeAsset(debug?: boolean): BuiltAsset;
+/**
+ * Build the SPA router script as an external asset.
+ * Identical for every page — ~5-8KB.
+ */
+export declare function buildRouterAsset(): BuiltAsset;
+/**
+ * Generates `<script src>` and `<link href>` tags for externalized assets.
+ * Used in build mode to replace inline scripts with references.
+ */
+export declare function assetTags(assets: { runtime?: BuiltAsset, router?: BuiltAsset, css?: BuiltAsset }): {
+  runtimeTag: string
+  routerTag: string
+  cssTag: string
+};
+/**
+ * A built asset with content and fingerprinted filename.
+ */
+export declare interface BuiltAsset {
+  content: string
+  filename: string
+  hash: string
+}

package/dist/build-mode-detector.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+/**
+ * Scan all `.stx` files in the project and determine the build mode.
+ *
+ * - Zero `<script server>` tags → `'ssg'` (static site, flat HTML in `dist/`)
+ * - Any `<script server>` tag  → `'ssr'` (server bundle in `.output/`)
+ */
+export declare function detectBuildMode(root?: string): Promise<BuildModeDetectionResult>;
+/**
+ * Validate that components don't mix `<script server>` and `<script client>`.
+ *
+ * Components should be server OR client — compose them via props/slots.
+ * Pages are allowed to have both (e.g. `<script server>` for SEO +
+ * `<script client>` for interactivity).
+ */
+export declare function validateComponentScripts(root?: string): Promise<ComponentValidationError[]>;
+export declare interface BuildModeDetectionResult {
+  mode: BuildMode
+  serverScriptFiles: string[]
+  totalFilesScanned: number
+  scanDurationMs: number
+}
+export declare interface ComponentValidationError {
+  file: string
+  message: string
+}
+export type BuildMode = 'ssg' | 'ssr';

package/dist/build.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import type { BuildMode } from './build-mode-detector';
+import type { ProductionBuildOptions, ProductionBuildResult } from './production-builder';
+import type { SSGConfig, SSGResult } from './ssg';
+/**
+ * Unified build entry point for stx applications.
+ *
+ * Build mode is determined by the `ssr` field in `stx.config.ts`:
+ *
+ * - **`ssr: false`** (default) → SSG → `dist/` (flat HTML files for S3 + CloudFront).
+ *   `<script server>` blocks are executed at build time and their output is
+ *   baked into the static HTML. The server block is stripped from the output.
+ *
+ * - **`ssr: true`** → SSR → `.output/` (server bundle for EC2 behind CloudFront).
+ *   `<script server>` blocks run per-request on the Bun server.
+ *
+ * `<script server>` works in both modes — the `ssr` flag controls *when* it
+ * runs (build time vs request time), not whether it's allowed.
+ */
+export declare function buildApp(options?: UnifiedBuildOptions): Promise<UnifiedBuildResult>;
+export declare interface UnifiedBuildOptions {
+  root?: string
+  debug?: boolean
+  ssg?: Partial<SSGConfig>
+  ssr?: Partial<ProductionBuildOptions>
+}
+export declare interface UnifiedBuildResult {
+  mode: BuildMode
+  ssg?: SSGResult
+  ssr?: ProductionBuildResult
+  duration: number
+}

package/dist/builtins/icon.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import type { BuiltinComponentDef } from '../component-registry';
+/**
+ * Pre-load icon collections so they're available synchronously during render.
+ * Call this before template processing starts.
+ */
+export declare function preloadIconCollection(prefix?: string): Promise<void>;
+export declare const IconBuiltin: BuiltinComponentDef;

package/dist/builtins/index.d.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import { IconBuiltin } from './icon';
+import { StxImageBuiltin } from './stx-image';
+import { StxLinkBuiltin } from './stx-link';
+import { StxLoadingIndicatorBuiltin } from './stx-loading-indicator';
+/**
+ * Register all builtin components with the singleton registry.
+ * Call this once during framework initialization.
+ */
+export declare function registerBuiltins(): void;
+/**
+ * Builtin Components Barrel
+ *
+ * Re-exports all builtin component definitions and provides a
+ * convenience function to register them with the component registry.
+ *
+ * @module builtins
+ */
+export { StxLinkBuiltin } from './stx-link';
+export { StxImageBuiltin } from './stx-image';
+export { StxLoadingIndicatorBuiltin } from './stx-loading-indicator';
+export { IconBuiltin, preloadIconCollection } from './icon';

package/dist/builtins/stx-image.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { BuiltinComponentDef } from '../component-registry';
2	+ export declare const StxImageBuiltin: BuiltinComponentDef;

package/dist/builtins/stx-link.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { BuiltinComponentDef } from '../component-registry';
2	+ export declare const StxLinkBuiltin: BuiltinComponentDef;

package/dist/builtins/stx-loading-indicator.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { BuiltinComponentDef } from '../component-registry';
2	+ export declare const StxLoadingIndicatorBuiltin: BuiltinComponentDef;

package/dist/bundle-analyzer/index.d.ts CHANGED Viewed

@@ -4,6 +4,7 @@ import { generateTreemap, openInBrowser, type TreemapOptions } from './treemap';
 /**
  * Analyze a bundle directory and generate a report
  */
+// eslint-disable-next-line pickier/no-unused-vars
 export declare function analyze(options?: AnalyzeOptions): Promise<{
   stats: ReturnType<typeof collectBundleStats> extends Promise<infer T> ? T : never
   report: string
@@ -13,6 +14,7 @@ export declare function analyze(options?: AnalyzeOptions): Promise<{
 /**
  * Quick summary of bundle size
  */
+// eslint-disable-next-line pickier/no-unused-vars
 export declare function getBundleSummary(directory: string): Promise<{
   totalSize: number
   totalSizeFormatted: string

package/dist/bundle-analyzer.js CHANGED Viewed

@@ -1,12 +1,12 @@
 // @bun
-import v from"fs";import H from"path";import{gzipSync as z}from"zlib";import{createHash as g}from"crypto";var D={".js":"js",".mjs":"js",".cjs":"js",".ts":"js",".jsx":"js",".tsx":"js",".css":"css",".scss":"css",".sass":"css",".less":"css",".html":"html",".htm":"html",".png":"image",".jpg":"image",".jpeg":"image",".gif":"image",".svg":"image",".webp":"image",".avif":"image",".ico":"image",".woff":"font",".woff2":"font",".ttf":"font",".eot":"font",".otf":"font"},b=[/node_modules/,/vendor/,/bower_components/,/\.min\./],B=[/index\.(js|ts|html)$/,/main\.(js|ts)$/,/app\.(js|ts)$/,/entry\.(js|ts)$/];async function L(Z,$={}){let{includeSourceMaps:X=!1,parseImports:j=!0,detectDuplicates:U=!0,topModulesCount:Q=20}=$;if(!v.existsSync(Z))throw Error(`Build directory not found: ${Z}`);if(!v.statSync(Z).isDirectory())throw Error(`Not a directory: ${Z}`);let K=await k(Z,X),J=[],F=[];for(let A of K)try{let O=await f(A,Z,j);J.push(O)}catch(O){F.push(`Failed to process ${A}: ${O}`)}let Y=c(J,Z),V=J.reduce((A,O)=>A+O.size,0),_=J.reduce((A,O)=>A+O.gzipSize,0),w=m(J),G=U?p(J):[],C=[...J].sort((A,O)=>O.size-A.size).slice(0,Q);return{timestamp:Date.now(),buildDir:H.resolve(Z),chunks:Y,totalSize:V,totalGzipSize:_,moduleCount:J.length,duplicates:G,byType:w,largestModules:C,warnings:F}}async function k(Z,$){let X=[];async function j(U){let Q=await v.promises.readdir(U,{withFileTypes:!0});for(let q of Q){let K=H.join(U,q.name);if(q.isDirectory()){if(!q.name.startsWith(".")&&q.name!=="node_modules")await j(K)}else if(q.isFile()){if(!$&&q.name.endsWith(".map"))continue;X.push(K)}}}return await j(Z),X}async function f(Z,$,X){let j=await v.promises.readFile(Z),U=H.relative($,Z),Q=H.extname(Z).toLowerCase(),q=j.length,K=y(j),J=h(j,Q),F=g("md5").update(j).digest("hex").slice(0,8),Y=D[Q]||"other",V=[];if(X&&Y==="js")V.push(...d(j.toString("utf-8")));return{id:U,path:U,size:q,gzipSize:K,parsedSize:J,extension:Q,type:Y,imports:V,importedBy:[],hash:F}}function y(Z){try{let $=z(Z,{level:9}).length;return Math.min($,Z.length)}catch{return Z.length}}function h(Z,$){if($.includes(".min.")||Z.length<1000)return Z.length;let j=D[$];if(j==="js")return Math.round(Z.length*0.6);if(j==="css")return Math.round(Z.length*0.7);return Z.length}function d(Z){let $=[],X=/import\s+(?:[\w*{}\s,]+\s+from\s+)?['"]([^'"]+)['"]/g,j;while((j=X.exec(Z))!==null)$.push(j[1]);let U=/import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;while((j=U.exec(Z))!==null)$.push(j[1]);let Q=/require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;while((j=Q.exec(Z))!==null)$.push(j[1]);return[...new Set($)]}function c(Z,$){let X=new Map;for(let U of Z){let Q=U.path.split(H.sep),q;if(Q.length===1)q=H.basename(U.path,U.extension);else q=Q[0];let K=X.get(q)||[];K.push(U),X.set(q,K)}let j=[];for(let[U,Q]of X){let q=Q.reduce((Y,V)=>Y+V.size,0),K=Q.reduce((Y,V)=>Y+V.gzipSize,0),J=Q.some((Y)=>B.some((V)=>V.test(Y.path))),F=Q.some((Y)=>b.some((V)=>V.test(Y.path)));j.push({name:U,files:Q.map((Y)=>Y.path),modules:Q,size:q,gzipSize:K,isEntry:J,isVendor:F})}return j.sort((U,Q)=>Q.size-U.size)}function m(Z){let $={js:{count:0,size:0,gzipSize:0},css:{count:0,size:0,gzipSize:0},html:{count:0,size:0,gzipSize:0},image:{count:0,size:0,gzipSize:0},font:{count:0,size:0,gzipSize:0},other:{count:0,size:0,gzipSize:0}};for(let X of Z)$[X.type].count++,$[X.type].size+=X.size,$[X.type].gzipSize+=X.gzipSize;return $}function p(Z){let $=new Map;for(let j of Z){let U=$.get(j.hash)||[];U.push(j),$.set(j.hash,U)}let X=[];for(let[,j]of $)if(j.length>1){let U=j[0];X.push({path:U.path,count:j.length,wastedBytes:U.size*(j.length-1),locations:j.map((Q)=>Q.path)})}return X.sort((j,U)=>U.wastedBytes-j.wastedBytes)}function W(Z){if(Z<1024)return`${Z} B`;if(Z<1048576)return`${(Z/1024).toFixed(2)} KB`;return`${(Z/1048576).toFixed(2)} MB`}function I(Z){let $=Z.match(/^([\d.]+)\s*(B|KB|MB|GB)?$/i);if(!$)return 0;let X=Number.parseFloat($[1]);switch(($[2]||"B").toUpperCase()){case"KB":return X*1024;case"MB":return X*1024*1024;case"GB":return X*1024*1024*1024;default:return X}}function E(Z,$){if($===0)return"0%";return`${(Z/$*100).toFixed(1)}%`}function x(Z,$){switch($.format){case"json":return u(Z,$);case"markdown":return l(Z,$);case"text":default:return r(Z,$)}}function u(Z,$){let X=N(Z,$);return JSON.stringify({timestamp:Z.timestamp,buildDir:Z.buildDir,summary:{totalSize:Z.totalSize,totalSizeFormatted:W(Z.totalSize),totalGzipSize:Z.totalGzipSize,totalGzipSizeFormatted:W(Z.totalGzipSize),moduleCount:Z.moduleCount,chunkCount:Z.chunks.length,duplicateCount:Z.duplicates.length},byType:Object.fromEntries(Object.entries(Z.byType).map(([j,U])=>[j,{...U,sizeFormatted:W(U.size),gzipSizeFormatted:W(U.gzipSize)}])),chunks:Z.chunks.map((j)=>({name:j.name,size:j.size,sizeFormatted:W(j.size),gzipSize:j.gzipSize,gzipSizeFormatted:W(j.gzipSize),moduleCount:j.modules.length,isEntry:j.isEntry,isVendor:j.isVendor})),largestModules:Z.largestModules.slice(0,$.topModules||10).map((j)=>({path:j.path,size:j.size,sizeFormatted:W(j.size),gzipSize:j.gzipSize,gzipSizeFormatted:W(j.gzipSize),type:j.type})),duplicates:Z.duplicates,analysis:X,warnings:Z.warnings},null,2)}function r(Z,$){let X=[],j=$.showGzip!==!1;if(X.push(""),X.push("Bundle Analysis Report"),X.push("\u2550".repeat(50)),X.push(""),X.push("Summary"),X.push("\u2500".repeat(50)),j)X.push(`Total Size:     ${W(Z.totalSize)} (${W(Z.totalGzipSize)} gzip)`);else X.push(`Total Size:     ${W(Z.totalSize)}`);if(X.push(`Modules:        ${Z.moduleCount}`),X.push(`Chunks:         ${Z.chunks.length}`),Z.duplicates.length>0)X.push(`Duplicates:     ${Z.duplicates.length}`);if(X.push(""),$.threshold&&Z.totalSize>$.threshold)X.push(`\u26A0\uFE0F  Bundle exceeds threshold of ${W($.threshold)}!`),X.push("");X.push("Size by Type"),X.push("\u2500".repeat(50));let U=["js","css","html","image","font","other"];for(let q of U){let K=Z.byType[q];if(K.count>0){let J=E(K.size,Z.totalSize),F=j?` (${W(K.gzipSize)} gzip)`:"";X.push(`  ${q.padEnd(8)} ${W(K.size).padStart(12)}${F}  ${J.padStart(6)}  (${K.count} files)`)}}X.push(""),X.push("Chunks"),X.push("\u2500".repeat(50));for(let q of Z.chunks.slice(0,10)){let K=[];if(q.isEntry)K.push("entry");if(q.isVendor)K.push("vendor");let J=K.length>0?` [${K.join(", ")}]`:"",F=j?` (${W(q.gzipSize)} gzip)`:"";X.push(`  ${q.name.padEnd(20)} ${W(q.size).padStart(12)}${F}${J}`)}if(Z.chunks.length>10)X.push(`  ... and ${Z.chunks.length-10} more chunks`);X.push("");let Q=$.topModules||10;X.push(`Largest Modules (Top ${Q})`),X.push("\u2500".repeat(50));for(let q=0;q<Math.min(Q,Z.largestModules.length);q++){let K=Z.largestModules[q],J=j?` (${W(K.gzipSize)} gzip)`:"";X.push(`  ${(q+1).toString().padStart(2)}. ${K.path}`),X.push(`      ${W(K.size)}${J}`)}if(X.push(""),Z.duplicates.length>0){X.push("Duplicate Modules"),X.push("\u2500".repeat(50));for(let q of Z.duplicates.slice(0,5))X.push(`  ${q.path}`),X.push(`    ${q.count} copies, wasting ${W(q.wastedBytes)}`);if(Z.duplicates.length>5)X.push(`  ... and ${Z.duplicates.length-5} more duplicates`);X.push("")}if($.recommendations!==!1){let q=N(Z,$);if(q.recommendations.length>0){X.push("Recommendations"),X.push("\u2500".repeat(50));for(let K of q.recommendations.slice(0,5)){let J=K.impact==="high"?"\u26A1":K.impact==="medium"?"\uD83D\uDCCA":"\uD83D\uDCA1";X.push(`  ${J} ${K.title}`),X.push(`    ${K.description}`)}X.push("")}}if(Z.warnings.length>0){X.push("Warnings"),X.push("\u2500".repeat(50));for(let q of Z.warnings)X.push(`  \u26A0\uFE0F  ${q}`);X.push("")}return X.join(`
-`)}function l(Z,$){let X=[],j=$.showGzip!==!1;if(X.push("# Bundle Analysis Report"),X.push(""),X.push(`Generated: ${new Date(Z.timestamp).toISOString()}`),X.push(""),X.push("## Summary"),X.push(""),X.push("| Metric | Value |"),X.push("|--------|-------|"),X.push(`| Total Size | ${W(Z.totalSize)} |`),j)X.push(`| Gzip Size | ${W(Z.totalGzipSize)} |`);X.push(`| Modules | ${Z.moduleCount} |`),X.push(`| Chunks | ${Z.chunks.length} |`),X.push(`| Duplicates | ${Z.duplicates.length} |`),X.push(""),X.push("## Size by Type"),X.push(""),X.push("| Type | Size | Gzip | % | Files |"),X.push("|------|------|------|---|-------|");let U=["js","css","html","image","font","other"];for(let q of U){let K=Z.byType[q];if(K.count>0)X.push(`| ${q} | ${W(K.size)} | ${W(K.gzipSize)} | ${E(K.size,Z.totalSize)} | ${K.count} |`)}X.push(""),X.push("## Chunks"),X.push(""),X.push("| Name | Size | Gzip | Modules | Type |"),X.push("|------|------|------|---------|------|");for(let q of Z.chunks.slice(0,15)){let K=q.isEntry?"Entry":q.isVendor?"Vendor":"-";X.push(`| ${q.name} | ${W(q.size)} | ${W(q.gzipSize)} | ${q.modules.length} | ${K} |`)}X.push("");let Q=$.topModules||10;X.push(`## Largest Modules (Top ${Q})`),X.push(""),X.push("| # | Path | Size | Gzip |"),X.push("|---|------|------|------|");for(let q=0;q<Math.min(Q,Z.largestModules.length);q++){let K=Z.largestModules[q];X.push(`| ${q+1} | \`${K.path}\` | ${W(K.size)} | ${W(K.gzipSize)} |`)}if(X.push(""),Z.duplicates.length>0){X.push("## Duplicates"),X.push(""),X.push("| Path | Copies | Wasted |"),X.push("|------|--------|--------|");for(let q of Z.duplicates.slice(0,10))X.push(`| \`${q.path}\` | ${q.count} | ${W(q.wastedBytes)} |`);X.push("")}if($.recommendations!==!1){let q=N(Z,$);if(q.recommendations.length>0){X.push("## Recommendations"),X.push("");for(let K of q.recommendations)X.push(`### ${K.title}`),X.push(""),X.push(K.description),X.push(""),X.push(`- **Impact:** ${K.impact}`),X.push(`- **Effort:** ${K.effort}`),X.push("")}}return X.join(`
-`)}function N(Z,$){let X=[],j=[];if($.threshold&&Z.totalSize>$.threshold)X.push({severity:"error",message:`Bundle size (${W(Z.totalSize)}) exceeds threshold (${W($.threshold)})`});if(Z.totalSize>1048576)X.push({severity:"warning",message:`Bundle is over 1MB (${W(Z.totalSize)})`,details:"Large bundles can significantly impact load time"});if(Z.duplicates.length>0){let K=Z.duplicates.reduce((J,F)=>J+F.wastedBytes,0);X.push({severity:"warning",message:`${Z.duplicates.length} duplicate modules found, wasting ${W(K)}`}),j.push({title:"Remove Duplicate Modules",description:"Consider using import aliases or ensuring consistent package versions to eliminate duplicates.",impact:"medium",effort:"low"})}if(Z.byType.js.size/Z.totalSize>0.8&&Z.totalSize>512000)j.push({title:"Code Splitting",description:"Over 80% of your bundle is JavaScript. Consider splitting code by route or feature.",impact:"high",effort:"medium"});let Q=Z.largestModules.filter((K)=>K.size>102400);if(Q.length>0){X.push({severity:"info",message:`${Q.length} modules are over 100KB`});for(let K of Q){if(K.path.includes("lodash")&&!K.path.includes("lodash-es"))j.push({title:"Use lodash-es instead of lodash",description:"lodash-es supports tree-shaking and can significantly reduce bundle size.",impact:"high",effort:"low"});if(K.path.includes("moment"))j.push({title:"Replace moment.js",description:"Consider using date-fns or dayjs for smaller date handling libraries.",impact:"high",effort:"medium"})}}if(Z.byType.image.size>512000)j.push({title:"Optimize Images",description:`Images account for ${W(Z.byType.image.size)}. Consider using WebP/AVIF formats and responsive images.`,impact:"high",effort:"low"});let q=100;if(Z.totalSize>1048576)q-=20;else if(Z.totalSize>512000)q-=10;if(q-=Math.min(20,Z.duplicates.length*2),q-=Math.min(15,Q.length*3),$.threshold&&Z.totalSize>$.threshold)q-=25;return{score:Math.max(0,q),issues:X,recommendations:j}}var i={lodash:{alternative:"lodash-es or individual imports",savings:"~70%"},moment:{alternative:"date-fns or dayjs",savings:"~90%"},"chart.js":{alternative:"chart.js with tree-shaking",savings:"~50%"},"highlight.js":{alternative:"Selective language imports",savings:"~80%"},fontawesome:{alternative:"Individual icon imports",savings:"~90%"},"material-ui":{alternative:"Named imports from @mui/*",savings:"~60%"}};function n(Z){for(let[$,X]of Object.entries(i))if(Z.includes($))return{title:`Optimize ${$}`,description:`Consider using ${X.alternative}. Potential savings: ${X.savings}`,impact:"high",effort:"low"};return null}var o={default:{js:"#f7df1e",css:"#264de4",html:"#e34c26",image:"#4caf50",font:"#9c27b0",other:"#607d8b",vendor:"#ff5722"},pastel:{js:"#fff3b0",css:"#b0d4ff",html:"#ffb0b0",image:"#b0ffb0",font:"#e0b0ff",other:"#d0d0d0",vendor:"#ffcfb0"},monochrome:{js:"#333333",css:"#555555",html:"#777777",image:"#999999",font:"#bbbbbb",other:"#dddddd",vendor:"#444444"}};function R(Z,$={}){let{title:X="Bundle Analysis",gzip:j=!0,colorScheme:U="default"}=$,Q=o[U],q=a(Z),K=JSON.stringify(q);return`<!DOCTYPE html>
+import v from"fs";import H from"path";import{gzipSync as z}from"zlib";import{createHash as g}from"crypto";var D={".js":"js",".mjs":"js",".cjs":"js",".ts":"js",".jsx":"js",".tsx":"js",".css":"css",".scss":"css",".sass":"css",".less":"css",".html":"html",".htm":"html",".png":"image",".jpg":"image",".jpeg":"image",".gif":"image",".svg":"image",".webp":"image",".avif":"image",".ico":"image",".woff":"font",".woff2":"font",".ttf":"font",".eot":"font",".otf":"font"},b=[/node_modules/,/vendor/,/bower_components/,/\.min\./],B=[/index\.(js|ts|html)$/,/main\.(js|ts)$/,/app\.(js|ts)$/,/entry\.(js|ts)$/];async function L(X,Z={}){let{includeSourceMaps:Q=!1,parseImports:$=!0,detectDuplicates:U=!0,topModulesCount:K=20}=Z;if(!v.existsSync(X))throw Error(`Build directory not found: ${X}`);if(!v.statSync(X).isDirectory())throw Error(`Not a directory: ${X}`);let q=await k(X,Q),J=[],F=[];for(let A of q)try{let O=await f(A,X,$);J.push(O)}catch(O){F.push(`Failed to process ${A}: ${O}`)}let Y=c(J,X),V=J.reduce((A,O)=>A+O.size,0),_=J.reduce((A,O)=>A+O.gzipSize,0),w=m(J),G=U?p(J):[],C=[...J].sort((A,O)=>O.size-A.size).slice(0,K);return{timestamp:Date.now(),buildDir:H.resolve(X),chunks:Y,totalSize:V,totalGzipSize:_,moduleCount:J.length,duplicates:G,byType:w,largestModules:C,warnings:F}}async function k(X,Z){let Q=[];async function $(U){let K=await v.promises.readdir(U,{withFileTypes:!0});for(let j of K){let q=H.join(U,j.name);if(j.isDirectory()){if(!j.name.startsWith(".")&&j.name!=="node_modules")await $(q)}else if(j.isFile()){if(!Z&&j.name.endsWith(".map"))continue;Q.push(q)}}}return await $(X),Q}async function f(X,Z,Q){let $=await v.promises.readFile(X),U=H.relative(Z,X),K=H.extname(X).toLowerCase(),j=$.length,q=y($),J=h($,K),F=g("md5").update($).digest("hex").slice(0,8),Y=D[K]||"other",V=[];if(Q&&Y==="js")V.push(...d($.toString("utf-8")));return{id:U,path:U,size:j,gzipSize:q,parsedSize:J,extension:K,type:Y,imports:V,importedBy:[],hash:F}}function y(X){try{let Z=z(X,{level:9}).length;return Math.min(Z,X.length)}catch{return X.length}}function h(X,Z){if(Z.includes(".min.")||X.length<1000)return X.length;let $=D[Z];if($==="js")return Math.round(X.length*0.6);if($==="css")return Math.round(X.length*0.7);return X.length}function d(X){let Z=[],Q=/import\s+(?:[\w*{}\s,]+\s+from\s+)?['"]([^'"]+)['"]/g,$;while(($=Q.exec(X))!==null)Z.push($[1]);let U=/import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;while(($=U.exec(X))!==null)Z.push($[1]);let K=/require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;while(($=K.exec(X))!==null)Z.push($[1]);return[...new Set(Z)]}function c(X,Z){let Q=new Map;for(let U of X){let K=U.path.split(H.sep),j;if(K.length===1)j=H.basename(U.path,U.extension);else j=K[0];let q=Q.get(j)||[];q.push(U),Q.set(j,q)}let $=[];for(let[U,K]of Q){let j=K.reduce((Y,V)=>Y+V.size,0),q=K.reduce((Y,V)=>Y+V.gzipSize,0),J=K.some((Y)=>B.some((V)=>V.test(Y.path))),F=K.some((Y)=>b.some((V)=>V.test(Y.path)));$.push({name:U,files:K.map((Y)=>Y.path),modules:K,size:j,gzipSize:q,isEntry:J,isVendor:F})}return $.sort((U,K)=>K.size-U.size)}function m(X){let Z={js:{count:0,size:0,gzipSize:0},css:{count:0,size:0,gzipSize:0},html:{count:0,size:0,gzipSize:0},image:{count:0,size:0,gzipSize:0},font:{count:0,size:0,gzipSize:0},other:{count:0,size:0,gzipSize:0}};for(let Q of X)Z[Q.type].count++,Z[Q.type].size+=Q.size,Z[Q.type].gzipSize+=Q.gzipSize;return Z}function p(X){let Z=new Map;for(let $ of X){let U=Z.get($.hash)||[];U.push($),Z.set($.hash,U)}let Q=[];for(let[,$]of Z)if($.length>1){let U=$[0];Q.push({path:U.path,count:$.length,wastedBytes:U.size*($.length-1),locations:$.map((K)=>K.path)})}return Q.sort(($,U)=>U.wastedBytes-$.wastedBytes)}function W(X){if(X<1024)return`${X} B`;if(X<1048576)return`${(X/1024).toFixed(2)} KB`;return`${(X/1048576).toFixed(2)} MB`}function I(X){let Z=X.match(/^([\d.]+)\s*(B|KB|MB|GB)?$/i);if(!Z)return 0;let Q=Number.parseFloat(Z[1]);switch((Z[2]||"B").toUpperCase()){case"KB":return Q*1024;case"MB":return Q*1024*1024;case"GB":return Q*1024*1024*1024;default:return Q}}function E(X,Z){if(Z===0)return"0%";return`${(X/Z*100).toFixed(1)}%`}function R(X,Z){switch(Z.format){case"json":return u(X,Z);case"markdown":return l(X,Z);case"text":default:return r(X,Z)}}function u(X,Z){let Q=N(X,Z);return JSON.stringify({timestamp:X.timestamp,buildDir:X.buildDir,summary:{totalSize:X.totalSize,totalSizeFormatted:W(X.totalSize),totalGzipSize:X.totalGzipSize,totalGzipSizeFormatted:W(X.totalGzipSize),moduleCount:X.moduleCount,chunkCount:X.chunks.length,duplicateCount:X.duplicates.length},byType:Object.fromEntries(Object.entries(X.byType).map(([$,U])=>[$,{...U,sizeFormatted:W(U.size),gzipSizeFormatted:W(U.gzipSize)}])),chunks:X.chunks.map(($)=>({name:$.name,size:$.size,sizeFormatted:W($.size),gzipSize:$.gzipSize,gzipSizeFormatted:W($.gzipSize),moduleCount:$.modules.length,isEntry:$.isEntry,isVendor:$.isVendor})),largestModules:X.largestModules.slice(0,Z.topModules||10).map(($)=>({path:$.path,size:$.size,sizeFormatted:W($.size),gzipSize:$.gzipSize,gzipSizeFormatted:W($.gzipSize),type:$.type})),duplicates:X.duplicates,analysis:Q,warnings:X.warnings},null,2)}function r(X,Z){let Q=[],$=Z.showGzip!==!1;if(Q.push(""),Q.push("Bundle Analysis Report"),Q.push("\u2550".repeat(50)),Q.push(""),Q.push("Summary"),Q.push("\u2500".repeat(50)),$)Q.push(`Total Size:     ${W(X.totalSize)} (${W(X.totalGzipSize)} gzip)`);else Q.push(`Total Size:     ${W(X.totalSize)}`);if(Q.push(`Modules:        ${X.moduleCount}`),Q.push(`Chunks:         ${X.chunks.length}`),X.duplicates.length>0)Q.push(`Duplicates:     ${X.duplicates.length}`);if(Q.push(""),Z.threshold&&X.totalSize>Z.threshold)Q.push(`\u26A0\uFE0F  Bundle exceeds threshold of ${W(Z.threshold)}!`),Q.push("");Q.push("Size by Type"),Q.push("\u2500".repeat(50));let U=["js","css","html","image","font","other"];for(let j of U){let q=X.byType[j];if(q.count>0){let J=E(q.size,X.totalSize),F=$?` (${W(q.gzipSize)} gzip)`:"";Q.push(`  ${j.padEnd(8)} ${W(q.size).padStart(12)}${F}  ${J.padStart(6)}  (${q.count} files)`)}}Q.push(""),Q.push("Chunks"),Q.push("\u2500".repeat(50));for(let j of X.chunks.slice(0,10)){let q=[];if(j.isEntry)q.push("entry");if(j.isVendor)q.push("vendor");let J=q.length>0?` [${q.join(", ")}]`:"",F=$?` (${W(j.gzipSize)} gzip)`:"";Q.push(`  ${j.name.padEnd(20)} ${W(j.size).padStart(12)}${F}${J}`)}if(X.chunks.length>10)Q.push(`  ... and ${X.chunks.length-10} more chunks`);Q.push("");let K=Z.topModules||10;Q.push(`Largest Modules (Top ${K})`),Q.push("\u2500".repeat(50));for(let j=0;j<Math.min(K,X.largestModules.length);j++){let q=X.largestModules[j],J=$?` (${W(q.gzipSize)} gzip)`:"";Q.push(`  ${(j+1).toString().padStart(2)}. ${q.path}`),Q.push(`      ${W(q.size)}${J}`)}if(Q.push(""),X.duplicates.length>0){Q.push("Duplicate Modules"),Q.push("\u2500".repeat(50));for(let j of X.duplicates.slice(0,5))Q.push(`  ${j.path}`),Q.push(`    ${j.count} copies, wasting ${W(j.wastedBytes)}`);if(X.duplicates.length>5)Q.push(`  ... and ${X.duplicates.length-5} more duplicates`);Q.push("")}if(Z.recommendations!==!1){let j=N(X,Z);if(j.recommendations.length>0){Q.push("Recommendations"),Q.push("\u2500".repeat(50));for(let q of j.recommendations.slice(0,5)){let J=q.impact==="high"?"\u26A1":q.impact==="medium"?"\uD83D\uDCCA":"\uD83D\uDCA1";Q.push(`  ${J} ${q.title}`),Q.push(`    ${q.description}`)}Q.push("")}}if(X.warnings.length>0){Q.push("Warnings"),Q.push("\u2500".repeat(50));for(let j of X.warnings)Q.push(`  \u26A0\uFE0F  ${j}`);Q.push("")}return Q.join(`
+`)}function l(X,Z){let Q=[],$=Z.showGzip!==!1;if(Q.push("# Bundle Analysis Report"),Q.push(""),Q.push(`Generated: ${new Date(X.timestamp).toISOString()}`),Q.push(""),Q.push("## Summary"),Q.push(""),Q.push("| Metric | Value |"),Q.push("|--------|-------|"),Q.push(`| Total Size | ${W(X.totalSize)} |`),$)Q.push(`| Gzip Size | ${W(X.totalGzipSize)} |`);Q.push(`| Modules | ${X.moduleCount} |`),Q.push(`| Chunks | ${X.chunks.length} |`),Q.push(`| Duplicates | ${X.duplicates.length} |`),Q.push(""),Q.push("## Size by Type"),Q.push(""),Q.push("| Type | Size | Gzip | % | Files |"),Q.push("|------|------|------|---|-------|");let U=["js","css","html","image","font","other"];for(let j of U){let q=X.byType[j];if(q.count>0)Q.push(`| ${j} | ${W(q.size)} | ${W(q.gzipSize)} | ${E(q.size,X.totalSize)} | ${q.count} |`)}Q.push(""),Q.push("## Chunks"),Q.push(""),Q.push("| Name | Size | Gzip | Modules | Type |"),Q.push("|------|------|------|---------|------|");for(let j of X.chunks.slice(0,15)){let q=j.isEntry?"Entry":j.isVendor?"Vendor":"-";Q.push(`| ${j.name} | ${W(j.size)} | ${W(j.gzipSize)} | ${j.modules.length} | ${q} |`)}Q.push("");let K=Z.topModules||10;Q.push(`## Largest Modules (Top ${K})`),Q.push(""),Q.push("| # | Path | Size | Gzip |"),Q.push("|---|------|------|------|");for(let j=0;j<Math.min(K,X.largestModules.length);j++){let q=X.largestModules[j];Q.push(`| ${j+1} | \`${q.path}\` | ${W(q.size)} | ${W(q.gzipSize)} |`)}if(Q.push(""),X.duplicates.length>0){Q.push("## Duplicates"),Q.push(""),Q.push("| Path | Copies | Wasted |"),Q.push("|------|--------|--------|");for(let j of X.duplicates.slice(0,10))Q.push(`| \`${j.path}\` | ${j.count} | ${W(j.wastedBytes)} |`);Q.push("")}if(Z.recommendations!==!1){let j=N(X,Z);if(j.recommendations.length>0){Q.push("## Recommendations"),Q.push("");for(let q of j.recommendations)Q.push(`### ${q.title}`),Q.push(""),Q.push(q.description),Q.push(""),Q.push(`- **Impact:** ${q.impact}`),Q.push(`- **Effort:** ${q.effort}`),Q.push("")}}return Q.join(`
+`)}function N(X,Z){let Q=[],$=[];if(Z.threshold&&X.totalSize>Z.threshold)Q.push({severity:"error",message:`Bundle size (${W(X.totalSize)}) exceeds threshold (${W(Z.threshold)})`});if(X.totalSize>1048576)Q.push({severity:"warning",message:`Bundle is over 1MB (${W(X.totalSize)})`,details:"Large bundles can significantly impact load time"});if(X.duplicates.length>0){let q=X.duplicates.reduce((J,F)=>J+F.wastedBytes,0);Q.push({severity:"warning",message:`${X.duplicates.length} duplicate modules found, wasting ${W(q)}`}),$.push({title:"Remove Duplicate Modules",description:"Consider using import aliases or ensuring consistent package versions to eliminate duplicates.",impact:"medium",effort:"low"})}if(X.byType.js.size/X.totalSize>0.8&&X.totalSize>512000)$.push({title:"Code Splitting",description:"Over 80% of your bundle is JavaScript. Consider splitting code by route or feature.",impact:"high",effort:"medium"});let K=X.largestModules.filter((q)=>q.size>102400);if(K.length>0){Q.push({severity:"info",message:`${K.length} modules are over 100KB`});for(let q of K){if(q.path.includes("lodash")&&!q.path.includes("lodash-es"))$.push({title:"Use lodash-es instead of lodash",description:"lodash-es supports tree-shaking and can significantly reduce bundle size.",impact:"high",effort:"low"});if(q.path.includes("moment"))$.push({title:"Replace moment.js",description:"Consider using date-fns or dayjs for smaller date handling libraries.",impact:"high",effort:"medium"})}}if(X.byType.image.size>512000)$.push({title:"Optimize Images",description:`Images account for ${W(X.byType.image.size)}. Consider using WebP/AVIF formats and responsive images.`,impact:"high",effort:"low"});let j=100;if(X.totalSize>1048576)j-=20;else if(X.totalSize>512000)j-=10;if(j-=Math.min(20,X.duplicates.length*2),j-=Math.min(15,K.length*3),Z.threshold&&X.totalSize>Z.threshold)j-=25;return{score:Math.max(0,j),issues:Q,recommendations:$}}var i={lodash:{alternative:"lodash-es or individual imports",savings:"~70%"},moment:{alternative:"date-fns or dayjs",savings:"~90%"},"chart.js":{alternative:"chart.js with tree-shaking",savings:"~50%"},"highlight.js":{alternative:"Selective language imports",savings:"~80%"},fontawesome:{alternative:"Individual icon imports",savings:"~90%"},"material-ui":{alternative:"Named imports from @mui/*",savings:"~60%"}};function n(X){for(let[Z,Q]of Object.entries(i))if(X.includes(Z))return{title:`Optimize ${Z}`,description:`Consider using ${Q.alternative}. Potential savings: ${Q.savings}`,impact:"high",effort:"low"};return null}var o={default:{js:"#f7df1e",css:"#264de4",html:"#e34c26",image:"#4caf50",font:"#9c27b0",other:"#607d8b",vendor:"#ff5722"},pastel:{js:"#fff3b0",css:"#b0d4ff",html:"#ffb0b0",image:"#b0ffb0",font:"#e0b0ff",other:"#d0d0d0",vendor:"#ffcfb0"},monochrome:{js:"#333333",css:"#555555",html:"#777777",image:"#999999",font:"#bbbbbb",other:"#dddddd",vendor:"#444444"}};function x(X,Z={}){let{title:Q="Bundle Analysis",gzip:$=!0,colorScheme:U="default"}=Z,K=o[U],j=a(X),q=JSON.stringify(j);return`<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${M(X)}</title>
+  <title>${M(Q)}</title>
   <style>
     * {
       box-sizing: border-box;
@@ -212,22 +212,22 @@ import v from"fs";import H from"path";import{gzipSync as z}from"zlib";import{cre
 </head>
 <body>
   <div class="header">
-    <h1>${M(X)}</h1>
+    <h1>${M(Q)}</h1>
     <div class="stats">
       <div class="stat">
-        <div class="stat-value" id="total-size">${W(Z.totalSize)}</div>
+        <div class="stat-value" id="total-size">${W(X.totalSize)}</div>
         <div class="stat-label">Total Size</div>
       </div>
       <div class="stat">
-        <div class="stat-value" id="gzip-size">${W(Z.totalGzipSize)}</div>
+        <div class="stat-value" id="gzip-size">${W(X.totalGzipSize)}</div>
         <div class="stat-label">Gzip Size</div>
       </div>
       <div class="stat">
-        <div class="stat-value">${Z.moduleCount}</div>
+        <div class="stat-value">${X.moduleCount}</div>
         <div class="stat-label">Modules</div>
       </div>
       <div class="stat">
-        <div class="stat-value">${Z.chunks.length}</div>
+        <div class="stat-value">${X.chunks.length}</div>
         <div class="stat-label">Chunks</div>
       </div>
     </div>
@@ -238,7 +238,7 @@ import v from"fs";import H from"path";import{gzipSync as z}from"zlib";import{cre
       <input type="text" id="search" placeholder="Search modules...">
     </div>
     <label>
-      <input type="checkbox" id="show-gzip" ${j?"checked":""}>
+      <input type="checkbox" id="show-gzip" ${$?"checked":""}>
       Show Gzip Size
     </label>
   </div>
@@ -254,37 +254,37 @@ import v from"fs";import H from"path";import{gzipSync as z}from"zlib";import{cre
   <div class="legend">
     <div class="legend-title">File Types</div>
     <div class="legend-item">
-      <div class="legend-color" style="background: ${Q.js}"></div>
+      <div class="legend-color" style="background: ${K.js}"></div>
       <span>JavaScript</span>
     </div>
     <div class="legend-item">
-      <div class="legend-color" style="background: ${Q.css}"></div>
+      <div class="legend-color" style="background: ${K.css}"></div>
       <span>CSS</span>
     </div>
     <div class="legend-item">
-      <div class="legend-color" style="background: ${Q.html}"></div>
+      <div class="legend-color" style="background: ${K.html}"></div>
       <span>HTML</span>
     </div>
     <div class="legend-item">
-      <div class="legend-color" style="background: ${Q.image}"></div>
+      <div class="legend-color" style="background: ${K.image}"></div>
       <span>Images</span>
     </div>
     <div class="legend-item">
-      <div class="legend-color" style="background: ${Q.font}"></div>
+      <div class="legend-color" style="background: ${K.font}"></div>
       <span>Fonts</span>
     </div>
     <div class="legend-item">
-      <div class="legend-color" style="background: ${Q.other}"></div>
+      <div class="legend-color" style="background: ${K.other}"></div>
       <span>Other</span>
     </div>
   </div>
   <script src="https://d3js.org/d3.v7.min.js"></script>
   <script>
-    const data = ${K};
-    const colors = ${JSON.stringify(Q)};
+    const data = ${q};
+    const colors = ${JSON.stringify(K)};
-    let showGzip = ${j};
+    let showGzip = ${$};
     let currentRoot = data;
     let searchTerm = '';
@@ -496,4 +496,4 @@ import v from"fs";import H from"path";import{gzipSync as z}from"zlib";import{cre
     render();
   </script>
 </body>
-</html>`}function a(Z){let $={name:"root",size:Z.totalSize,gzipSize:Z.totalGzipSize,children:[]};for(let X of Z.chunks){let j={name:X.name,size:X.size,gzipSize:X.gzipSize,children:[]};for(let U of X.modules)e(j,U);$.children.push(j)}return $}function e(Z,$){let X=$.path.split("/"),j=Z;for(let Q=0;Q<X.length-1;Q++){let q=X[Q],K=j.children?.find((J)=>J.name===q);if(!K){if(K={name:q,size:0,gzipSize:0,children:[]},!j.children)j.children=[];j.children.push(K)}j=K}let U=X[X.length-1];if(!j.children)j.children=[];j.children.push({name:U,path:$.path,size:$.size,gzipSize:$.gzipSize,type:$.type}),s(Z,$.size,$.gzipSize)}function s(Z,$,X){}function M(Z){return Z.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}function T(Z){let $=process.platform,X=$==="darwin"?"open":$==="win32"?"start":"xdg-open";Bun.spawn([X,Z],{stdio:["ignore","ignore","ignore"]})}import P from"fs";import S from"path";async function CX(Z={}){let{directory:$="dist",output:X,format:j="html",open:U=!0,gzip:Q=!0,threshold:q,recommendations:K=!0,topModules:J=20,parseImports:F=!0}=Z,V=await L($,{parseImports:F,detectDuplicates:!0,topModulesCount:J}),_=q?typeof q==="string"?I(q):q:void 0,w=_?V.totalSize>_:!1,G,C;if(j==="html"){let A={title:`Bundle Analysis - ${S.basename(S.resolve($))}`,gzip:Q};if(G=R(V,A),C=X||S.join($,"bundle-report.html"),await P.promises.writeFile(C,G),U)T(C)}else if(G=x(V,{format:j,threshold:_,recommendations:K,topModules:J,showGzip:Q}),X)C=X,await P.promises.writeFile(C,G);return{stats:V,report:G,outputPath:C,exceedsThreshold:w}}async function GX(Z){let $=await L(Z,{parseImports:!1,detectDuplicates:!1,topModulesCount:0});return{totalSize:$.totalSize,totalSizeFormatted:W($.totalSize),gzipSize:$.totalGzipSize,gzipSizeFormatted:W($.totalGzipSize),moduleCount:$.moduleCount,chunkCount:$.chunks.length}}export{E as percentage,I as parseSize,T as openInBrowser,n as getModuleRecommendation,GX as getBundleSummary,R as generateTreemap,x as generateReport,W as formatBytes,L as collectBundleStats,N as analyzeBundle,CX as analyze};
+</html>`}function a(X){let Z={name:"root",size:X.totalSize,gzipSize:X.totalGzipSize,children:[]};for(let Q of X.chunks){let $={name:Q.name,size:Q.size,gzipSize:Q.gzipSize,children:[]};for(let U of Q.modules)e($,U);Z.children.push($)}return Z}function e(X,Z){let Q=Z.path.split("/"),$=X;for(let K=0;K<Q.length-1;K++){let j=Q[K],q=$.children?.find((J)=>J.name===j);if(!q){if(q={name:j,size:0,gzipSize:0,children:[]},!$.children)$.children=[];$.children.push(q)}$=q}let U=Q[Q.length-1];if(!$.children)$.children=[];$.children.push({name:U,path:Z.path,size:Z.size,gzipSize:Z.gzipSize,type:Z.type}),s(X,Z.size,Z.gzipSize)}function s(X,Z,Q){}function M(X){return X.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}function T(X){let Z=process.platform,Q=Z==="darwin"?"open":Z==="win32"?"start":"xdg-open";Bun.spawn([Q,X],{stdio:["ignore","ignore","ignore"]})}import P from"fs";import S from"path";async function CQ(X={}){let{directory:Z="dist",output:Q,format:$="html",open:U=!0,gzip:K=!0,threshold:j,recommendations:q=!0,topModules:J=20,parseImports:F=!0}=X,V=await L(Z,{parseImports:F,detectDuplicates:!0,topModulesCount:J}),_=j?typeof j==="string"?I(j):j:void 0,w=_?V.totalSize>_:!1,G,C;if($==="html"){let A={title:`Bundle Analysis - ${S.basename(S.resolve(Z))}`,gzip:K};if(G=x(V,A),C=Q||S.join(Z,"bundle-report.html"),await P.promises.writeFile(C,G),U)T(C)}else if(G=R(V,{format:$,threshold:_,recommendations:q,topModules:J,showGzip:K}),Q)C=Q,await P.promises.writeFile(C,G);return{stats:V,report:G,outputPath:C,exceedsThreshold:w}}async function GQ(X){let Z=await L(X,{parseImports:!1,detectDuplicates:!1,topModulesCount:0});return{totalSize:Z.totalSize,totalSizeFormatted:W(Z.totalSize),gzipSize:Z.totalGzipSize,gzipSizeFormatted:W(Z.totalGzipSize),moduleCount:Z.moduleCount,chunkCount:Z.chunks.length}}export{E as percentage,I as parseSize,T as openInBrowser,n as getModuleRecommendation,GQ as getBundleSummary,x as generateTreemap,R as generateReport,W as formatBytes,L as collectBundleStats,N as analyzeBundle,CQ as analyze};

package/dist/caching.d.ts CHANGED Viewed

@@ -1,4 +1,31 @@
 import type { StxOptions } from './types';
+/**
+ * Read a file with mtime-based caching.
+ * Returns cached content if file hasn't been modified since last read.
+ */
+export declare function readFileCached(filePath: string): Promise<string>;
+/**
+ * Invalidate a specific file from the content cache.
+ * Called by HMR when a file changes.
+ */
+export declare function invalidateFileCache(filePath: string): void;
+/**
+ * Invalidate all files matching a pattern from the content cache.
+ */
+export declare function invalidateFileCacheByDir(dirPath: string): void;
+/**
+ * Get the signals runtime with module-level caching.
+ * The runtime is identical for every page and never changes during a dev session.
+ */
+export declare function getCachedSignalsRuntime(debug?: boolean): Promise<string>;
+/**
+ * Get the router script with module-level caching.
+ */
+export declare function getCachedRouterScript(): Promise<string>;
+/**
+ * Clear all dev caches. Called during full rebuild or HMR reset.
+ */
+export declare function clearDevCaches(): void;
 /**
  * Check if a cached version of the template is available and valid
  */