vinext 0.0.0 → 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+import type { Plugin } from "vite";
+/**
+ * Safely parse a static JS object literal string into a plain object.
+ * Uses Vite's parseAst (Rollup/acorn) so no code is ever evaluated.
+ * Returns null if the expression contains anything dynamic (function calls,
+ * template literals, identifiers, computed properties, etc.).
+ *
+ * Supports: string literals, numeric literals, boolean literals,
+ * arrays of the above, and nested object literals.
+ */
+declare function parseStaticObjectLiteral(objectStr: string): Record<string, unknown> | null;
+/**
+ * Resolve PostCSS string plugin names in a project's PostCSS config.
+ *
+ * Next.js (via postcss-load-config) resolves string plugin names in the
+ * object form `{ plugins: { "pkg-name": opts } }` but NOT in the array form
+ * `{ plugins: ["pkg-name"] }`. Since many Next.js projects use the array
+ * form (particularly with Tailwind CSS v4), we detect this case and resolve
+ * the string names to actual plugin functions so Vite can use them.
+ *
+ * Returns the resolved PostCSS config object to inject into Vite's
+ * `css.postcss`, or `undefined` if no resolution is needed.
+ */
+declare function resolvePostcssStringPlugins(projectRoot: string): Promise<{
+    plugins: any[];
+} | undefined>;
+/**
+ * manualChunks function for client builds.
+ *
+ * Splits the client bundle into:
+ * - "framework" — React, ReactDOM, and scheduler (loaded on every page)
+ * - "vinext"    — vinext shims (router, head, link, etc.)
+ *
+ * All other vendor code is left to Rollup's default chunk-splitting
+ * algorithm. Rollup automatically deduplicates shared modules into
+ * common chunks based on the import graph — no manual intervention
+ * needed.
+ *
+ * Why not split every npm package into its own chunk?
+ * - Per-package splitting (`vendor-X`) creates 50-200+ chunks for a
+ *   typical app, far exceeding the ~25-request sweet spot for HTTP/2.
+ * - gzip/brotli compress small files poorly — each file restarts with
+ *   an empty dictionary, losing ~5-15% total compressed size vs fewer
+ *   larger chunks (Khan Academy measured +2.5% wire size with 10x
+ *   more files containing less raw code).
+ * - ES module evaluation has per-module overhead that compounds on
+ *   mobile devices.
+ * - No major Vite-based framework (Remix, SvelteKit, Astro, TanStack)
+ *   uses per-package splitting. Next.js only isolates packages >160KB.
+ * - Rollup's graph-based splitting already handles the common case
+ *   well: shared dependencies between routes get their own chunks,
+ *   and route-specific code stays in route chunks.
+ */
+declare function clientManualChunks(id: string): string | undefined;
+/**
+ * Rollup output config with manualChunks for client code-splitting.
+ * Used by both CLI builds and multi-environment builds.
+ *
+ * experimentalMinChunkSize merges tiny shared chunks (< 10KB) back into
+ * their importers. This reduces HTTP request count and improves gzip
+ * compression efficiency — small files restart the compression dictionary,
+ * adding ~5-15% wire overhead vs fewer larger chunks.
+ */
+declare const clientOutputConfig: {
+    manualChunks: typeof clientManualChunks;
+    experimentalMinChunkSize: number;
+};
+/**
+ * Rollup treeshake configuration for production client builds.
+ *
+ * Uses the 'recommended' preset as a safe base, then overrides
+ * moduleSideEffects to strip unused re-exports from npm packages.
+ *
+ * The 'no-external' value for moduleSideEffects means:
+ * - Local project modules: preserve side effects (CSS imports, polyfills)
+ * - node_modules packages: treat as side-effect-free unless exports are used
+ *
+ * This is the single highest-impact optimization for large barrel-exporting
+ * libraries like mermaid, @mui/material, lucide-react, etc. These libraries
+ * re-export hundreds of sub-modules through barrel files. Without this,
+ * Rollup preserves every sub-module even when only a few exports are consumed.
+ *
+ * Why 'no-external' instead of false (global side-effect-free)?
+ * - User code may rely on import-time side effects (e.g., `import './global.css'`)
+ * - 'no-external' is safe for app code while still enabling aggressive DCE for deps
+ *
+ * Why not the 'smallest' preset?
+ * - 'smallest' also sets propertyReadSideEffects: false and
+ *   tryCatchDeoptimization: false, which can break specific libraries
+ *   that rely on property access side effects or try/catch for feature detection
+ * - 'recommended' + 'no-external' gives most of the benefit with less risk
+ */
+declare const clientTreeshakeConfig: {
+    preset: "recommended";
+    moduleSideEffects: "no-external";
+};
+/**
+ * Compute the set of chunk filenames that are ONLY reachable through dynamic
+ * imports (i.e. behind React.lazy(), next/dynamic, or manual import()).
+ *
+ * These chunks should NOT be modulepreloaded in the HTML — they will be
+ * fetched on demand when the dynamic import executes.
+ *
+ * Algorithm: Starting from all entry chunks in the build manifest, walk the
+ * static `imports` tree (breadth-first). Any chunk file NOT reached by this
+ * walk is only reachable through `dynamicImports` and is therefore "lazy".
+ *
+ * @param buildManifest - Vite's build manifest (manifest.json), which is a
+ *   Record<string, ManifestChunk> where each chunk has `file`, `imports`,
+ *   `dynamicImports`, `isEntry`, and `isDynamicEntry` fields.
+ * @returns Array of chunk filenames (e.g. "assets/mermaid-NOHMQCX5.js") that
+ *   should be excluded from modulepreload hints.
+ */
+declare function computeLazyChunks(buildManifest: Record<string, {
+    file: string;
+    isEntry?: boolean;
+    isDynamicEntry?: boolean;
+    imports?: string[];
+    dynamicImports?: string[];
+    css?: string[];
+}>): string[];
+export interface VinextOptions {
+    /**
+     * Base directory containing the app/ and pages/ directories.
+     * Can be an absolute path or a path relative to the Vite root.
+     *
+     * By default, vinext auto-detects: checks for app/ and pages/ at the
+     * project root first, then falls back to src/app/ and src/pages/.
+     */
+    appDir?: string;
+    /**
+     * Auto-register @vitejs/plugin-rsc when an app/ directory is detected.
+     * Set to `false` to disable auto-registration (e.g. if you configure
+     * @vitejs/plugin-rsc manually with custom options).
+     * @default true
+     */
+    rsc?: boolean;
+}
+export default function vinext(options?: VinextOptions): Plugin[];
+/**
+ * Match a Next.js route pattern (e.g. "/blog/:slug", "/docs/:path*") against a pathname.
+ * Returns matched params or null.
+ *
+ * Supports:
+ *   :param     — matches a single path segment
+ *   :param*    — matches zero or more segments (catch-all)
+ *   :param+    — matches one or more segments
+ *   (regex)    — inline regex patterns in the source
+ */
+export declare function matchConfigPattern(pathname: string, pattern: string): Record<string, string> | null;
+export { staticExportPages, staticExportApp } from "./build/static-export.js";
+export type { StaticExportResult, StaticExportOptions, AppStaticExportOptions } from "./build/static-export.js";
+export { clientManualChunks, clientOutputConfig, clientTreeshakeConfig, computeLazyChunks };
+export { resolvePostcssStringPlugins as _resolvePostcssStringPlugins };
+export { parseStaticObjectLiteral as _parseStaticObjectLiteral };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAqGlD;;;;;;;;GAQG;AACH,iBAAS,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBnF;AAuGD;;;;;;;;;;;GAWG;AACH,iBAAe,2BAA2B,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,GAAG,EAAE,CAAA;CAAE,GAAG,SAAS,CAAC,CAqEzC;AA0CD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,iBAAS,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8B1D;AAED;;;;;;;;GAQG;AACH,QAAA,MAAM,kBAAkB;;;CAGvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,QAAA,MAAM,qBAAqB;;;CAG1B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,iBAAiB,CACxB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC,GACD,MAAM,EAAE,CAwDV;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,EAAE,CAklFpE;AAgBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAqF/B;AAmMD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGhH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;AAC5F,OAAO,EAAE,2BAA2B,IAAI,4BAA4B,EAAE,CAAC;AACvE,OAAO,EAAE,wBAAwB,IAAI,yBAAyB,EAAE,CAAC"}