@elurjs/kit 2.4.4

package/dist/lib/errors.d.cts

@@ -0,0 +1,84 @@
+/**
+ * Represents a failed action result. Returned by `fail()` from server actions.
+ *
+ * The `__elur_js_action_failure` marker is set on the instance so the server can
+ * detect it even when the value crosses a bundling boundary (e.g. the CLI is
+ * bundled separately from the user's action modules).
+ */
+export declare class ActionFailure<TData = unknown> {
+    status: number;
+    data: TData;
+    readonly __elur_js_action_failure = true;
+    constructor(status: number, data: TData);
+}
+/**
+ * Represents a redirect returned by a server action. Returned by `redirect()`.
+ */
+export declare class RedirectResponse {
+    status: number;
+    location: string;
+    readonly __elur_js_action_redirect = true;
+    constructor(status: number, location: string);
+}
+/**
+ * Helper to return a validation/error response from a server action.
+ *
+ * Both argument orders are accepted:
+ *
+ * ```ts
+ * return fail(400, { email: "Invalid email" });
+ * return fail({ email: "Invalid email" }, 400);
+ * return fail({ email: "Invalid email" }); // defaults to status 400
+ * ```
+ */
+export declare function fail<TData>(statusOrData: number | TData, dataOrStatus?: TData | number): ActionFailure<unknown>;
+/**
+ * Helper to return a redirect from a server action.
+ *
+ * Both argument orders are accepted:
+ *
+ * ```ts
+ * return redirect(303, "/login");
+ * return redirect("/login"); // defaults to status 303
+ * ```
+ */
+export declare function redirect(statusOrLocation: number | string, locationOrStatus?: string | number): RedirectResponse;
+/**
+ * Type guard for action failures. Uses the marker field so it works across
+ * bundling boundaries where `instanceof` fails.
+ */
+export declare function isActionFailure(value: unknown): value is ActionFailure;
+/**
+ * Type guard for redirects. Uses the marker field so it works across bundling
+ * boundaries where `instanceof` fails.
+ */
+export declare function isRedirectResponse(value: unknown): value is RedirectResponse;
+/**
+ * A stable, publicly safe error description. Never includes stacks, internal
+ * paths or messages that could leak secrets or filesystem details.
+ */
+export interface PublicErrorInfo {
+    /** Stable machine-readable code for the response body. */
+    code: string;
+    /** Stable public message. In non-production this may include the raw message. */
+    message: string;
+    status: number;
+}
+/**
+ * Maps an arbitrary thrown value to a public-safe error info. By default the
+ * public message is generic; `includeDetail` (dev/verbose mode) appends the
+ * original `Error.message` for local debugging.
+ */
+export declare function toPublicErrorInfo(error: unknown, options?: {
+    includeDetail?: boolean;
+}): PublicErrorInfo;
+/**
+ * Builds a production-safe JSON error Response. Logs the raw error separately
+ * (never reflected in the response body) and keeps the request id header.
+ */
+export declare function publicErrorResponse(error: unknown, options?: {
+    includeDetail?: boolean;
+    requestId?: string;
+}): Response;
+/** True when the error should be re-thrown as control flow instead of a 500. */
+export declare function isFirstClassResponse(error: unknown): error is Response;

package/dist/lib/errors.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Represents a failed action result. Returned by `fail()` from server actions.
+ *
+ * The `__elur_js_action_failure` marker is set on the instance so the server can
+ * detect it even when the value crosses a bundling boundary (e.g. the CLI is
+ * bundled separately from the user's action modules).
+ */
+export declare class ActionFailure<TData = unknown> {
+    status: number;
+    data: TData;
+    readonly __elur_js_action_failure = true;
+    constructor(status: number, data: TData);
+}
+/**
+ * Represents a redirect returned by a server action. Returned by `redirect()`.
+ */
+export declare class RedirectResponse {
+    status: number;
+    location: string;
+    readonly __elur_js_action_redirect = true;
+    constructor(status: number, location: string);
+}
+/**
+ * Helper to return a validation/error response from a server action.
+ *
+ * Both argument orders are accepted:
+ *
+ * ```ts
+ * return fail(400, { email: "Invalid email" });
+ * return fail({ email: "Invalid email" }, 400);
+ * return fail({ email: "Invalid email" }); // defaults to status 400
+ * ```
+ */
+export declare function fail<TData>(statusOrData: number | TData, dataOrStatus?: TData | number): ActionFailure<unknown>;
+/**
+ * Helper to return a redirect from a server action.
+ *
+ * Both argument orders are accepted:
+ *
+ * ```ts
+ * return redirect(303, "/login");
+ * return redirect("/login"); // defaults to status 303
+ * ```
+ */
+export declare function redirect(statusOrLocation: number | string, locationOrStatus?: string | number): RedirectResponse;
+/**
+ * Type guard for action failures. Uses the marker field so it works across
+ * bundling boundaries where `instanceof` fails.
+ */
+export declare function isActionFailure(value: unknown): value is ActionFailure;
+/**
+ * Type guard for redirects. Uses the marker field so it works across bundling
+ * boundaries where `instanceof` fails.
+ */
+export declare function isRedirectResponse(value: unknown): value is RedirectResponse;
+/**
+ * A stable, publicly safe error description. Never includes stacks, internal
+ * paths or messages that could leak secrets or filesystem details.
+ */
+export interface PublicErrorInfo {
+    /** Stable machine-readable code for the response body. */
+    code: string;
+    /** Stable public message. In non-production this may include the raw message. */
+    message: string;
+    status: number;
+}
+/**
+ * Maps an arbitrary thrown value to a public-safe error info. By default the
+ * public message is generic; `includeDetail` (dev/verbose mode) appends the
+ * original `Error.message` for local debugging.
+ */
+export declare function toPublicErrorInfo(error: unknown, options?: {
+    includeDetail?: boolean;
+}): PublicErrorInfo;
+/**
+ * Builds a production-safe JSON error Response. Logs the raw error separately
+ * (never reflected in the response body) and keeps the request id header.
+ */
+export declare function publicErrorResponse(error: unknown, options?: {
+    includeDetail?: boolean;
+    requestId?: string;
+}): Response;
+/** True when the error should be re-thrown as control flow instead of a 500. */
+export declare function isFirstClassResponse(error: unknown): error is Response;

package/dist/lib/hydrate-8a3TbQbs.cjs

@@ -0,0 +1,2 @@
+let e=require("@elurjs/core/hydrate");var t=new Set,n=new Set;function r(e){return{load:e}}function i(e){return typeof e==`object`&&!!e&&typeof e.load==`function`}function a(e){return typeof e==`function`?e.constructor?.name===`AsyncFunction`||e[Symbol.toStringTag]===`AsyncFunction`:!1}function o(){return Array.from(document.querySelectorAll(`[data-elur-island]`)).map(e=>{let t={el:e,name:e.dataset.elurJsIsland??``,directive:e.dataset.directive??`load`,props:null};if(e.dataset.props)try{t.props=JSON.parse(e.dataset.props)}catch(e){t.propsError=e}return t})}async function s(n,r){try{if(n.propsError){c(n,n.propsError);return}let o=r[n.name];if(!o){console.warn(`[elur-kit] No island registered for "${n.name}"`);return}let s;if(i(o)){let e=await o.load();s=typeof e==`function`?e:e.default}else if(typeof o==`function`){if(a(o)){let e=await o();s=typeof e==`function`?e:e.default}else s=o}if(typeof s!=`function`){console.warn(`[elur-kit] Island "${n.name}" did not resolve to a component function`);return}let u=s(n.props);if(u===null||u===!1||u===void 0)return;let d=n.el.__elur_js_island_dispose;typeof d==`function`&&d();let f=n.el.innerHTML.includes(`<!--elur-`)?(0,e.hydrate)(u,n.el,{mismatch:`warn-remount`}):l(u,n.el),p=()=>{f.unmount(),t.delete(p),delete n.el.__elur_js_island_dispose};n.el.__elur_js_island_dispose=p,t.add(p)}catch(e){c(n,e)}}function c(e,t){console.error(`[elur-kit] Failed to hydrate island "${e.name}":`,t);let n=e.el.ownerDocument.defaultView?.CustomEvent;n&&e.el.dispatchEvent(new n(`elur:island-error`,{bubbles:!0,detail:{name:e.name,error:t}}))}function l(e,t){return t.replaceChildren(),{unmount:e._render(t,null)}}function u(){for(let e of n)e();n.clear();for(let e of t)e();t.clear()}function d(e){if(typeof window>`u`)return;let t=o();for(let r of t){if(r.directive===`load`||r.directive===`only`){s(r,e);continue}if(r.directive===`idle`){let t=()=>{};if(`requestIdleCallback`in window){let i=window.requestIdleCallback(()=>{n.delete(t),s(r,e)});t=()=>window.cancelIdleCallback(i)}else{let i=globalThis.setTimeout(()=>{n.delete(t),s(r,e)},0);t=()=>globalThis.clearTimeout(i)}n.add(t);continue}if(r.directive===`visible`){if(`IntersectionObserver`in window){let t=()=>{},i=new IntersectionObserver(a=>{for(let o of a)o.isIntersecting&&(n.delete(t),i.disconnect(),s(r,e))},{rootMargin:`0px`,threshold:0});t=()=>i.disconnect(),n.add(t),i.observe(r.el)}else s(r,e)}}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return u}});
+//# sourceMappingURL=hydrate-8a3TbQbs.cjs.map

package/dist/lib/hydrate-8a3TbQbs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-8a3TbQbs.cjs","names":[],"sources":["../../src/island/hydrate.ts"],"sourcesContent":["import type { ElurTemplate } from \"@elurjs/core\";\nimport { hydrate as hydrateTemplate } from \"@elurjs/core/hydrate\";\nimport type { IslandDirective } from \"./island.js\";\n\n// --- Client-side island hydration ---\n\n// Keep track of every active island dispose so we can clean them up before a\n// client-side navigation swaps the whole #app content.\nconst _islandDisposes = new Set<() => void>();\nconst _islandSchedules = new Set<() => void>();\n\n// Finds [data-elur-island] markers in the current document and mounts the\n// corresponding interactive components over them. This runs in the browser.\n\nexport type IslandComponent<TProps = unknown> = (props: TProps) => ElurTemplate | null | false | undefined;\n\n// Re-exported from island.ts so the client entry and the server helper share a\n// single source of truth for the directive union (now includes \"only\").\nexport type { IslandDirective } from \"./island.js\";\n\n/** Lazy island loader in a discriminated form (no probe required to detect). */\nexport interface IslandLoader<TProps = unknown> {\n  load: () => Promise<IslandComponent<TProps>>;\n}\n\n/**\n * Island registry entry. Two unambiguous shapes:\n *   - `IslandComponent` (eager component function).\n *   - `IslandLoader` `{ load }` (lazy, code-split loader).\n *\n * Legacy async loader functions are also accepted for backwards compatibility\n * and detected *without invoking them* (via the `AsyncFunction` tag), so no\n * side effects or duplicate signal creation happen during detection.\n */\nexport type IslandRegistryEntry<TProps = unknown> =\n  | IslandComponent<TProps>\n  | IslandLoader<TProps>\n  | (() => Promise<IslandComponent<TProps>>);\n\nexport type IslandRegistry = Record<string, IslandRegistryEntry<any>>;\n\n/**\n * Wraps a lazy island loader in the discriminated `{ load }` form.\n */\nexport function lazyIsland<TProps = unknown>(\n  loader: () => Promise<IslandComponent<TProps>>,\n): IslandLoader<TProps> {\n  return { load: loader };\n}\n\nfunction isIslandLoader(value: unknown): value is IslandLoader {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { load?: unknown }).load === \"function\"\n  );\n}\n\nfunction isAsyncFunction(value: unknown): boolean {\n  if (typeof value !== \"function\") return false;\n  const ctor = (value as { constructor?: { name?: string } }).constructor;\n  return ctor?.name === \"AsyncFunction\" || (value as { [Symbol.toStringTag]?: string })[Symbol.toStringTag] === \"AsyncFunction\";\n}\n\ninterface IslandMarker {\n  el: HTMLElement;\n  name: string;\n  directive: IslandDirective;\n  props: unknown;\n  propsError?: unknown;\n}\n\nfunction collectMarkers(): IslandMarker[] {\n  const elements = Array.from(\n    document.querySelectorAll<HTMLElement>(\"[data-elur-island]\"),\n  );\n  return elements.map((el) => {\n    const marker: IslandMarker = {\n      el,\n      name: el.dataset.elurJsIsland ?? \"\",\n      directive: (el.dataset.directive as IslandDirective) ?? \"load\",\n      props: null,\n    };\n    if (el.dataset.props) {\n      try {\n        marker.props = JSON.parse(el.dataset.props);\n      } catch (error) {\n        marker.propsError = error;\n      }\n    }\n    return marker;\n  });\n}\n\nasync function hydrate(marker: IslandMarker, registry: IslandRegistry): Promise<void> {\n  try {\n    if (marker.propsError) {\n      reportIslandError(marker, marker.propsError);\n      return;\n    }\n\n    const entry = registry[marker.name];\n    if (!entry) {\n      console.warn(`[elur-kit] No island registered for \"${marker.name}\"`);\n      return;\n    }\n\n    // Resolve the component without probing: a `{ load }` loader or an async\n    // function is lazy (awaited for the module/component); anything else is an\n    // eager component called directly with the island props. Detection never\n    // invokes the component with undefined props, so no side effects or\n    // duplicate signal creation occur during resolution. Eager components\n    // hydrate synchronously; lazy loaders hydrate once the module resolves.\n    let Component: IslandComponent | undefined;\n    if (isIslandLoader(entry)) {\n      const mod = (await (entry as IslandLoader).load()) as IslandComponent | { default?: unknown };\n      Component = typeof mod === \"function\" ? (mod as IslandComponent) : (mod as { default?: unknown }).default as IslandComponent | undefined;\n    } else if (typeof entry === \"function\") {\n      if (isAsyncFunction(entry)) {\n        const mod = (await (entry as () => Promise<unknown>)()) as IslandComponent | { default?: unknown };\n        Component = typeof mod === \"function\" ? (mod as IslandComponent) : (mod as { default?: unknown }).default as IslandComponent | undefined;\n      } else {\n        Component = entry as IslandComponent;\n      }\n    }\n\n    if (typeof Component !== \"function\") {\n      console.warn(`[elur-kit] Island \"${marker.name}\" did not resolve to a component function`);\n      return;\n    }\n\n    const template = Component(marker.props);\n    if (template === null || template === false || template === undefined) return;\n    const prevDispose = (marker.el as any).__elur_js_island_dispose;\n    if (typeof prevDispose === \"function\") prevDispose();\n\n    // Islands with directive \"only\" or options.ssr:false have no SSR-rendered\n    // DOM inside the marker — only fallback HTML or nothing. hydrateTemplate\n    // assumes the SSR DOM is already present and walks it for hydration markers\n    // (<!--elur-N-->, data-elur-e-*). When there's nothing to walk, it silently\n    // does nothing (no contexts to match → empty loop → no mount). So we detect\n    // the absence of hydration markers and do a fresh _render mount instead.\n    const hasSSRMarkers = marker.el.innerHTML.includes(\"<!--elur-\");\n    const handle = hasSSRMarkers\n      ? hydrateTemplate(template, marker.el, { mismatch: \"warn-remount\" })\n      : freshMount(template, marker.el);\n\n    const wrappedDispose = () => {\n      handle.unmount();\n      _islandDisposes.delete(wrappedDispose);\n      delete (marker.el as any).__elur_js_island_dispose;\n    };\n    (marker.el as any).__elur_js_island_dispose = wrappedDispose;\n    _islandDisposes.add(wrappedDispose);\n  } catch (error) {\n    reportIslandError(marker, error);\n  }\n}\n\nfunction reportIslandError(marker: IslandMarker, error: unknown): void {\n  console.error(`[elur-kit] Failed to hydrate island \"${marker.name}\":`, error);\n  const EventConstructor = marker.el.ownerDocument.defaultView?.CustomEvent;\n  if (EventConstructor) {\n    marker.el.dispatchEvent(new EventConstructor(\"elur:island-error\", {\n      bubbles: true,\n      detail: { name: marker.name, error },\n    }));\n  }\n}\n\n/**\n * Mounts a template fresh into a container (no hydration).\n * Used for islands with no SSR DOM (directive \"only\" or ssr:false) where\n * hydrateTemplate can't work — there's nothing to hydrate against.\n */\nfunction freshMount(template: ElurTemplate, container: Element): { unmount: () => void } {\n  container.replaceChildren();\n  const dispose = template._render(container, null);\n  return { unmount: dispose };\n}\n\n/**\n * Hydrates all islands on the page using the provided registry.\n *\n * @param registry Map from island name to component factory.\n */\n/**\n * Dispose all currently hydrated islands. Called by the client router before\n * swapping the page body to prevent leaked effects and stale DOM writes.\n */\nexport function cleanupHydratedIslands(): void {\n  for (const cancel of _islandSchedules) cancel();\n  _islandSchedules.clear();\n  for (const dispose of _islandDisposes) dispose();\n  _islandDisposes.clear();\n}\n\nexport function hydrateIslands(registry: IslandRegistry): void {\n  if (typeof window === \"undefined\") return;\n\n  const markers = collectMarkers();\n\n  for (const marker of markers) {\n    if (marker.directive === \"load\" || marker.directive === \"only\") {\n      // \"only\" is client-only (no SSR) but hydrates immediately on the\n      // client, just like \"load\" — the difference is purely server-side.\n      void hydrate(marker, registry);\n      continue;\n    }\n\n    if (marker.directive === \"idle\") {\n      let cancel = () => { };\n      if (\"requestIdleCallback\" in window) {\n        const id = window.requestIdleCallback(() => {\n          _islandSchedules.delete(cancel);\n          void hydrate(marker, registry);\n        });\n        cancel = () => window.cancelIdleCallback(id);\n      } else {\n        const id = globalThis.setTimeout(() => {\n          _islandSchedules.delete(cancel);\n          void hydrate(marker, registry);\n        }, 0);\n        cancel = () => globalThis.clearTimeout(id);\n      }\n      _islandSchedules.add(cancel);\n      continue;\n    }\n\n    if (marker.directive === \"visible\") {\n      if (\"IntersectionObserver\" in window) {\n        let cancel = () => { };\n        const observer = new IntersectionObserver(\n          (entries) => {\n            for (const entry of entries) {\n              if (entry.isIntersecting) {\n                _islandSchedules.delete(cancel);\n                observer.disconnect();\n                void hydrate(marker, registry);\n              }\n            }\n          },\n          { rootMargin: \"0px\", threshold: 0 },\n        );\n        cancel = () => observer.disconnect();\n        _islandSchedules.add(cancel);\n        observer.observe(marker.el);\n      } else {\n        void hydrate(marker, registry);\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/lib/hydrate-CgZGrTxF.js

@@ -0,0 +1,126 @@
+import { hydrate as e } from "@elurjs/core/hydrate";
+//#region src/island/hydrate.ts
+var t = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Set();
+function r(e) {
+	return { load: e };
+}
+function i(e) {
+	return typeof e == "object" && !!e && typeof e.load == "function";
+}
+function a(e) {
+	return typeof e == "function" ? e.constructor?.name === "AsyncFunction" || e[Symbol.toStringTag] === "AsyncFunction" : !1;
+}
+function o() {
+	return Array.from(document.querySelectorAll("[data-elur-island]")).map((e) => {
+		let t = {
+			el: e,
+			name: e.dataset.elurJsIsland ?? "",
+			directive: e.dataset.directive ?? "load",
+			props: null
+		};
+		if (e.dataset.props) try {
+			t.props = JSON.parse(e.dataset.props);
+		} catch (e) {
+			t.propsError = e;
+		}
+		return t;
+	});
+}
+async function s(n, r) {
+	try {
+		if (n.propsError) {
+			c(n, n.propsError);
+			return;
+		}
+		let o = r[n.name];
+		if (!o) {
+			console.warn(`[elur-kit] No island registered for "${n.name}"`);
+			return;
+		}
+		let s;
+		if (i(o)) {
+			let e = await o.load();
+			s = typeof e == "function" ? e : e.default;
+		} else if (typeof o == "function") {
+			if (a(o)) {
+				let e = await o();
+				s = typeof e == "function" ? e : e.default;
+			} else s = o;
+		}
+		if (typeof s != "function") {
+			console.warn(`[elur-kit] Island "${n.name}" did not resolve to a component function`);
+			return;
+		}
+		let u = s(n.props);
+		if (u === null || u === !1 || u === void 0) return;
+		let d = n.el.__elur_js_island_dispose;
+		typeof d == "function" && d();
+		let f = n.el.innerHTML.includes("<!--elur-") ? e(u, n.el, { mismatch: "warn-remount" }) : l(u, n.el), p = () => {
+			f.unmount(), t.delete(p), delete n.el.__elur_js_island_dispose;
+		};
+		n.el.__elur_js_island_dispose = p, t.add(p);
+	} catch (e) {
+		c(n, e);
+	}
+}
+function c(e, t) {
+	console.error(`[elur-kit] Failed to hydrate island "${e.name}":`, t);
+	let n = e.el.ownerDocument.defaultView?.CustomEvent;
+	n && e.el.dispatchEvent(new n("elur:island-error", {
+		bubbles: !0,
+		detail: {
+			name: e.name,
+			error: t
+		}
+	}));
+}
+function l(e, t) {
+	return t.replaceChildren(), { unmount: e._render(t, null) };
+}
+function u() {
+	for (let e of n) e();
+	n.clear();
+	for (let e of t) e();
+	t.clear();
+}
+function d(e) {
+	if (typeof window > "u") return;
+	let t = o();
+	for (let r of t) {
+		if (r.directive === "load" || r.directive === "only") {
+			s(r, e);
+			continue;
+		}
+		if (r.directive === "idle") {
+			let t = () => {};
+			if ("requestIdleCallback" in window) {
+				let i = window.requestIdleCallback(() => {
+					n.delete(t), s(r, e);
+				});
+				t = () => window.cancelIdleCallback(i);
+			} else {
+				let i = globalThis.setTimeout(() => {
+					n.delete(t), s(r, e);
+				}, 0);
+				t = () => globalThis.clearTimeout(i);
+			}
+			n.add(t);
+			continue;
+		}
+		if (r.directive === "visible") {
+			if ("IntersectionObserver" in window) {
+				let t = () => {}, i = new IntersectionObserver((a) => {
+					for (let o of a) o.isIntersecting && (n.delete(t), i.disconnect(), s(r, e));
+				}, {
+					rootMargin: "0px",
+					threshold: 0
+				});
+				t = () => i.disconnect(), n.add(t), i.observe(r.el);
+			} else s(r, e);
+		}
+	}
+}
+//#endregion
+export { d as n, r, u as t };
+
+//# sourceMappingURL=hydrate-CgZGrTxF.js.map

package/dist/lib/hydrate-CgZGrTxF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-CgZGrTxF.js","names":[],"sources":["../../src/island/hydrate.ts"],"sourcesContent":["import type { ElurTemplate } from \"@elurjs/core\";\nimport { hydrate as hydrateTemplate } from \"@elurjs/core/hydrate\";\nimport type { IslandDirective } from \"./island.js\";\n\n// --- Client-side island hydration ---\n\n// Keep track of every active island dispose so we can clean them up before a\n// client-side navigation swaps the whole #app content.\nconst _islandDisposes = new Set<() => void>();\nconst _islandSchedules = new Set<() => void>();\n\n// Finds [data-elur-island] markers in the current document and mounts the\n// corresponding interactive components over them. This runs in the browser.\n\nexport type IslandComponent<TProps = unknown> = (props: TProps) => ElurTemplate | null | false | undefined;\n\n// Re-exported from island.ts so the client entry and the server helper share a\n// single source of truth for the directive union (now includes \"only\").\nexport type { IslandDirective } from \"./island.js\";\n\n/** Lazy island loader in a discriminated form (no probe required to detect). */\nexport interface IslandLoader<TProps = unknown> {\n  load: () => Promise<IslandComponent<TProps>>;\n}\n\n/**\n * Island registry entry. Two unambiguous shapes:\n *   - `IslandComponent` (eager component function).\n *   - `IslandLoader` `{ load }` (lazy, code-split loader).\n *\n * Legacy async loader functions are also accepted for backwards compatibility\n * and detected *without invoking them* (via the `AsyncFunction` tag), so no\n * side effects or duplicate signal creation happen during detection.\n */\nexport type IslandRegistryEntry<TProps = unknown> =\n  | IslandComponent<TProps>\n  | IslandLoader<TProps>\n  | (() => Promise<IslandComponent<TProps>>);\n\nexport type IslandRegistry = Record<string, IslandRegistryEntry<any>>;\n\n/**\n * Wraps a lazy island loader in the discriminated `{ load }` form.\n */\nexport function lazyIsland<TProps = unknown>(\n  loader: () => Promise<IslandComponent<TProps>>,\n): IslandLoader<TProps> {\n  return { load: loader };\n}\n\nfunction isIslandLoader(value: unknown): value is IslandLoader {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { load?: unknown }).load === \"function\"\n  );\n}\n\nfunction isAsyncFunction(value: unknown): boolean {\n  if (typeof value !== \"function\") return false;\n  const ctor = (value as { constructor?: { name?: string } }).constructor;\n  return ctor?.name === \"AsyncFunction\" || (value as { [Symbol.toStringTag]?: string })[Symbol.toStringTag] === \"AsyncFunction\";\n}\n\ninterface IslandMarker {\n  el: HTMLElement;\n  name: string;\n  directive: IslandDirective;\n  props: unknown;\n  propsError?: unknown;\n}\n\nfunction collectMarkers(): IslandMarker[] {\n  const elements = Array.from(\n    document.querySelectorAll<HTMLElement>(\"[data-elur-island]\"),\n  );\n  return elements.map((el) => {\n    const marker: IslandMarker = {\n      el,\n      name: el.dataset.elurJsIsland ?? \"\",\n      directive: (el.dataset.directive as IslandDirective) ?? \"load\",\n      props: null,\n    };\n    if (el.dataset.props) {\n      try {\n        marker.props = JSON.parse(el.dataset.props);\n      } catch (error) {\n        marker.propsError = error;\n      }\n    }\n    return marker;\n  });\n}\n\nasync function hydrate(marker: IslandMarker, registry: IslandRegistry): Promise<void> {\n  try {\n    if (marker.propsError) {\n      reportIslandError(marker, marker.propsError);\n      return;\n    }\n\n    const entry = registry[marker.name];\n    if (!entry) {\n      console.warn(`[elur-kit] No island registered for \"${marker.name}\"`);\n      return;\n    }\n\n    // Resolve the component without probing: a `{ load }` loader or an async\n    // function is lazy (awaited for the module/component); anything else is an\n    // eager component called directly with the island props. Detection never\n    // invokes the component with undefined props, so no side effects or\n    // duplicate signal creation occur during resolution. Eager components\n    // hydrate synchronously; lazy loaders hydrate once the module resolves.\n    let Component: IslandComponent | undefined;\n    if (isIslandLoader(entry)) {\n      const mod = (await (entry as IslandLoader).load()) as IslandComponent | { default?: unknown };\n      Component = typeof mod === \"function\" ? (mod as IslandComponent) : (mod as { default?: unknown }).default as IslandComponent | undefined;\n    } else if (typeof entry === \"function\") {\n      if (isAsyncFunction(entry)) {\n        const mod = (await (entry as () => Promise<unknown>)()) as IslandComponent | { default?: unknown };\n        Component = typeof mod === \"function\" ? (mod as IslandComponent) : (mod as { default?: unknown }).default as IslandComponent | undefined;\n      } else {\n        Component = entry as IslandComponent;\n      }\n    }\n\n    if (typeof Component !== \"function\") {\n      console.warn(`[elur-kit] Island \"${marker.name}\" did not resolve to a component function`);\n      return;\n    }\n\n    const template = Component(marker.props);\n    if (template === null || template === false || template === undefined) return;\n    const prevDispose = (marker.el as any).__elur_js_island_dispose;\n    if (typeof prevDispose === \"function\") prevDispose();\n\n    // Islands with directive \"only\" or options.ssr:false have no SSR-rendered\n    // DOM inside the marker — only fallback HTML or nothing. hydrateTemplate\n    // assumes the SSR DOM is already present and walks it for hydration markers\n    // (<!--elur-N-->, data-elur-e-*). When there's nothing to walk, it silently\n    // does nothing (no contexts to match → empty loop → no mount). So we detect\n    // the absence of hydration markers and do a fresh _render mount instead.\n    const hasSSRMarkers = marker.el.innerHTML.includes(\"<!--elur-\");\n    const handle = hasSSRMarkers\n      ? hydrateTemplate(template, marker.el, { mismatch: \"warn-remount\" })\n      : freshMount(template, marker.el);\n\n    const wrappedDispose = () => {\n      handle.unmount();\n      _islandDisposes.delete(wrappedDispose);\n      delete (marker.el as any).__elur_js_island_dispose;\n    };\n    (marker.el as any).__elur_js_island_dispose = wrappedDispose;\n    _islandDisposes.add(wrappedDispose);\n  } catch (error) {\n    reportIslandError(marker, error);\n  }\n}\n\nfunction reportIslandError(marker: IslandMarker, error: unknown): void {\n  console.error(`[elur-kit] Failed to hydrate island \"${marker.name}\":`, error);\n  const EventConstructor = marker.el.ownerDocument.defaultView?.CustomEvent;\n  if (EventConstructor) {\n    marker.el.dispatchEvent(new EventConstructor(\"elur:island-error\", {\n      bubbles: true,\n      detail: { name: marker.name, error },\n    }));\n  }\n}\n\n/**\n * Mounts a template fresh into a container (no hydration).\n * Used for islands with no SSR DOM (directive \"only\" or ssr:false) where\n * hydrateTemplate can't work — there's nothing to hydrate against.\n */\nfunction freshMount(template: ElurTemplate, container: Element): { unmount: () => void } {\n  container.replaceChildren();\n  const dispose = template._render(container, null);\n  return { unmount: dispose };\n}\n\n/**\n * Hydrates all islands on the page using the provided registry.\n *\n * @param registry Map from island name to component factory.\n */\n/**\n * Dispose all currently hydrated islands. Called by the client router before\n * swapping the page body to prevent leaked effects and stale DOM writes.\n */\nexport function cleanupHydratedIslands(): void {\n  for (const cancel of _islandSchedules) cancel();\n  _islandSchedules.clear();\n  for (const dispose of _islandDisposes) dispose();\n  _islandDisposes.clear();\n}\n\nexport function hydrateIslands(registry: IslandRegistry): void {\n  if (typeof window === \"undefined\") return;\n\n  const markers = collectMarkers();\n\n  for (const marker of markers) {\n    if (marker.directive === \"load\" || marker.directive === \"only\") {\n      // \"only\" is client-only (no SSR) but hydrates immediately on the\n      // client, just like \"load\" — the difference is purely server-side.\n      void hydrate(marker, registry);\n      continue;\n    }\n\n    if (marker.directive === \"idle\") {\n      let cancel = () => { };\n      if (\"requestIdleCallback\" in window) {\n        const id = window.requestIdleCallback(() => {\n          _islandSchedules.delete(cancel);\n          void hydrate(marker, registry);\n        });\n        cancel = () => window.cancelIdleCallback(id);\n      } else {\n        const id = globalThis.setTimeout(() => {\n          _islandSchedules.delete(cancel);\n          void hydrate(marker, registry);\n        }, 0);\n        cancel = () => globalThis.clearTimeout(id);\n      }\n      _islandSchedules.add(cancel);\n      continue;\n    }\n\n    if (marker.directive === \"visible\") {\n      if (\"IntersectionObserver\" in window) {\n        let cancel = () => { };\n        const observer = new IntersectionObserver(\n          (entries) => {\n            for (const entry of entries) {\n              if (entry.isIntersecting) {\n                _islandSchedules.delete(cancel);\n                observer.disconnect();\n                void hydrate(marker, registry);\n              }\n            }\n          },\n          { rootMargin: \"0px\", threshold: 0 },\n        );\n        cancel = () => observer.disconnect();\n        _islandSchedules.add(cancel);\n        observer.observe(marker.el);\n      } else {\n        void hydrate(marker, registry);\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/lib/image/index.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./service.cjs"),t=require("./registry.cjs");let n=require("@elurjs/core");function r(r){let{src:a,alt:o,width:s,height:c,widths:l=[s],sizes:u,priority:d=!1,class:f,attributes:p={}}=r;t.registerImage(a,l);let m,h=t.getActiveManifest(),g=h?e.getManifestEntry(h,a):void 0;if(g&&g.variants.length>0)m=e.buildPictureMarkup(g,{alt:o,sizes:u,priority:d,class:f,attributes:p,fallbackSrc:a,fallbackWidth:s,fallbackHeight:c});else{let e=d?``:` loading="lazy"`,t=d?` fetchpriority="high"`:``,n=u?` sizes="${i(u)}"`:``,r=f?` class="${i(f)}"`:``,l=Object.entries(p).map(([e,t])=>` ${i(e)}="${i(String(t))}"`).join(``);m=`<img src="${i(a)}" alt="${i(o)}" width="${s}" height="${c}"${n}${e} decoding="async"${t}${r}${l} />`}return{__isElurTemplate:!0,[n.ELUR_RENDER_PROTOCOL]:{renderServer:()=>m},mount(e){let t=typeof e==`string`?document.querySelector(e):e;if(!t)throw Error(`[elur-kit] image(): container not found`);return t.innerHTML=m,{unmount(){t.innerHTML=``}}},_render(e,t){let n=document.createElement(`template`);n.innerHTML=m;let r=n.content,i=Array.from(r.childNodes);return e.insertBefore(r,t),()=>{for(let e of i)e.parentNode&&e.parentNode.removeChild(e)}}}}function i(e){return e.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`)}exports.buildPictureMarkup=e.buildPictureMarkup,exports.buildSrcset=e.buildSrcset,exports.consumeImageRegistry=t.consumeImageRegistry,exports.createImageService=e.createImageService,exports.getImage=e.getImage,exports.getManifestEntry=e.getManifestEntry,exports.image=r,exports.isSharpAvailable=e.isSharpAvailable,exports.processImageBatch=e.processImageBatch,exports.readManifest=e.readManifest,exports.setImageManifest=t.setImageManifest,exports.transformHash=e.transformHash,exports.validateManifestUrls=e.validateManifestUrls,exports.writeManifest=e.writeManifest;
+//# sourceMappingURL=index.cjs.map

package/dist/lib/image/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/image/index.ts"],"sourcesContent":["// --- image() helper: optimized <img> / <picture> without dependencies ---\n//\n// Emits an `<img>` (or `<picture>` when processed variants are available) with:\n//   - `srcset` / `sizes` for responsive images\n//   - `loading=\"lazy\"` and `decoding=\"async\"` (unless `priority`)\n//   - `width` / `height` to prevent layout shift (CLS)\n//   - `fetchpriority=\"high\"` for above-the-fold images\n//\n// When the build-time pipeline (sharp) is available, `image()` registers the\n// source for processing and emits `<picture>` with `<source>` per format.\n// When sharp is not installed, it falls back to a plain `<img>` with srcset\n// pointing to the original file.\n\nimport { ELUR_RENDER_PROTOCOL, type ElurTemplate } from \"@elurjs/core\";\nimport { getManifestEntry, buildPictureMarkup } from \"./service.js\";\nimport {\n  registerImage,\n  getActiveManifest,\n} from \"./registry.js\";\n\nexport { consumeImageRegistry, setImageManifest, type ImageFormat } from \"./registry.js\";\n\nexport interface ImageOptions {\n  /** Source path relative to the public directory, e.g. \"/images/hero.jpg\". */\n  src: string;\n  /** Alt text (required for accessibility). */\n  alt: string;\n  /** Intrinsic width of the source image in pixels. */\n  width: number;\n  /** Intrinsic height of the source image in pixels. */\n  height: number;\n  /** Responsive widths to generate for srcset. Defaults to [width]. */\n  widths?: number[];\n  /** Sizes attribute for responsive layout, e.g. \"100vw\" or \"(min-width: 768px) 50vw, 100vw\". */\n  sizes?: string;\n  /** If true, loads eagerly with high priority (for above-the-fold images). */\n  priority?: boolean;\n  /** CSS class for the img element. */\n  class?: string;\n  /** Additional HTML attributes. */\n  attributes?: Record<string, string>;\n}\n\n/**\n * Creates a ElurTemplate that renders an optimized `<img>` or `<picture>` element.\n *\n * When a manifest is active (post-build or SSR with manifest loaded):\n *   * Emits `<picture>` with `<source>` per format and real hashed variant URLs.\n *   * Uses real dimensions from the manifest.\n *\n * When no manifest is active (first build pass, dev without sharp):\n *   * Emits a plain `<img>` with the original src.\n *   * Does NOT emit srcset with unresolved variant URLs.\n *   * Registers the image for build-time processing.\n */\nexport function image(opts: ImageOptions): ElurTemplate {\n  const {\n    src,\n    alt,\n    width,\n    height,\n    widths = [width],\n    sizes,\n    priority = false,\n    class: className,\n    attributes = {},\n  } = opts;\n\n  // Register for build-time processing.\n  registerImage(src, widths);\n\n  // If a manifest is active and has an entry for this src, emit <picture>.\n  let html: string;\n  const manifest = getActiveManifest();\n  const entry = manifest ? getManifestEntry(manifest, src) : undefined;\n  if (entry && entry.variants.length > 0) {\n    html = buildPictureMarkup(entry, {\n      alt,\n      sizes,\n      priority,\n      class: className,\n      attributes,\n      fallbackSrc: src,\n      fallbackWidth: width,\n      fallbackHeight: height,\n    });\n  } else {\n    // No manifest or no variants: emit a plain <img> with the original src.\n    // Do NOT emit srcset — the variant files don't exist yet.\n    const loadingAttr = priority ? \"\" : ' loading=\"lazy\"';\n    const fetchPriorityAttr = priority ? ' fetchpriority=\"high\"' : \"\";\n    const sizesAttr = sizes ? ` sizes=\"${escapeAttr(sizes)}\"` : \"\";\n    const classAttr = className ? ` class=\"${escapeAttr(className)}\"` : \"\";\n    const extraAttrs = Object.entries(attributes)\n      .map(([key, value]) => ` ${escapeAttr(key)}=\"${escapeAttr(String(value))}\"`)\n      .join(\"\");\n    html = `<img src=\"${escapeAttr(src)}\" alt=\"${escapeAttr(alt)}\" width=\"${width}\" height=\"${height}\"${sizesAttr}${loadingAttr} decoding=\"async\"${fetchPriorityAttr}${classAttr}${extraAttrs} />`;\n  }\n\n  return {\n    __isElurTemplate: true as const,\n    [ELUR_RENDER_PROTOCOL]: {\n      renderServer: () => html,\n    },\n    mount(container: Element | string) {\n      const el = typeof container === \"string\" ? document.querySelector(container) : container;\n      if (!el) throw new Error(\"[elur-kit] image(): container not found\");\n      el.innerHTML = html;\n      return { unmount() { el.innerHTML = \"\"; } };\n    },\n    _render(parent: Node, before: Node | null): () => void {\n      const wrapper = document.createElement(\"template\");\n      wrapper.innerHTML = html;\n      const fragment = wrapper.content;\n      const inserted = Array.from(fragment.childNodes);\n      parent.insertBefore(fragment, before);\n      return () => {\n        for (const node of inserted) {\n          if (node.parentNode) node.parentNode.removeChild(node);\n        }\n      };\n    },\n  } as unknown as ElurTemplate;\n}\n\nfunction escapeAttr(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\");\n}\n\nexport {\n  processImageBatch,\n  readManifest,\n  writeManifest,\n  getManifestEntry,\n  buildSrcset,\n  buildPictureMarkup,\n  validateManifestUrls,\n  isSharpAvailable,\n  getImage,\n  createImageService,\n  transformHash,\n} from \"./service.js\";\nexport type {\n  ImageManifest,\n  ImageEntry,\n  ImageVariant,\n  ProcessOptions,\n  ProcessResult,\n  ImageRequest,\n  ImageMetadata,\n  GeneratedImage,\n  ImageService,\n  ImageServiceCapabilities,\n  ImageServiceContext,\n} from \"./service.js\";\n"],"mappings":"8JAuDA,SAAgB,EAAM,EAAkC,CACtD,GAAM,CACJ,MACA,MACA,QACA,SACA,SAAS,CAAC,CAAK,EACf,QACA,WAAW,GACX,MAAO,EACP,aAAa,CAAC,GACZ,EAGJ,EAAA,cAAc,EAAK,CAAM,EAGzB,IAAI,EACE,EAAW,EAAA,kBAAkB,EAC7B,EAAQ,EAAW,EAAA,iBAAiB,EAAU,CAAG,EAAI,IAAA,GAC3D,GAAI,GAAS,EAAM,SAAS,OAAS,EACnC,EAAO,EAAA,mBAAmB,EAAO,CAC/B,MACA,QACA,WACA,MAAO,EACP,aACA,YAAa,EACb,cAAe,EACf,eAAgB,CAClB,CAAC,MACI,CAGL,IAAM,EAAc,EAAW,GAAK,kBAC9B,EAAoB,EAAW,wBAA0B,GACzD,EAAY,EAAQ,WAAW,EAAW,CAAK,EAAE,GAAK,GACtD,EAAY,EAAY,WAAW,EAAW,CAAS,EAAE,GAAK,GAC9D,EAAa,OAAO,QAAQ,CAAU,CAAC,CAC1C,KAAK,CAAC,EAAK,KAAW,IAAI,EAAW,CAAG,EAAE,IAAI,EAAW,OAAO,CAAK,CAAC,EAAE,EAAE,CAAC,CAC3E,KAAK,EAAE,EACV,EAAO,aAAa,EAAW,CAAG,EAAE,SAAS,EAAW,CAAG,EAAE,WAAW,EAAM,YAAY,EAAO,GAAG,IAAY,EAAY,mBAAmB,IAAoB,IAAY,EAAW,IAC5L,CAEA,MAAO,CACL,iBAAkB,IACjB,EAAA,sBAAuB,CACtB,iBAAoB,CACtB,EACA,MAAM,EAA6B,CACjC,IAAM,EAAK,OAAO,GAAc,SAAW,SAAS,cAAc,CAAS,EAAI,EAC/E,GAAI,CAAC,EAAI,MAAU,MAAM,yCAAyC,EAElE,MADA,GAAG,UAAY,EACR,CAAE,SAAU,CAAE,EAAG,UAAY,EAAI,CAAE,CAC5C,EACA,QAAQ,EAAc,EAAiC,CACrD,IAAM,EAAU,SAAS,cAAc,UAAU,EACjD,EAAQ,UAAY,EACpB,IAAM,EAAW,EAAQ,QACnB,EAAW,MAAM,KAAK,EAAS,UAAU,EAE/C,OADA,EAAO,aAAa,EAAU,CAAM,MACvB,CACX,IAAK,IAAM,KAAQ,EACb,EAAK,YAAY,EAAK,WAAW,YAAY,CAAI,CAEzD,CACF,CACF,CACF,CAEA,SAAS,EAAW,EAAuB,CACzC,OAAO,EACJ,QAAQ,KAAM,OAAO,CAAC,CACtB,QAAQ,KAAM,QAAQ,CAAC,CACvB,QAAQ,KAAM,MAAM,CAAC,CACrB,QAAQ,KAAM,MAAM,CACzB"}

package/dist/lib/image/index.d.cts

@@ -0,0 +1,37 @@
+import { type ElurTemplate } from "@elurjs/core";
+export { consumeImageRegistry, setImageManifest, type ImageFormat } from "./registry.js";
+export interface ImageOptions {
+    /** Source path relative to the public directory, e.g. "/images/hero.jpg". */
+    src: string;
+    /** Alt text (required for accessibility). */
+    alt: string;
+    /** Intrinsic width of the source image in pixels. */
+    width: number;
+    /** Intrinsic height of the source image in pixels. */
+    height: number;
+    /** Responsive widths to generate for srcset. Defaults to [width]. */
+    widths?: number[];
+    /** Sizes attribute for responsive layout, e.g. "100vw" or "(min-width: 768px) 50vw, 100vw". */
+    sizes?: string;
+    /** If true, loads eagerly with high priority (for above-the-fold images). */
+    priority?: boolean;
+    /** CSS class for the img element. */
+    class?: string;
+    /** Additional HTML attributes. */
+    attributes?: Record<string, string>;
+}
+/**
+ * Creates a ElurTemplate that renders an optimized `<img>` or `<picture>` element.
+ *
+ * When a manifest is active (post-build or SSR with manifest loaded):
+ *   * Emits `<picture>` with `<source>` per format and real hashed variant URLs.
+ *   * Uses real dimensions from the manifest.
+ *
+ * When no manifest is active (first build pass, dev without sharp):
+ *   * Emits a plain `<img>` with the original src.
+ *   * Does NOT emit srcset with unresolved variant URLs.
+ *   * Registers the image for build-time processing.
+ */
+export declare function image(opts: ImageOptions): ElurTemplate;
+export { processImageBatch, readManifest, writeManifest, getManifestEntry, buildSrcset, buildPictureMarkup, validateManifestUrls, isSharpAvailable, getImage, createImageService, transformHash, } from "./service.js";
+export type { ImageManifest, ImageEntry, ImageVariant, ProcessOptions, ProcessResult, ImageRequest, ImageMetadata, GeneratedImage, ImageService, ImageServiceCapabilities, ImageServiceContext, } from "./service.js";

package/dist/lib/image/index.d.ts

@@ -0,0 +1,37 @@
+import { type ElurTemplate } from "@elurjs/core";
+export { consumeImageRegistry, setImageManifest, type ImageFormat } from "./registry.js";
+export interface ImageOptions {
+    /** Source path relative to the public directory, e.g. "/images/hero.jpg". */
+    src: string;
+    /** Alt text (required for accessibility). */
+    alt: string;
+    /** Intrinsic width of the source image in pixels. */
+    width: number;
+    /** Intrinsic height of the source image in pixels. */
+    height: number;
+    /** Responsive widths to generate for srcset. Defaults to [width]. */
+    widths?: number[];
+    /** Sizes attribute for responsive layout, e.g. "100vw" or "(min-width: 768px) 50vw, 100vw". */
+    sizes?: string;
+    /** If true, loads eagerly with high priority (for above-the-fold images). */
+    priority?: boolean;
+    /** CSS class for the img element. */
+    class?: string;
+    /** Additional HTML attributes. */
+    attributes?: Record<string, string>;
+}
+/**
+ * Creates a ElurTemplate that renders an optimized `<img>` or `<picture>` element.
+ *
+ * When a manifest is active (post-build or SSR with manifest loaded):
+ *   * Emits `<picture>` with `<source>` per format and real hashed variant URLs.
+ *   * Uses real dimensions from the manifest.
+ *
+ * When no manifest is active (first build pass, dev without sharp):
+ *   * Emits a plain `<img>` with the original src.
+ *   * Does NOT emit srcset with unresolved variant URLs.
+ *   * Registers the image for build-time processing.
+ */
+export declare function image(opts: ImageOptions): ElurTemplate;
+export { processImageBatch, readManifest, writeManifest, getManifestEntry, buildSrcset, buildPictureMarkup, validateManifestUrls, isSharpAvailable, getImage, createImageService, transformHash, } from "./service.js";
+export type { ImageManifest, ImageEntry, ImageVariant, ProcessOptions, ProcessResult, ImageRequest, ImageMetadata, GeneratedImage, ImageService, ImageServiceCapabilities, ImageServiceContext, } from "./service.js";

package/dist/lib/image/index.js

@@ -0,0 +1,49 @@
+import { buildPictureMarkup as e, buildSrcset as t, createImageService as n, getImage as r, getManifestEntry as i, isSharpAvailable as a, processImageBatch as o, readManifest as s, transformHash as c, validateManifestUrls as l, writeManifest as u } from "./service.js";
+import { consumeImageRegistry as d, getActiveManifest as f, registerImage as p, setImageManifest as m } from "./registry.js";
+import { ELUR_RENDER_PROTOCOL as h } from "@elurjs/core";
+//#region src/image/index.ts
+function g(t) {
+	let { src: n, alt: r, width: a, height: o, widths: s = [a], sizes: c, priority: l = !1, class: u, attributes: d = {} } = t;
+	p(n, s);
+	let m, g = f(), v = g ? i(g, n) : void 0;
+	if (v && v.variants.length > 0) m = e(v, {
+		alt: r,
+		sizes: c,
+		priority: l,
+		class: u,
+		attributes: d,
+		fallbackSrc: n,
+		fallbackWidth: a,
+		fallbackHeight: o
+	});
+	else {
+		let e = l ? "" : " loading=\"lazy\"", t = l ? " fetchpriority=\"high\"" : "", i = c ? ` sizes="${_(c)}"` : "", s = u ? ` class="${_(u)}"` : "", f = Object.entries(d).map(([e, t]) => ` ${_(e)}="${_(String(t))}"`).join("");
+		m = `<img src="${_(n)}" alt="${_(r)}" width="${a}" height="${o}"${i}${e} decoding="async"${t}${s}${f} />`;
+	}
+	return {
+		__isElurTemplate: !0,
+		[h]: { renderServer: () => m },
+		mount(e) {
+			let t = typeof e == "string" ? document.querySelector(e) : e;
+			if (!t) throw Error("[elur-kit] image(): container not found");
+			return t.innerHTML = m, { unmount() {
+				t.innerHTML = "";
+			} };
+		},
+		_render(e, t) {
+			let n = document.createElement("template");
+			n.innerHTML = m;
+			let r = n.content, i = Array.from(r.childNodes);
+			return e.insertBefore(r, t), () => {
+				for (let e of i) e.parentNode && e.parentNode.removeChild(e);
+			};
+		}
+	};
+}
+function _(e) {
+	return e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+//#endregion
+export { e as buildPictureMarkup, t as buildSrcset, d as consumeImageRegistry, n as createImageService, r as getImage, i as getManifestEntry, g as image, a as isSharpAvailable, o as processImageBatch, s as readManifest, m as setImageManifest, c as transformHash, l as validateManifestUrls, u as writeManifest };
+
+//# sourceMappingURL=index.js.map

package/dist/lib/image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/image/index.ts"],"sourcesContent":["// --- image() helper: optimized <img> / <picture> without dependencies ---\n//\n// Emits an `<img>` (or `<picture>` when processed variants are available) with:\n//   - `srcset` / `sizes` for responsive images\n//   - `loading=\"lazy\"` and `decoding=\"async\"` (unless `priority`)\n//   - `width` / `height` to prevent layout shift (CLS)\n//   - `fetchpriority=\"high\"` for above-the-fold images\n//\n// When the build-time pipeline (sharp) is available, `image()` registers the\n// source for processing and emits `<picture>` with `<source>` per format.\n// When sharp is not installed, it falls back to a plain `<img>` with srcset\n// pointing to the original file.\n\nimport { ELUR_RENDER_PROTOCOL, type ElurTemplate } from \"@elurjs/core\";\nimport { getManifestEntry, buildPictureMarkup } from \"./service.js\";\nimport {\n  registerImage,\n  getActiveManifest,\n} from \"./registry.js\";\n\nexport { consumeImageRegistry, setImageManifest, type ImageFormat } from \"./registry.js\";\n\nexport interface ImageOptions {\n  /** Source path relative to the public directory, e.g. \"/images/hero.jpg\". */\n  src: string;\n  /** Alt text (required for accessibility). */\n  alt: string;\n  /** Intrinsic width of the source image in pixels. */\n  width: number;\n  /** Intrinsic height of the source image in pixels. */\n  height: number;\n  /** Responsive widths to generate for srcset. Defaults to [width]. */\n  widths?: number[];\n  /** Sizes attribute for responsive layout, e.g. \"100vw\" or \"(min-width: 768px) 50vw, 100vw\". */\n  sizes?: string;\n  /** If true, loads eagerly with high priority (for above-the-fold images). */\n  priority?: boolean;\n  /** CSS class for the img element. */\n  class?: string;\n  /** Additional HTML attributes. */\n  attributes?: Record<string, string>;\n}\n\n/**\n * Creates a ElurTemplate that renders an optimized `<img>` or `<picture>` element.\n *\n * When a manifest is active (post-build or SSR with manifest loaded):\n *   * Emits `<picture>` with `<source>` per format and real hashed variant URLs.\n *   * Uses real dimensions from the manifest.\n *\n * When no manifest is active (first build pass, dev without sharp):\n *   * Emits a plain `<img>` with the original src.\n *   * Does NOT emit srcset with unresolved variant URLs.\n *   * Registers the image for build-time processing.\n */\nexport function image(opts: ImageOptions): ElurTemplate {\n  const {\n    src,\n    alt,\n    width,\n    height,\n    widths = [width],\n    sizes,\n    priority = false,\n    class: className,\n    attributes = {},\n  } = opts;\n\n  // Register for build-time processing.\n  registerImage(src, widths);\n\n  // If a manifest is active and has an entry for this src, emit <picture>.\n  let html: string;\n  const manifest = getActiveManifest();\n  const entry = manifest ? getManifestEntry(manifest, src) : undefined;\n  if (entry && entry.variants.length > 0) {\n    html = buildPictureMarkup(entry, {\n      alt,\n      sizes,\n      priority,\n      class: className,\n      attributes,\n      fallbackSrc: src,\n      fallbackWidth: width,\n      fallbackHeight: height,\n    });\n  } else {\n    // No manifest or no variants: emit a plain <img> with the original src.\n    // Do NOT emit srcset — the variant files don't exist yet.\n    const loadingAttr = priority ? \"\" : ' loading=\"lazy\"';\n    const fetchPriorityAttr = priority ? ' fetchpriority=\"high\"' : \"\";\n    const sizesAttr = sizes ? ` sizes=\"${escapeAttr(sizes)}\"` : \"\";\n    const classAttr = className ? ` class=\"${escapeAttr(className)}\"` : \"\";\n    const extraAttrs = Object.entries(attributes)\n      .map(([key, value]) => ` ${escapeAttr(key)}=\"${escapeAttr(String(value))}\"`)\n      .join(\"\");\n    html = `<img src=\"${escapeAttr(src)}\" alt=\"${escapeAttr(alt)}\" width=\"${width}\" height=\"${height}\"${sizesAttr}${loadingAttr} decoding=\"async\"${fetchPriorityAttr}${classAttr}${extraAttrs} />`;\n  }\n\n  return {\n    __isElurTemplate: true as const,\n    [ELUR_RENDER_PROTOCOL]: {\n      renderServer: () => html,\n    },\n    mount(container: Element | string) {\n      const el = typeof container === \"string\" ? document.querySelector(container) : container;\n      if (!el) throw new Error(\"[elur-kit] image(): container not found\");\n      el.innerHTML = html;\n      return { unmount() { el.innerHTML = \"\"; } };\n    },\n    _render(parent: Node, before: Node | null): () => void {\n      const wrapper = document.createElement(\"template\");\n      wrapper.innerHTML = html;\n      const fragment = wrapper.content;\n      const inserted = Array.from(fragment.childNodes);\n      parent.insertBefore(fragment, before);\n      return () => {\n        for (const node of inserted) {\n          if (node.parentNode) node.parentNode.removeChild(node);\n        }\n      };\n    },\n  } as unknown as ElurTemplate;\n}\n\nfunction escapeAttr(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\");\n}\n\nexport {\n  processImageBatch,\n  readManifest,\n  writeManifest,\n  getManifestEntry,\n  buildSrcset,\n  buildPictureMarkup,\n  validateManifestUrls,\n  isSharpAvailable,\n  getImage,\n  createImageService,\n  transformHash,\n} from \"./service.js\";\nexport type {\n  ImageManifest,\n  ImageEntry,\n  ImageVariant,\n  ProcessOptions,\n  ProcessResult,\n  ImageRequest,\n  ImageMetadata,\n  GeneratedImage,\n  ImageService,\n  ImageServiceCapabilities,\n  ImageServiceContext,\n} from \"./service.js\";\n"],"mappings":";;;;AAuDA,SAAgB,EAAM,GAAkC;CACtD,IAAM,EACJ,QACA,QACA,UACA,WACA,YAAS,CAAC,CAAK,GACf,UACA,cAAW,IACX,OAAO,GACP,gBAAa,CAAC,MACZ;CAGJ,EAAc,GAAK,CAAM;CAGzB,IAAI,GACE,IAAW,EAAkB,GAC7B,IAAQ,IAAW,EAAiB,GAAU,CAAG,IAAI,KAAA;CAC3D,IAAI,KAAS,EAAM,SAAS,SAAS,GACnC,IAAO,EAAmB,GAAO;EAC/B;EACA;EACA;EACA,OAAO;EACP;EACA,aAAa;EACb,eAAe;EACf,gBAAgB;CAClB,CAAC;MACI;EAGL,IAAM,IAAc,IAAW,KAAK,qBAC9B,IAAoB,IAAW,4BAA0B,IACzD,IAAY,IAAQ,WAAW,EAAW,CAAK,EAAE,KAAK,IACtD,IAAY,IAAY,WAAW,EAAW,CAAS,EAAE,KAAK,IAC9D,IAAa,OAAO,QAAQ,CAAU,CAAC,CAC1C,KAAK,CAAC,GAAK,OAAW,IAAI,EAAW,CAAG,EAAE,IAAI,EAAW,OAAO,CAAK,CAAC,EAAE,EAAE,CAAC,CAC3E,KAAK,EAAE;EACV,IAAO,aAAa,EAAW,CAAG,EAAE,SAAS,EAAW,CAAG,EAAE,WAAW,EAAM,YAAY,EAAO,GAAG,IAAY,EAAY,mBAAmB,IAAoB,IAAY,EAAW;CAC5L;CAEA,OAAO;EACL,kBAAkB;GACjB,IAAuB,EACtB,oBAAoB,EACtB;EACA,MAAM,GAA6B;GACjC,IAAM,IAAK,OAAO,KAAc,WAAW,SAAS,cAAc,CAAS,IAAI;GAC/E,IAAI,CAAC,GAAI,MAAU,MAAM,yCAAyC;GAElE,OADA,EAAG,YAAY,GACR,EAAE,UAAU;IAAE,EAAG,YAAY;GAAI,EAAE;EAC5C;EACA,QAAQ,GAAc,GAAiC;GACrD,IAAM,IAAU,SAAS,cAAc,UAAU;GACjD,EAAQ,YAAY;GACpB,IAAM,IAAW,EAAQ,SACnB,IAAW,MAAM,KAAK,EAAS,UAAU;GAE/C,OADA,EAAO,aAAa,GAAU,CAAM,SACvB;IACX,KAAK,IAAM,KAAQ,GACjB,AAAI,EAAK,cAAY,EAAK,WAAW,YAAY,CAAI;GAEzD;EACF;CACF;AACF;AAEA,SAAS,EAAW,GAAuB;CACzC,OAAO,EACJ,QAAQ,MAAM,OAAO,CAAC,CACtB,QAAQ,MAAM,QAAQ,CAAC,CACvB,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,MAAM;AACzB"}

package/dist/lib/image/pipeline.d.cts

@@ -0,0 +1,37 @@
+import type { ImageFormat } from "./index.js";
+export interface PipelineOptions {
+    /** Absolute path to the public directory (source images live here). */
+    publicDir: string;
+    /** Absolute path to the output directory (variants are written here). */
+    outDir: string;
+    /** Formats to generate. Defaults to ["webp", "avif"]. */
+    formats?: ImageFormat[];
+    /** Quality (1-100). Defaults to 80. */
+    quality?: number;
+}
+export interface ProcessedImage {
+    /** Original source path (e.g. "/images/hero.jpg"). */
+    src: string;
+    /** Generated variant paths relative to outDir. */
+    variants: {
+        path: string;
+        width: number;
+        format: ImageFormat;
+    }[];
+}
+/**
+ * Processes a batch of images: for each image, generates variants at the
+ * specified widths and formats using sharp. Returns the list of generated
+ * files.
+ *
+ * If sharp is not installed, returns an empty array and logs a warning once.
+ */
+export declare function processImages(images: {
+    src: string;
+    widths: number[];
+    formats: ImageFormat[];
+}[], options: PipelineOptions): Promise<ProcessedImage[]>;
+/**
+ * Checks whether sharp is available without actually loading it.
+ */
+export declare function isSharpAvailable(): Promise<boolean>;

package/dist/lib/image/pipeline.d.ts

@@ -0,0 +1,37 @@
+import type { ImageFormat } from "./index.js";
+export interface PipelineOptions {
+    /** Absolute path to the public directory (source images live here). */
+    publicDir: string;
+    /** Absolute path to the output directory (variants are written here). */
+    outDir: string;
+    /** Formats to generate. Defaults to ["webp", "avif"]. */
+    formats?: ImageFormat[];
+    /** Quality (1-100). Defaults to 80. */
+    quality?: number;
+}
+export interface ProcessedImage {
+    /** Original source path (e.g. "/images/hero.jpg"). */
+    src: string;
+    /** Generated variant paths relative to outDir. */
+    variants: {
+        path: string;
+        width: number;
+        format: ImageFormat;
+    }[];
+}
+/**
+ * Processes a batch of images: for each image, generates variants at the
+ * specified widths and formats using sharp. Returns the list of generated
+ * files.
+ *
+ * If sharp is not installed, returns an empty array and logs a warning once.
+ */
+export declare function processImages(images: {
+    src: string;
+    widths: number[];
+    formats: ImageFormat[];
+}[], options: PipelineOptions): Promise<ProcessedImage[]>;
+/**
+ * Checks whether sharp is available without actually loading it.
+ */
+export declare function isSharpAvailable(): Promise<boolean>;

package/dist/lib/image/registry.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=[],t=null;function n(e){t=e}function r(){return t}function i(){let t=[...e];return e.length=0,t}function a(t,n){e.find(e=>e.src===t&&e.widths.join(`,`)===n.join(`,`))||e.push({src:t,widths:n,formats:[`webp`,`avif`]})}exports.consumeImageRegistry=i,exports.getActiveManifest=r,exports.registerImage=a,exports.setImageManifest=n;
+//# sourceMappingURL=registry.cjs.map

package/dist/lib/image/registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.cjs","names":[],"sources":["../../../src/image/registry.ts"],"sourcesContent":["// --- Shared image registry (build-time singleton) ---\n//\n// This module owns the mutable state the image pipeline relies on:\n//   * `renderRegistry`  — images registered by `image()` during a render pass.\n//   * `activeManifest`  — the processed manifest used to emit `<picture>`.\n//\n// It MUST stay in its own chunk (`dist/lib/image/registry.js`) so that both the\n// CLI bundle (`dist/lib/cli.js`) and the library entry (`dist/lib/image/index.js`)\n// import the *same* physical module instance. If the registry state is inlined\n// into the CLI, `consumeImageRegistry()` reads a different (empty) array than\n// the one the app's `image()` calls populated, and the two-pass build silently\n// processes nothing. Both vite configs externalize this chunk to enforce that.\n\nimport type { ImageManifest } from \"./service.js\";\n\nexport type ImageFormat = \"webp\" | \"avif\" | \"jpeg\" | \"png\";\n\nexport interface RegisteredImage {\n  src: string;\n  widths: number[];\n  formats: ImageFormat[];\n}\n\nconst renderRegistry: RegisteredImage[] = [];\n\n/**\n * The active image manifest (if loaded). When set, image() emits real\n * <picture>/<source> markup from the manifest instead of a plain <img>.\n */\nlet activeManifest: ImageManifest | null = null;\n\n/**\n * Set the active image manifest. Called by the build pipeline after\n * processing, or by the SSR server on startup.\n */\nexport function setImageManifest(manifest: ImageManifest | null): void {\n  activeManifest = manifest;\n}\n\n/**\n * Returns the currently active image manifest (or null). Used by `image()`\n * to decide between `<picture>` (manifest present) and plain `<img>`.\n */\nexport function getActiveManifest(): ImageManifest | null {\n  return activeManifest;\n}\n\n/**\n * Returns the images registered during the current render pass and clears\n * the registry. Called by the build pipeline after rendering all pages.\n */\nexport function consumeImageRegistry(): RegisteredImage[] {\n  const items = [...renderRegistry];\n  renderRegistry.length = 0;\n  return items;\n}\n\n/**\n * Registers an image for build-time processing (if sharp is available).\n */\nexport function registerImage(src: string, widths: number[]): void {\n  // Avoid duplicates in the same render pass.\n  const existing = renderRegistry.find(\n    (r) => r.src === src && r.widths.join(\",\") === widths.join(\",\"),\n  );\n  if (!existing) {\n    renderRegistry.push({ src, widths, formats: [\"webp\", \"avif\"] });\n  }\n}\n"],"mappings":"mEAuBA,IAAM,EAAoC,CAAC,EAMvC,EAAuC,KAM3C,SAAgB,EAAiB,EAAsC,CACrE,EAAiB,CACnB,CAMA,SAAgB,GAA0C,CACxD,OAAO,CACT,CAMA,SAAgB,GAA0C,CACxD,IAAM,EAAQ,CAAC,GAAG,CAAc,EAEhC,MADA,GAAe,OAAS,EACjB,CACT,CAKA,SAAgB,EAAc,EAAa,EAAwB,CAEhD,EAAe,KAC7B,GAAM,EAAE,MAAQ,GAAO,EAAE,OAAO,KAAK,GAAG,IAAM,EAAO,KAAK,GAAG,CAE3D,GACH,EAAe,KAAK,CAAE,MAAK,SAAQ,QAAS,CAAC,OAAQ,MAAM,CAAE,CAAC,CAElE"}