@tempots/ui 1.2.1 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempots/ui",
-  "version": "1.2.1",
+  "version": "2.0.0",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -40,6 +40,6 @@
     "@floating-ui/dom": "^1.6.7"
   },
   "peerDependencies": {
-    "@tempots/std": "0.17.0"
+    "@tempots/std": "0.18.0"
   }
 }

package/renderables/appearance.d.ts

@@ -22,7 +22,7 @@ export declare const appearanceMarker: import('@tempots/dom').ProviderMark<Signa
  * @returns The child component with the appearance context.
  * @public
  */
-export declare const ProvideAppearance: (child: TNode) => Renderable;
+export declare const ProvideAppearance: (child: (appearance: Signal<AppearanceType>) => TNode) => Renderable;
 /**
  * Makes the AppearanceType available to the child component by consuming the signal provided by the parent.
  * The result of the function is returned as the final output.

package/renderables/resource.d.ts

@@ -1,5 +1,5 @@
-import { Signal, TNode } from '@tempots/dom';
-import { MakeResourceOptions, AsyncResource } from '../utils/resource';
+import { Renderable, Signal, TNode } from '@tempots/dom';
+import { AsyncResource, ResourceLoadOptions } from '../utils/resource';
 /**
  * Options for displaying the different states of an asynchronous resource.
  *
@@ -8,25 +8,13 @@ import { MakeResourceOptions, AsyncResource } from '../utils/resource';
  * @public
  */
 export interface ResourceDisplayOptions<V, E> {
-    /** Function to render when the resource has not been requested yet. */
-    notAsked?: (reload: () => void) => TNode;
     /** Function to render when the resource is loading. */
     loading?: (previous: Signal<V | undefined>, reload: () => void) => TNode;
     /** Function to render when the resource has failed to load. */
-    error?: (error: Signal<E>, reload: () => void) => TNode;
+    failure?: (error: Signal<E>, reload: () => void) => TNode;
     /** Function to render when the resource has successfully loaded. */
     success: (value: Signal<V>, reload: () => void) => TNode;
 }
-/**
- * Options for creating and displaying an asynchronous resource.
- *
- * @template R - The type of the request.
- * @template V - The type of the value when the resource is successfully loaded.
- * @template E - The type of the error when the resource fails to load.
- * @public
- */
-export interface ResourceOptions<R, V, E> extends MakeResourceOptions<R, V, E>, ResourceDisplayOptions<V, E> {
-}
 /**
  * Component to display an asynchronous resource based on its current status.
  *
@@ -38,7 +26,7 @@ export interface ResourceOptions<R, V, E> extends MakeResourceOptions<R, V, E>,
  * @returns {TNode} A node representing the current state of the resource.
  * @public
  */
-export declare const ResourceDisplay: <V, E>(resource: AsyncResource<V, E>, options: ResourceDisplayOptions<V, E>) => import('@tempots/dom').Renderable;
+export declare const ResourceDisplay: <V, E>(resource: AsyncResource<V, E>, options: ResourceDisplayOptions<V, E>) => Renderable;
 /**
  * Creates and displays an asynchronous resource.
  *
@@ -46,8 +34,14 @@ export declare const ResourceDisplay: <V, E>(resource: AsyncResource<V, E>, opti
  * @template V - The type of the value when the resource is successfully loaded.
  * @template E - The type of the error when the resource fails to load.
  *
- * @param {ResourceOptions<R, V, E>} options - The options for creating and displaying the resource.
- * @returns {TNode} A node representing the current state of the resource.
+ * @param request - The request to load the resource.
+ * @param load - The function to load the resource.
+ * @param convertError - The function to convert an unknown error into a specific error type.
+ * @returns A function that takes display options and returns a node representing the current state of the resource.
  * @public
  */
-export declare const Resource: <R, V, E>(options: ResourceOptions<R, V, E>) => import('@tempots/dom').Renderable;
+export declare const Resource: <R, V, E = unknown>({ request, load, mapError, }: {
+    request: Signal<R>;
+    load: (options: ResourceLoadOptions<R, V, E>) => Promise<V>;
+    mapError?: (error: unknown) => E;
+}) => ((displayOptions: ResourceDisplayOptions<V, E>) => Renderable);

package/renderables/router/browser-location.d.ts

@@ -1,23 +1,9 @@
 import { TNode, Prop } from '@tempots/dom';
 import { LocationData } from './location-data';
-/**
- * Creates a location object based on the current browser location.
- * @returns The location object representing the current browser location.
- * @internal
- */
-export declare const _makeLocation: () => LocationData;
-/**
- * Creates a location prop that represents the current browser location.
- * The location prop is updated whenever the browser location changes.
- *
- * @returns The location prop.
- * @internal
- */
-export declare const _makeLocationProp: () => Prop<LocationData>;
 /**
  * Provides the location context to the child component.
  * @param child - The child component to be wrapped with the location context.
  * @returns The wrapped component with the location context.
  * @public
  */
-export declare const ProvideBrowserLocation: (child: TNode) => import('@tempots/dom').Renderable;
+export declare const ProvideBrowserLocation: (child: (location: Prop<LocationData>) => TNode) => import('@tempots/dom').Renderable;

package/renderables/router/headless-location.d.ts

@@ -1,4 +1,5 @@
 import { TNode, Prop } from '@tempots/dom';
+import { LocationData } from './location-data';
 export declare const isAbsoluteURL: (url: string) => boolean;
 /**
  * Provides the location context to the child component.
@@ -6,4 +7,4 @@ export declare const isAbsoluteURL: (url: string) => boolean;
  * @returns The wrapped component with the location context.
  * @public
  */
-export declare const ProvideHeadlessLocation: (url: Prop<string>, child: TNode) => import('@tempots/dom').Renderable;
+export declare const ProvideHeadlessLocation: (url: Prop<string>, child: (location: Prop<LocationData>) => TNode) => import('@tempots/dom').Renderable;

package/renderables/router/location.d.ts

@@ -12,7 +12,7 @@ export declare const LocationProviderMarker: import('@tempots/dom').ProviderMark
  * @returns The wrapped component with the location context.
  * @public
  */
-export declare const ProvideLocation: (child: TNode) => import('@tempots/dom').Renderable;
+export declare const SetLocation: (child: (location: Prop<LocationData>) => TNode) => import('@tempots/dom').Renderable;
 /**
  * A hook that provides the current location data to the given function.
  * @param fn - The function that receives the location data.

package/utils/make-relative-time.d.ts

@@ -1,4 +1,4 @@
-import { Value } from '@tempots/dom';
+import { Value, Signal } from '@tempots/dom';
 /**
  * Creates a signal that automatically updates with the current time at a specified frequency.
  * The signal will clean up its interval when disposed.
@@ -7,7 +7,7 @@ import { Value } from '@tempots/dom';
  * @returns A Value<Date> that updates with the current time at the specified frequency
  * @public
  */
-export declare const makeNowSignal: (frequency?: number) => Value<Date>;
+export declare const nowSignal: (frequency?: number) => Signal<Date>;
 /**
  * Converts a time difference in milliseconds to a human-readable relative time string.
  *
@@ -31,7 +31,7 @@ export declare const timeDiffToString: (diffInMillis: number) => string;
  *          positive values indicate future times. The signal will clean up its resources when disposed.
  * @public
  */
-export declare const makeRelativeTimeMillisSignal: (date: Value<Date>, { now, frequency }?: {
+export declare const relativeTimeMillisSignal: (date: Value<Date>, { now, frequency }?: {
     now?: Value<Date>;
     frequency?: number;
 }) => import('@tempots/dom').Computed<number>;
@@ -46,7 +46,7 @@ export declare const makeRelativeTimeMillisSignal: (date: Value<Date>, { now, fr
  *          The signal will clean up its resources when disposed.
  * @public
  */
-export declare const makeRelativeTimeSignal: (date: Value<Date>, options?: {
+export declare const relativeTimeSignal: (date: Value<Date>, options?: {
     now?: Value<Date>;
     frequency?: number;
 }) => import('@tempots/dom').Computed<string>;
@@ -62,7 +62,7 @@ export declare const makeRelativeTimeSignal: (date: Value<Date>, options?: {
  * @deprecated Use makeRelativeTimeSignal instead
  * @public
  */
-export declare const makeRelativeTime: (date: Value<Date>, options?: {
+export declare const relativeTime: (date: Value<Date>, options?: {
     now?: Value<Date>;
     frequency?: number;
 }) => import('@tempots/dom').Computed<string>;

package/utils/resource.d.ts

@@ -38,22 +38,6 @@ export interface ResourceLoadOptions<R, V, E> {
     /** The previous result of the resource loading, if any. */
     readonly previous: AsyncResult<V, E>;
 }
-/**
- * Options for creating a resource, including the request signal, load function, and error converter.
- *
- * @template R - The type of the request.
- * @template V - The type of the value when the resource is successfully loaded.
- * @template E - The type of the error when the resource fails to load.
- * @public
- */
-export interface MakeResourceOptions<R, V, E> {
-    /** A signal representing the request to load the resource. */
-    readonly request: Signal<R>;
-    /** A function to load the resource, returning a promise of the value. */
-    readonly load: (options: ResourceLoadOptions<R, V, E>) => Promise<V>;
-    /** A function to convert an unknown error into a specific error type. */
-    readonly convertError: (error: unknown) => E;
-}
 /**
  * Creates an asynchronous resource that can be loaded, reloaded, and disposed of.
  *
@@ -61,8 +45,10 @@ export interface MakeResourceOptions<R, V, E> {
  * @template V - The type of the value when the resource is successfully loaded.
  * @template E - The type of the error when the resource fails to load.
  *
- * @param {MakeResourceOptions<R, V, E>} options - The options for creating the resource.
- * @returns {AsyncResource<V, E>} The created asynchronous resource.
+ * @param request - The request to load the resource.
+ * @param load - The function to load the resource.
+ * @param convertError - The function to convert an unknown error into a specific error type.
+ * @returns The created asynchronous resource.
  * @public
  */
-export declare const makeResource: <R, V, E>({ request, load, convertError, }: MakeResourceOptions<R, V, E>) => AsyncResource<V, E>;
+export declare const makeResource: <R, V, E>(request: Signal<R>, load: (options: ResourceLoadOptions<R, V, E>) => Promise<V>, convertError: (error: unknown) => E) => AsyncResource<V, E>;

package/utils/ticker.d.ts

@@ -19,4 +19,4 @@ export declare class Ticker extends Prop<number> {
  * @returns A new Ticker instance that only updates when the value changes
  * @public
  */
-export declare const makeTicker: (initial?: number) => Ticker;
+export declare const ticker: (initial?: number) => Ticker;

package/browser-location-12vUH3Kv.js

@@ -1,41 +0,0 @@
-import { getWindow as r, makeProp as c, Fragment as n, OnDispose as h, WithProvider as i } from "@tempots/dom";
-import { areLocationsEqual as m, urlFromLocation as p, LocationProviderMarker as l } from "./index.js";
-const d = () => {
-  const t = r(), o = (t == null ? void 0 : t.location.hash) === "" ? void 0 : (t == null ? void 0 : t.location.hash.substring(1)) ?? void 0;
-  return {
-    pathname: (t == null ? void 0 : t.location.pathname) ?? "",
-    search: Object.fromEntries(
-      new URLSearchParams((t == null ? void 0 : t.location.search) ?? "").entries()
-    ),
-    hash: o
-  };
-}, L = () => {
-  const t = c(d(), m), o = r(), e = () => {
-    let a = (o == null ? void 0 : o.location.hash) ?? "";
-    a.startsWith("#") && (a = a.substring(1));
-    const s = {
-      pathname: (o == null ? void 0 : o.location.pathname) ?? "",
-      search: Object.fromEntries(
-        new URLSearchParams((o == null ? void 0 : o.location.search) ?? "").entries()
-      ),
-      hash: a === "" ? void 0 : a
-    };
-    t.set(s);
-  };
-  return o == null || o.addEventListener("popstate", e), t.onDispose(() => {
-    o == null || o.removeEventListener("popstate", e);
-  }), t.on((a) => {
-    o == null || o.history.pushState({}, "", p(a));
-  }), t;
-}, P = (t) => {
-  const o = L();
-  return n(
-    h(o.dispose),
-    i(l, o, t)
-  );
-};
-export {
-  P as ProvideBrowserLocation,
-  d as _makeLocation,
-  L as _makeLocationProp
-};

package/browser-location-D36kVbd7.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("@tempots/dom"),r=require("./index.cjs"),n=()=>{const t=a.getWindow(),o=(t==null?void 0:t.location.hash)===""?void 0:(t==null?void 0:t.location.hash.substring(1))??void 0;return{pathname:(t==null?void 0:t.location.pathname)??"",search:Object.fromEntries(new URLSearchParams((t==null?void 0:t.location.search)??"").entries()),hash:o}},c=()=>{const t=a.makeProp(n(),r.areLocationsEqual),o=a.getWindow(),s=()=>{let e=(o==null?void 0:o.location.hash)??"";e.startsWith("#")&&(e=e.substring(1));const i={pathname:(o==null?void 0:o.location.pathname)??"",search:Object.fromEntries(new URLSearchParams((o==null?void 0:o.location.search)??"").entries()),hash:e===""?void 0:e};t.set(i)};return o==null||o.addEventListener("popstate",s),t.onDispose(()=>{o==null||o.removeEventListener("popstate",s)}),t.on(e=>{o==null||o.history.pushState({},"",r.urlFromLocation(e))}),t},h=t=>{const o=c();return a.Fragment(a.OnDispose(o.dispose),a.WithProvider(r.LocationProviderMarker,o,t))};exports.ProvideBrowserLocation=h;exports._makeLocation=n;exports._makeLocationProp=c;

package/headless-location-8Va85S-Q.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("@tempots/dom"),e=require("./index.cjs"),s=t=>t.startsWith("http://")||t.startsWith("https://")||t.startsWith("//"),u=(t,a)=>{const n=t.iso(o=>e.locationFromURL(o),o=>{if(s(o.pathname))return e.urlFromLocation(o);const i=new URL(o.pathname,t.value),c=i.origin+i.pathname;return e.urlFromLocation({...o,pathname:c})});return r.Fragment(r.OnDispose(n.dispose),r.WithProvider(e.LocationProviderMarker,n,a))};exports.ProvideHeadlessLocation=u;exports.isAbsoluteURL=s;