@vesk/runtime 0.1.1 → 0.2.8

package/dist/form.js

@@ -56,7 +56,7 @@ export function custom(fn, msg) {
 export function Field(props, registry, hydrate) {
     const { name, label, rules = [], children, errorClass, class: className, style, ...rest } = props;
     if (formIsSSR()) {
-        const labelHtml = label ? `<label>${label}</label>` : '';
+        const labelHtml = label ? `<label>${escapeHtml(String(label))}</label>` : '';
         const serverErrors = readServerFieldErrors();
         const serverErr = serverErrors[name] ? String(serverErrors[name]) : '';
         const errStyle = serverErr ? '' : 'display:none';

package/dist/headless.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Headless component primitives — Show, For, Switch/Match.
+ * Thin wrappers that work on both server and client; SSR renders directly,
+ * client is reactive via the parent's effect system (props.when is read via
+ * normal prop passing, so include them inside a reactive context or use
+ * `effect` inside if you need fine-grained updates).
+ */
+export interface ShowProps {
+    when: unknown;
+    children?: unknown;
+    fallback?: unknown;
+}
+export declare function Show(props: ShowProps): unknown;
+export interface ForProps<T> {
+    each: readonly T[] | null | undefined;
+    children: (item: T, index: number) => unknown;
+    fallback?: unknown;
+}
+export declare function For<T>(props: ForProps<T>): unknown;
+export interface SwitchProps {
+    children?: unknown;
+    fallback?: unknown;
+}
+export declare function Switch(props: SwitchProps): unknown;
+export interface MatchProps {
+    when: unknown;
+    children?: unknown;
+}
+export declare function Match(props: MatchProps): unknown;
+//# sourceMappingURL=headless.d.ts.map

package/dist/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../src/headless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE9C;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAWlD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAUlD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEhD"}

package/dist/headless.js

@@ -0,0 +1,39 @@
+/**
+ * Headless component primitives — Show, For, Switch/Match.
+ * Thin wrappers that work on both server and client; SSR renders directly,
+ * client is reactive via the parent's effect system (props.when is read via
+ * normal prop passing, so include them inside a reactive context or use
+ * `effect` inside if you need fine-grained updates).
+ */
+export function Show(props) {
+    return props.when ? props.children : props.fallback ?? null;
+}
+export function For(props) {
+    const list = props.each;
+    if (!list || list.length === 0)
+        return props.fallback ?? null;
+    // `children` is a render function: (item, index) => VNode
+    // In .vsk, usage is <For each={items}>{(item, i) => <li>{item}</li>}</For>
+    // At runtime, `props.children` is the function.
+    const fn = props.children;
+    if (typeof fn !== 'function')
+        return null;
+    // Preserve keyed reconciliation? For now, simple map.
+    // The caller can use `key` on the returned element if needed.
+    return list.map((item, idx) => fn(item, idx));
+}
+export function Switch(props) {
+    const children = props.children;
+    const list = Array.isArray(children) ? children : children != null ? [children] : [];
+    for (const child of list) {
+        // Each child is expected to be a Match element's rendered output.
+        // Match returns its children when `when` is truthy, otherwise null.
+        // So Switch just returns the first non-null/defined child.
+        if (child != null && child !== false && child !== '')
+            return child;
+    }
+    return props.fallback ?? null;
+}
+export function Match(props) {
+    return props.when ? props.children : null;
+}

package/dist/hmr-client.js

@@ -17,6 +17,9 @@
             ws.onmessage = function (e) {
                 try {
                     var msg = JSON.parse(e.data);
+                    if (msg.nonce && !globalThis.__vesk_hmr_nonce) {
+                        globalThis.__vesk_hmr_nonce = msg.nonce;
+                    }
                     switch (msg.type) {
                         case 'update':
                             if (msg.fnSources) {
@@ -26,7 +29,7 @@
                                 catch (ex) {
                                     console.error('HMR eval error:', ex);
                                 } };
-                                Object.values(msg.fnSources).forEach(function (fn) { _eval(fn); });
+                                Object.values(msg.fnSources).forEach(function (fn) { _eval(fn, msg.nonce); });
                             }
                             globalThis.__updatedComponents = new Set(Object.keys((msg.components || {})));
                             var router = globalThis.__vesk_router;
@@ -190,7 +193,7 @@
                     tipsHtml += '<div class="__vo_tips_title">Debug Tips</div>';
                     shownHeader = true;
                 }
-                tipsHtml += '<div class="__vo_tip">' + msg.tips[t] + '</div>';
+                tipsHtml += '<div class="__vo_tip">' + escapeHtml(msg.tips[t]) + '</div>';
             }
         }
         if (msg.suggestions && msg.suggestions.length > 0) {

package/dist/index-client.d.ts

@@ -2,6 +2,8 @@ export { track, get, set, untrack, peek_tracked as peek, derived, flush_sync as
 export { effect, user_effect, block, branch, root, render, pre_effect, destroy_block, destroy_block_children, pause_block, resume_block, is_destroyed, unlink_block, create_try_block, boundary_fn_running_block } from '@vesk/runtime/src/ripple-blocks';
 export { hydrate, hydrateViewport, hydrateIdle, hydrateOnInteraction, needsHydration, hydrationCount, createHydrateWalker, collectVskMarkers, reactiveProps, hydrateInitial } from '@vesk/runtime/src/hydrate';
 export { createRouter, createFileRouter, Outlet, Link, NavLink, useNavigate, useParams, usePathname, useSearchParams, useRouter, buildRouteTree, defineRoute, Redirect, redirect, permanentRedirect, notFound, NotFoundError, ensureChunk, matchRoute } from '@vesk/runtime/src/router';
+export { getNetworkState, watchNetwork } from '@vesk/runtime/src/network';
+export type { NetworkState, EffectiveType } from '@vesk/runtime/src/network';
 export { bindValue, bindChecked, bindGroup } from '@vesk/runtime/src/bindings';
 export { createContext, Context, getActiveComponent, setActiveComponent } from '@vesk/runtime/src/context';
 export { createResource, setSsrData, clearSsrData, resolveSsrResources, useFetch } from '@vesk/runtime/src/resource';
@@ -12,5 +14,8 @@ export { Image } from '@vesk/runtime/src/image';
 export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
+export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError, LOADING_INDICATOR_DEFAULT_COLOR, LOADING_INDICATOR_DEFAULT_ERROR_COLOR } from '@vesk/runtime/src/loading-indicator';
+export type { LoadingIndicatorHandle, LoadingIndicatorOptions, LoadingIndicatorProps } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';
 //# sourceMappingURL=index-client.d.ts.map

package/dist/index-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-client.d.ts","sourceRoot":"","sources":["../src/index-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACtf,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC1P,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC/M,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxR,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACrH,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxK,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index-client.d.ts","sourceRoot":"","sources":["../src/index-client.ts"],"names":[],"mappings":"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"}

package/dist/index-client.js

@@ -2,6 +2,7 @@ export { track, get, set, untrack, peek_tracked as peek, derived, flush_sync as
 export { effect, user_effect, block, branch, root, render, pre_effect, destroy_block, destroy_block_children, pause_block, resume_block, is_destroyed, unlink_block, create_try_block, boundary_fn_running_block } from '@vesk/runtime/src/ripple-blocks';
 export { hydrate, hydrateViewport, hydrateIdle, hydrateOnInteraction, needsHydration, hydrationCount, createHydrateWalker, collectVskMarkers, reactiveProps, hydrateInitial } from '@vesk/runtime/src/hydrate';
 export { createRouter, createFileRouter, Outlet, Link, NavLink, useNavigate, useParams, usePathname, useSearchParams, useRouter, buildRouteTree, defineRoute, Redirect, redirect, permanentRedirect, notFound, NotFoundError, ensureChunk, matchRoute } from '@vesk/runtime/src/router';
+export { getNetworkState, watchNetwork } from '@vesk/runtime/src/network';
 export { bindValue, bindChecked, bindGroup } from '@vesk/runtime/src/bindings';
 export { createContext, Context, getActiveComponent, setActiveComponent } from '@vesk/runtime/src/context';
 export { createResource, setSsrData, clearSsrData, resolveSsrResources, useFetch } from '@vesk/runtime/src/resource';
@@ -12,4 +13,6 @@ export { Image } from '@vesk/runtime/src/image';
 export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
+export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError, LOADING_INDICATOR_DEFAULT_COLOR, LOADING_INDICATOR_DEFAULT_ERROR_COLOR } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';

package/dist/index-router.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @vesk/router — the canonical public entry point for everything
+ * navigation/routing related.
+ *
+ * ```js
+ * import { Link, NavLink, useRouter, useNavigate } from '@vesk/router';
+ * ```
+ *
+ * The `@vesk/runtime` barrels keep thin back-compat re-exports of this surface
+ * because the compiler's auto-import machinery and the client bootstrap
+ * resolve through them — new application code should prefer `@vesk/router`.
+ */
+export { createRouter, createFileRouter, Outlet, Link, NavLink, useNavigate, useParams, usePathname, useSearchParams, useRouter, buildRouteTree, defineRoute, Redirect, redirect, permanentRedirect, NotFoundError, notFound, ensureChunk, matchRoute, } from '@vesk/runtime/src/router';
+export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, loadingStart, loadingSet, loadingFinish, loadingClear, getLoadingProgress, isLoadingActive, getLoadingError, getLoadingState, LOADING_INDICATOR_DEFAULT_COLOR, LOADING_INDICATOR_DEFAULT_ERROR_COLOR, } from '@vesk/runtime/src/loading-indicator';
+export type { LoadingIndicatorHandle, LoadingIndicatorOptions, LoadingIndicatorProps, } from '@vesk/runtime/src/loading-indicator';
+//# sourceMappingURL=index-router.d.ts.map

package/dist/index-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-router.d.ts","sourceRoot":"","sources":["../src/index-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACN,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,IAAI,EAAE,OAAO,EACrB,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAC/D,cAAc,EAAE,WAAW,EAC3B,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,QAAQ,EAC9D,WAAW,EAAE,UAAU,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACN,gBAAgB,EAAE,mBAAmB,EAAE,yBAAyB,EAChE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EACrD,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EACrE,+BAA+B,EAAE,qCAAqC,GACtE,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACX,sBAAsB,EAAE,uBAAuB,EAAE,qBAAqB,GACtE,MAAM,qCAAqC,CAAC"}

package/dist/index-router.js

@@ -0,0 +1,15 @@
+/**
+ * @vesk/router — the canonical public entry point for everything
+ * navigation/routing related.
+ *
+ * ```js
+ * import { Link, NavLink, useRouter, useNavigate } from '@vesk/router';
+ * ```
+ *
+ * The `@vesk/runtime` barrels keep thin back-compat re-exports of this surface
+ * because the compiler's auto-import machinery and the client bootstrap
+ * resolve through them — new application code should prefer `@vesk/router`.
+ */
+export { createRouter, createFileRouter, Outlet, Link, NavLink, useNavigate, useParams, usePathname, useSearchParams, useRouter, buildRouteTree, defineRoute, Redirect, redirect, permanentRedirect, NotFoundError, notFound, ensureChunk, matchRoute, } from '@vesk/runtime/src/router';
+// Navigation-driven loading state (the bar the router drives + custom UIs).
+export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, loadingStart, loadingSet, loadingFinish, loadingClear, getLoadingProgress, isLoadingActive, getLoadingError, getLoadingState, LOADING_INDICATOR_DEFAULT_COLOR, LOADING_INDICATOR_DEFAULT_ERROR_COLOR, } from '@vesk/runtime/src/loading-indicator';

package/dist/index-server.d.ts

@@ -11,5 +11,8 @@ export { Image } from '@vesk/runtime/src/image';
 export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
+export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError } from '@vesk/runtime/src/loading-indicator';
+export type { LoadingIndicatorHandle, LoadingIndicatorOptions, LoadingIndicatorProps } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';
 //# sourceMappingURL=index-server.d.ts.map

package/dist/index-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-server.d.ts","sourceRoot":"","sources":["../src/index-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC5S,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC1P,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACnJ,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,IAAI,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/Q,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnT,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC7J,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxK,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index-server.d.ts","sourceRoot":"","sources":["../src/index-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC5S,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC1P,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACnJ,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,IAAI,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/Q,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnT,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC7J,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxK,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC7K,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAClI,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index-server.js

@@ -11,4 +11,6 @@ export { Image } from '@vesk/runtime/src/image';
 export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
+export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';

package/dist/loading-indicator.d.ts

@@ -0,0 +1,127 @@
+/**
+ * LoadingIndicator — a Nuxt-style page-navigation progress bar.
+ *
+ * A global singleton driven by the router: `loadingStart()` fires when an SPA
+ * navigation begins and `loadingFinish()` when its content (and route data)
+ * has settled. `<LoadingIndicator/>` renders the bar anywhere in a layout;
+ * `useLoadingIndicator()` exposes the reactive state for fully custom UIs.
+ *
+ * Progress backs off as it approaches 100% (atan curve) so long loads never
+ * prematurely complete; short navigations stay invisible thanks to `throttle`.
+ * State lives in tracked cells so any `effect()`-driven UI updates live.
+ */
+import type { Tracked } from '@vesk/runtime/src/ripple-runtime';
+export interface LoadingIndicatorOptions {
+    /** Total duration of the progress animation, ms. Default 2000. */
+    duration?: number;
+    /** Delay before the bar appears/starts animating, ms. Default 200. */
+    throttle?: number;
+    /** How long the completed bar stays visible before hiding, ms. Default 500. */
+    hideDelay?: number;
+    /** How long after hiding before progress resets to 0, ms. Default 400. */
+    resetDelay?: number;
+    /**
+     * Custom progress estimator receiving `(duration, elapsedMs)` and
+     * returning 0–100. Defaults to an atan back-off curve.
+     */
+    estimatedProgress?: (duration: number, elapsed: number) => number;
+}
+/** Merges option overrides into the global singleton (used by the component's props). */
+export declare function configureLoadingIndicator(opts?: LoadingIndicatorOptions): void;
+/**
+ * Starts the loading animation from 0%. Without `{ force: true }` the bar
+ * waits `throttle` ms before becoming visible, so fast navigations never flash.
+ */
+export declare function loadingStart(opts?: {
+    force?: boolean;
+}): void;
+/**
+ * Jumps the bar to a specific progress value (0–100). Values ≥ 100 finish.
+ * A manual set takes control: the automatic estimation stops until the next
+ * `start()`, so the value sticks instead of being overwritten by a frame.
+ */
+export declare function loadingSet(at?: number, opts?: {
+    force?: boolean;
+}): void;
+/**
+ * Completes the animation at 100%. With `{ error: true }` the bar switches to
+ * the error color while hiding; with `{ force: true }` it resets instantly.
+ */
+export declare function loadingFinish(opts?: {
+    force?: boolean;
+    error?: boolean;
+}): void;
+/** Cancels the pending appearance timer and animation frame without changing state. */
+export declare function loadingClear(): void;
+export interface LoadingIndicatorHandle {
+    /** Tracked cell — current progress 0–100. Read inside effect()/get(). */
+    progress: Tracked<number>;
+    /** Tracked cell — true once the bar is visible. */
+    isLoading: Tracked<boolean>;
+    /** Tracked cell — true when the last load finished with an error. */
+    error: Tracked<boolean>;
+    start(opts?: {
+        force?: boolean;
+    }): void;
+    set(value: number, opts?: {
+        force?: boolean;
+    }): void;
+    finish(opts?: {
+        force?: boolean;
+        error?: boolean;
+    }): void;
+    clear(): void;
+}
+/**
+ * Accesses the shared loading-indicator singleton. Call this (or render
+ * `<LoadingIndicator/>`) once per app — every call returns the same state,
+ * so programmatic `start()`/`finish()` drive the same bar the router does.
+ */
+export declare function useLoadingIndicator(options?: LoadingIndicatorOptions): LoadingIndicatorHandle;
+export declare function getLoadingProgress(): number;
+export declare function isLoadingActive(): boolean;
+export declare function getLoadingError(): boolean;
+/** The raw tracked cells backing the shared singleton (used by the router). */
+export declare function getLoadingState(): {
+    progress: Tracked<number>;
+    isLoading: Tracked<boolean>;
+    error: Tracked<boolean>;
+};
+export declare const LOADING_INDICATOR_DEFAULT_COLOR = "repeating-linear-gradient(to right,#38bdf8 0%,#6366f1 50%,#8b5cf6 100%)";
+export declare const LOADING_INDICATOR_DEFAULT_ERROR_COLOR = "repeating-linear-gradient(to right,#f87171 0%,#ef4444 100%)";
+export interface LoadingIndicatorProps extends LoadingIndicatorOptions {
+    /** Bar background (CSS color/gradient). `false` disables explicit styling so CSS classes take over. */
+    color?: string | false;
+    /** Background used while the error flag is set. */
+    errorColor?: string;
+    /** Bar height — number (px) or any CSS length. Default 3. */
+    height?: number | string;
+    /** Edge to pin the bar to. Default 'top'. */
+    position?: 'top' | 'bottom';
+    /** Stacking context for the fixed bar. Default 999999. */
+    zIndex?: number;
+    class?: string;
+    className?: string;
+    style?: string;
+    /** Custom inner content replacing the default bar element. */
+    children?: unknown;
+    [k: string]: unknown;
+}
+type HydrateWalker = {
+    nextElement?: (tag?: string) => Element;
+    root?: HTMLElement | null;
+};
+/**
+ * Renders the navigation progress bar. On the server it emits a hidden div
+ * snapshot (never flashes on first paint); on the client it claims that node
+ * during hydration or builds a fresh one for SPA mounts, then keeps its style
+ * in sync with the shared indicator state via an effect.
+ *
+ * Customize with `color`, `errorColor`, `height`, `duration`, `throttle`,
+ * `hideDelay`, `resetDelay`, `estimatedProgress`, `position`, `zIndex`,
+ * `class`/`style` — or pass `children` to replace the bar entirely and drive
+ * your own UI through `useLoadingIndicator()`.
+ */
+export declare function LoadingIndicator(props?: LoadingIndicatorProps, _registry?: Map<string, unknown>, hydrate?: HydrateWalker): Node | string;
+export {};
+//# sourceMappingURL=loading-indicator.d.ts.map

package/dist/loading-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-indicator.d.ts","sourceRoot":"","sources":["../src/loading-indicator.ts"],"names":[],"mappings":"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"}