npm - @nexus_js/assets - Versions diffs - 0.6.0 - Mend

@nexus_js/assets 0.6.0

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 (15) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Nexus Contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,17 @@
+# @nexus_js/assets
+Nexus asset pipeline — image optimization (AVIF/WebP), font injection, lazy loading.
+## Documentation
+All guides, API reference, and examples live on **[nexusjs.dev](https://nexusjs.dev)**.
+## Links
+- **Website:** [https://nexusjs.dev](https://nexusjs.dev)
+- **Repository:** [github.com/bierfor/nexus](https://github.com/bierfor/nexus) (see `packages/assets/`)
+- **Issues:** [github.com/bierfor/nexus/issues](https://github.com/bierfor/nexus/issues)
+## License
+MIT © Nexus contributors

package/dist/fonts.d.ts ADDED Viewed

@@ -0,0 +1,59 @@
+/**
+ * Nexus Font Optimizer — eliminates CLS from web fonts.
+ *
+ * Strategies:
+ *   1. `inline`:  Fetches font CSS at build time, inlines @font-face into <style>.
+ *                 Eliminates extra round-trip. Best for 1-2 fonts.
+ *   2. `preload`: Emits <link rel="preload"> for the font files detected.
+ *                 Best for fonts already self-hosted.
+ *   3. `swap`:    Wraps with `font-display: swap` for graceful loading.
+ *   4. `subsets`: Requests only the character ranges actually used (via Unicode-range).
+ *
+ * Usage in nexus.config.ts:
+ *   fonts: {
+ *     google: [{ family: 'Inter', weights: [400, 700] }],
+ *     local:  [{ src: '/fonts/brand.woff2', family: 'Brand' }],
+ *     strategy: 'inline',
+ *   }
+ */
+export type FontStrategy = 'inline' | 'preload' | 'swap' | 'auto';
+export interface GoogleFont {
+    family: string;
+    weights?: number[];
+    styles?: ('normal' | 'italic')[];
+    subsets?: string[];
+    display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
+}
+export interface LocalFont {
+    family: string;
+    src: string;
+    weight?: number | string;
+    style?: 'normal' | 'italic';
+    display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
+    /** Unicode range to subset the font */
+    unicodeRange?: string;
+}
+export interface FontConfig {
+    google?: GoogleFont[];
+    local?: LocalFont[];
+    strategy?: FontStrategy;
+}
+export interface FontOutput {
+    /** CSS to inject into <head> */
+    css: string;
+    /** <link> tags to inject into <head> */
+    links: string;
+    /** Preload hints */
+    preloads: string;
+}
+/**
+ * Generates optimized font HTML/CSS for injection into the document <head>.
+ * Called at build time or per-request (cached).
+ */
+export declare function optimizeFonts(config: FontConfig): Promise<FontOutput>;
+/**
+ * Detects fonts used in the CSS output and returns preload hints.
+ * Parses `url(...)` references inside @font-face blocks.
+ */
+export declare function extractFontPreloads(css: string): string[];
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;CAC/D;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IAC9D,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B3E;AAiFD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYzD"}

package/dist/fonts.js ADDED Viewed

@@ -0,0 +1,134 @@
+/**
+ * Nexus Font Optimizer — eliminates CLS from web fonts.
+ *
+ * Strategies:
+ *   1. `inline`:  Fetches font CSS at build time, inlines @font-face into <style>.
+ *                 Eliminates extra round-trip. Best for 1-2 fonts.
+ *   2. `preload`: Emits <link rel="preload"> for the font files detected.
+ *                 Best for fonts already self-hosted.
+ *   3. `swap`:    Wraps with `font-display: swap` for graceful loading.
+ *   4. `subsets`: Requests only the character ranges actually used (via Unicode-range).
+ *
+ * Usage in nexus.config.ts:
+ *   fonts: {
+ *     google: [{ family: 'Inter', weights: [400, 700] }],
+ *     local:  [{ src: '/fonts/brand.woff2', family: 'Brand' }],
+ *     strategy: 'inline',
+ *   }
+ */
+/**
+ * Generates optimized font HTML/CSS for injection into the document <head>.
+ * Called at build time or per-request (cached).
+ */
+export async function optimizeFonts(config) {
+    const strategy = config.strategy ?? 'auto';
+    const cssChunks = [];
+    const linkTags = [];
+    const preloadTags = [];
+    // ── Google Fonts ───────────────────────────────────────────────────────────
+    if (config.google?.length) {
+        const result = await processGoogleFonts(config.google, strategy);
+        cssChunks.push(...result.css);
+        linkTags.push(...result.links);
+        preloadTags.push(...result.preloads);
+    }
+    // ── Local Fonts ────────────────────────────────────────────────────────────
+    if (config.local?.length) {
+        const result = processLocalFonts(config.local);
+        cssChunks.push(...result.css);
+        preloadTags.push(...result.preloads);
+    }
+    return {
+        css: cssChunks.length > 0
+            ? `<style id="nexus-fonts">\n${cssChunks.join('\n')}\n</style>`
+            : '',
+        links: linkTags.join('\n'),
+        preloads: preloadTags.join('\n'),
+    };
+}
+async function processGoogleFonts(fonts, strategy) {
+    const css = [];
+    const links = [];
+    const preloads = [];
+    for (const font of fonts) {
+        const weights = font.weights ?? [400];
+        const display = font.display ?? 'swap';
+        const subsets = font.subsets ?? ['latin'];
+        // Build Google Fonts API v2 URL
+        const family = font.family.replace(/ /g, '+');
+        const axes = weights.length > 1
+            ? `wght@${weights.join(';')}`
+            : `wght@${weights[0]}`;
+        const googleUrl = `https://fonts.googleapis.com/css2?family=${family}:${axes}&display=${display}&subset=${subsets.join(',')}`;
+        if (strategy === 'inline') {
+            try {
+                const fetched = await fetchWithTimeout(googleUrl, {
+                    headers: { 'user-agent': 'Mozilla/5.0 (compatible; NexusBot/1.0)' },
+                });
+                if (fetched.ok) {
+                    const fontCSS = await fetched.text();
+                    // Replace font-display to ensure it's correct
+                    css.push(fontCSS.replace(/font-display:\s*\w+/g, `font-display: ${display}`));
+                    continue;
+                }
+            }
+            catch {
+                // Fall through to link strategy
+            }
+        }
+        // Preconnect + stylesheet link (fallback or non-inline strategy)
+        links.push(`<link rel="preconnect" href="https://fonts.googleapis.com">`);
+        links.push(`<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>`);
+        links.push(`<link rel="stylesheet" href="${googleUrl}" media="print" onload="this.media='all'">`);
+        // Noscript fallback
+        links.push(`<noscript><link rel="stylesheet" href="${googleUrl}"></noscript>`);
+    }
+    return { css, links, preloads };
+}
+function processLocalFonts(fonts) {
+    const css = [];
+    const preloads = [];
+    for (const font of fonts) {
+        const display = font.display ?? 'swap';
+        const ext = font.src.split('.').pop() ?? 'woff2';
+        const format = ext === 'woff2' ? 'woff2' : ext === 'woff' ? 'woff' : 'truetype';
+        css.push(`@font-face {
+  font-family: '${font.family}';
+  src: url('${font.src}') format('${format}');
+  font-weight: ${font.weight ?? 400};
+  font-style: ${font.style ?? 'normal'};
+  font-display: ${display};${font.unicodeRange ? `\n  unicode-range: ${font.unicodeRange};` : ''}
+}`);
+        // Preload woff2 (most efficient format)
+        if (ext === 'woff2') {
+            preloads.push(`<link rel="preload" href="${font.src}" as="font" type="font/woff2" crossorigin>`);
+        }
+    }
+    return { css, preloads };
+}
+/**
+ * Detects fonts used in the CSS output and returns preload hints.
+ * Parses `url(...)` references inside @font-face blocks.
+ */
+export function extractFontPreloads(css) {
+    const preloads = [];
+    const re = /url\(['"]?([^'")\s]+\.woff2)['"]?\)/g;
+    let m;
+    while ((m = re.exec(css)) !== null) {
+        if (m[1]) {
+            preloads.push(`<link rel="preload" href="${m[1]}" as="font" type="font/woff2" crossorigin>`);
+        }
+    }
+    return [...new Set(preloads)];
+}
+async function fetchWithTimeout(url, init) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"fonts.js","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"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"}

package/dist/image.d.ts ADDED Viewed

@@ -0,0 +1,69 @@
+/**
+ * Nexus Image — Server-side optimization + client lazy loading.
+ *
+ * On the server (build/SSR):
+ *   - Generates <picture> with AVIF + WebP + original fallback sources
+ *   - Computes intrinsic width/height to prevent CLS
+ *   - Emits responsive srcset for each configured breakpoint
+ *   - Blur placeholder hook (data-nx-blur) for perceived performance
+ *
+ * On the client:
+ *   - Native `loading="lazy"` + `decoding="async"`
+ *   - IntersectionObserver for below-the-fold images (optional island)
+ *
+ * Usage in .nx templates:
+ *   import { renderImage } from '@nexus_js/assets';
+ *   renderImage({ src: "/hero.jpg", alt: "Hero", width: 1280, height: 720, priority: true })
+ */
+export interface ImageProps {
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+    /** Square shorthand: sets both width and height */
+    size?: number;
+    /** Render sizes attribute for responsive images */
+    sizes?: string;
+    /** Skip lazy loading (above-the-fold images) */
+    priority?: boolean;
+    /** Round crop (avatars, icons) */
+    round?: boolean;
+    /** Custom CSS class */
+    class?: string;
+    /** Quality 1-100 (default: 80) */
+    quality?: number;
+    /** Output formats in priority order */
+    formats?: ImageFormat[];
+    /** Placeholder strategy */
+    placeholder?: 'blur' | 'empty' | 'none';
+    /** Fetch priority hint */
+    fetchpriority?: 'high' | 'low' | 'auto';
+}
+export type ImageFormat = 'avif' | 'webp' | 'png' | 'jpg' | 'original';
+export interface OptimizedImageSrc {
+    url: string;
+    width: number;
+    format: ImageFormat;
+}
+/** Options for {@link handleImageRequest} (Node / Vite dev server). */
+export interface ImageHandlerOptions {
+    /**
+     * Directory used to resolve local `src` paths (e.g. `/photo.jpg` → `<publicDir>/photo.jpg`).
+     * When omitted, local files fall back to passthrough behavior.
+     */
+    publicDir?: string;
+}
+/**
+ * Generates optimized `<picture>` HTML for a given image.
+ * This runs on the SERVER at build or request time.
+ */
+export declare function renderImage(props: ImageProps): string;
+/**
+ * Transforms an image URL into an optimized variant URL.
+ * In production, this calls the /_nexus/image endpoint which does real conversion.
+ * In dev, it passes through with query params for the dev server to handle.
+ */
+export declare function imageUrl(src: string, width: number, format: ImageFormat | 'original', quality: number): string;
+/** HTTP handler for the /_nexus/image endpoint */
+export declare function handleImageRequest(request: Request, options?: ImageHandlerOptions): Promise<Response>;
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACxC,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAiErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAAG,UAAU,EAChC,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAID,kDAAkD;AAClD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CA8DnB"}

package/dist/image.js ADDED Viewed

@@ -0,0 +1,233 @@
+/**
+ * Nexus Image — Server-side optimization + client lazy loading.
+ *
+ * On the server (build/SSR):
+ *   - Generates <picture> with AVIF + WebP + original fallback sources
+ *   - Computes intrinsic width/height to prevent CLS
+ *   - Emits responsive srcset for each configured breakpoint
+ *   - Blur placeholder hook (data-nx-blur) for perceived performance
+ *
+ * On the client:
+ *   - Native `loading="lazy"` + `decoding="async"`
+ *   - IntersectionObserver for below-the-fold images (optional island)
+ *
+ * Usage in .nx templates:
+ *   import { renderImage } from '@nexus_js/assets';
+ *   renderImage({ src: "/hero.jpg", alt: "Hero", width: 1280, height: 720, priority: true })
+ */
+import { readFile } from 'node:fs/promises';
+import { join, resolve, sep } from 'node:path';
+import sharp from 'sharp';
+/** Default responsive breakpoints (px) */
+const DEFAULT_WIDTHS = [320, 640, 960, 1280, 1920];
+/** Default format priority (most efficient first) */
+const DEFAULT_FORMATS = ['avif', 'webp', 'original'];
+/**
+ * Generates optimized `<picture>` HTML for a given image.
+ * This runs on the SERVER at build or request time.
+ */
+export function renderImage(props) {
+    const { src, alt, priority = false, round = false, quality = 80, formats = DEFAULT_FORMATS, placeholder = 'blur', fetchpriority, } = props;
+    const w = props.size ?? props.width;
+    const h = props.size ?? props.height;
+    const loading = priority ? 'eager' : 'lazy';
+    const decoding = priority ? 'sync' : 'async';
+    const fp = fetchpriority ?? (priority ? 'high' : 'auto');
+    const widths = w ? getResponsiveWidths(w) : DEFAULT_WIDTHS;
+    const sizesAttr = props.sizes ?? defaultSizes(widths);
+    const roundStyle = round ? 'border-radius:50%;' : '';
+    const aspectStyle = w && h ? `aspect-ratio:${w}/${h};` : '';
+    const classAttr = props.class ? ` class="${props.class}"` : '';
+    // Build <source> elements for modern formats
+    const sources = formats
+        .filter((f) => f !== 'original')
+        .map((format) => {
+        const srcset = widths
+            .map((width) => `${imageUrl(src, width, format, quality)} ${width}w`)
+            .join(', ');
+        return `<source type="image/${format}" srcset="${srcset}" sizes="${sizesAttr}">`;
+    })
+        .join('\n    ');
+    // Fallback <img>
+    const fallbackSrcset = widths
+        .map((width) => `${imageUrl(src, width, 'original', quality)} ${width}w`)
+        .join(', ');
+    const dimensionAttrs = [
+        w ? `width="${w}"` : '',
+        h ? `height="${h}"` : '',
+    ].filter(Boolean).join(' ');
+    const blurAttr = placeholder === 'blur'
+        ? ` data-nx-blur style="${aspectStyle}${roundStyle}background:var(--nx-img-blur,#f0f0f0)"`
+        : ` style="${aspectStyle}${roundStyle}"`;
+    return `<picture${classAttr}>
+    ${sources}
+    <img
+      src="${imageUrl(src, w ?? 800, 'original', quality)}"
+      srcset="${fallbackSrcset}"
+      sizes="${sizesAttr}"
+      alt="${escapeAttr(alt)}"
+      ${dimensionAttrs}
+      loading="${loading}"
+      decoding="${decoding}"
+      fetchpriority="${fp}"${blurAttr}
+      data-nx-img
+    >
+  </picture>`;
+}
+/**
+ * Transforms an image URL into an optimized variant URL.
+ * In production, this calls the /_nexus/image endpoint which does real conversion.
+ * In dev, it passes through with query params for the dev server to handle.
+ */
+export function imageUrl(src, width, format, quality) {
+    if (src.startsWith('http://') || src.startsWith('https://')) {
+        // External URLs: proxy through the image optimizer
+        return `/_nexus/image?url=${encodeURIComponent(src)}&w=${width}&f=${format}&q=${quality}`;
+    }
+    if (format === 'original') {
+        return `/_nexus/image?src=${encodeURIComponent(src)}&w=${width}&q=${quality}`;
+    }
+    return `/_nexus/image?src=${encodeURIComponent(src)}&w=${width}&f=${format}&q=${quality}`;
+}
+const REMOTE_MAX_BYTES = 12 * 1024 * 1024;
+/** HTTP handler for the /_nexus/image endpoint */
+export async function handleImageRequest(request, options = {}) {
+    const url = new URL(request.url);
+    const src = url.searchParams.get('src') ?? '';
+    const remoteUrl = url.searchParams.get('url') ?? '';
+    const width = Math.min(Math.max(parseInt(url.searchParams.get('w') ?? '800', 10) || 800, 1), 8192);
+    const hasExplicitFormat = url.searchParams.has('f');
+    const formatParam = (url.searchParams.get('f') ?? 'original');
+    const quality = Math.min(Math.max(parseInt(url.searchParams.get('q') ?? '80', 10) || 80, 1), 100);
+    // Only honor `f=` when present. Omitted `f` means "original" raster (JPEG/PNG), not Accept-based AVIF/WebP,
+    // so <picture><source type=avif> and <img> fallback stay distinct.
+    const outputFormat = hasExplicitFormat ? formatParam : 'original';
+    const cacheHeaders = {
+        'cache-control': 'public, max-age=31536000, immutable',
+    };
+    try {
+        let input;
+        let sourceLabel;
+        if (remoteUrl) {
+            if (!remoteUrl.startsWith('https://') && !remoteUrl.startsWith('http://')) {
+                return new Response('Invalid URL', { status: 400 });
+            }
+            const fetched = await fetchRemoteImage(remoteUrl);
+            if (!fetched) {
+                return new Response('Failed to fetch image', { status: 502 });
+            }
+            input = fetched;
+            sourceLabel = remoteUrl;
+        }
+        else if (src) {
+            if (!options.publicDir) {
+                return new Response('Local src requires publicDir (set in Nexus server / Vite plugin)', { status: 400 });
+            }
+            const path = safeResolvePublicPath(options.publicDir, src);
+            if (!path) {
+                return new Response('Invalid path', { status: 400 });
+            }
+            try {
+                input = await readFile(path);
+            }
+            catch {
+                return new Response('Not found', { status: 404 });
+            }
+            sourceLabel = src;
+        }
+        else {
+            return new Response('Missing src or url', { status: 400 });
+        }
+        const { body, contentType } = await encodeWithSharp(input, width, outputFormat, quality);
+        return new Response(new Uint8Array(body), {
+            status: 200,
+            headers: {
+                ...cacheHeaders,
+                'content-type': contentType,
+                'x-nexus-image-source': encodeURIComponent(sourceLabel.slice(0, 200)),
+            },
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return new Response(`Image optimization failed: ${message}`, { status: 500 });
+    }
+}
+function safeResolvePublicPath(publicDir, src) {
+    const normalized = src.replace(/^\/+/, '');
+    if (normalized.includes('..'))
+        return null;
+    const full = resolve(join(publicDir, normalized));
+    const root = resolve(publicDir);
+    if (full !== root && !full.startsWith(root + sep))
+        return null;
+    return full;
+}
+async function fetchRemoteImage(remoteUrl) {
+    const ac = new AbortController();
+    const t = setTimeout(() => ac.abort(), 15_000);
+    try {
+        const res = await fetch(remoteUrl, {
+            signal: ac.signal,
+            headers: { 'user-agent': 'NexusImage/1.0' },
+            redirect: 'follow',
+        });
+        if (!res.ok)
+            return null;
+        const len = res.headers.get('content-length');
+        if (len && Number(len) > REMOTE_MAX_BYTES)
+            return null;
+        const buf = Buffer.from(await res.arrayBuffer());
+        if (buf.length > REMOTE_MAX_BYTES)
+            return null;
+        return buf;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+async function encodeWithSharp(input, width, outputFormat, quality) {
+    let pipeline = sharp(input).rotate().resize({
+        width,
+        withoutEnlargement: true,
+        fit: 'inside',
+    });
+    const meta = await sharp(input).metadata();
+    if (outputFormat === 'avif') {
+        const buf = await pipeline.avif({ quality }).toBuffer();
+        return { body: buf, contentType: 'image/avif' };
+    }
+    if (outputFormat === 'webp') {
+        const buf = await pipeline.webp({ quality }).toBuffer();
+        return { body: buf, contentType: 'image/webp' };
+    }
+    if (outputFormat === 'png') {
+        const buf = await pipeline.png({ compressionLevel: 9 }).toBuffer();
+        return { body: buf, contentType: 'image/png' };
+    }
+    if (outputFormat === 'jpg') {
+        const buf = await pipeline.jpeg({ quality, mozjpeg: true }).toBuffer();
+        return { body: buf, contentType: 'image/jpeg' };
+    }
+    // original: resize only, preserve alpha when present
+    if (meta.hasAlpha || meta.format === 'png') {
+        const buf = await pipeline.png({ compressionLevel: 9 }).toBuffer();
+        return { body: buf, contentType: 'image/png' };
+    }
+    const buf = await pipeline.jpeg({ quality, mozjpeg: true }).toBuffer();
+    return { body: buf, contentType: 'image/jpeg' };
+}
+function getResponsiveWidths(maxWidth) {
+    return DEFAULT_WIDTHS.filter((w) => w <= maxWidth * 1.5);
+}
+function defaultSizes(widths) {
+    const max = widths[widths.length - 1];
+    return max ? `(max-width: ${max}px) 100vw, ${max}px` : '100vw';
+}
+function escapeAttr(str) {
+    return str.replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=image.js.map

package/dist/image.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"image.js","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export { renderImage, imageUrl, handleImageRequest } from './image.js';
+export type { ImageProps, ImageFormat, OptimizedImageSrc, ImageHandlerOptions } from './image.js';
+export { optimizeFonts, extractFontPreloads } from './fonts.js';
+export type { FontConfig, FontStrategy, GoogleFont, LocalFont, FontOutput } from './fonts.js';
+//# sourceMappingURL=index.d.ts.map

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

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,3 @@
+export { renderImage, imageUrl, handleImageRequest } from './image.js';
+export { optimizeFonts, extractFontPreloads } from './fonts.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/package.json ADDED Viewed

@@ -0,0 +1,62 @@
+{
+  "name": "@nexus_js/assets",
+  "version": "0.6.0",
+  "description": "Nexus asset pipeline — image optimization (AVIF/WebP), font injection, lazy loading",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./image": {
+      "import": "./dist/image.js",
+      "types": "./dist/image.d.ts"
+    },
+    "./fonts": {
+      "import": "./dist/fonts.js",
+      "types": "./dist/fonts.d.ts"
+    }
+  },
+  "dependencies": {
+    "sharp": "^0.33.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  },
+  "license": "MIT",
+  "homepage": "https://nexusjs.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bierfor/nexus.git",
+    "directory": "packages/assets"
+  },
+  "bugs": {
+    "url": "https://github.com/bierfor/nexus/issues"
+  },
+  "keywords": [
+    "nexus",
+    "framework",
+    "full-stack",
+    "svelte",
+    "islands",
+    "ssr",
+    "vite",
+    "server-actions"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist"
+  }
+}