@manyducks.co/dolla 2.0.0-alpha.9 → 3.0.0

package/dist/jsx-dev-runtime.d.ts

@@ -1,2 +1,4 @@
-export function jsxDEV(element: any, props: any, key: any, isStaticChildren: any, source: any, self: any): import("./markup.ts").Markup;
-export { Passthrough as Fragment } from "./views/passthrough.ts";
+export function jsxDEV(element: any, props: any, key: any, isStaticChildren: any, source: any, self: any): import("./core/index.js").Markup<any>;
+export function Fragment({ children }: {
+    children: any;
+}): any;

package/dist/jsx-dev-runtime.js

@@ -1,17 +1,13 @@
-import { r as s } from "./passthrough-9kwwjgWk.js";
-import { P as m } from "./passthrough-9kwwjgWk.js";
-function d(n, r, t, e, a, l) {
-  const i = { ...o(["children", "key"], r) }, c = Array.isArray(r.children) ? r.children : [r.children];
-  return s(n, i, ...c);
+import { i as e } from "./view-cBN-hn_T.js";
+//#region src/jsx-dev-runtime.js
+var t = ({ children: e }) => e;
+function n(t, n, r, i, a, o) {
+	return e(t, r == null ? n : {
+		...n,
+		key: r
+	});
 }
-function o(n, r) {
-  const t = {};
-  for (const e in r)
-    n.includes(e) || (t[e] = r[e]);
-  return t;
-}
-export {
-  m as Fragment,
-  d as jsxDEV
-};
-//# sourceMappingURL=jsx-dev-runtime.js.map
+//#endregion
+export { t as Fragment, n as jsxDEV };
+
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx-dev-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-dev-runtime.js","sources":["../src/jsx-dev-runtime.js"],"sourcesContent":["import { createMarkup } from \"./markup.ts\";\nexport { Passthrough as Fragment } from \"./views/passthrough.ts\";\n\nexport function jsxDEV(element, props, key, isStaticChildren, source, self) {\n  const attributes = { ...omit([\"children\", \"key\"], props) };\n  const children = Array.isArray(props.children) ? props.children : [props.children];\n\n  return createMarkup(element, attributes, ...children);\n}\n\nfunction omit(keys, object) {\n  const result = {};\n  for (const key in object) {\n    if (!keys.includes(key)) {\n      result[key] = object[key];\n    }\n  }\n  return result;\n}\n"],"names":["jsxDEV","element","props","key","isStaticChildren","source","self","attributes","omit","children","createMarkup","keys","object","result"],"mappings":";;AAGO,SAASA,EAAOC,GAASC,GAAOC,GAAKC,GAAkBC,GAAQC,GAAM;AAC1E,QAAMC,IAAa,EAAE,GAAGC,EAAK,CAAC,YAAY,KAAK,GAAGN,CAAK,EAAG,GACpDO,IAAW,MAAM,QAAQP,EAAM,QAAQ,IAAIA,EAAM,WAAW,CAACA,EAAM,QAAQ;AAEjF,SAAOQ,EAAaT,GAASM,GAAY,GAAGE,CAAQ;AACtD;AAEA,SAASD,EAAKG,GAAMC,GAAQ;AAC1B,QAAMC,IAAS,CAAE;AACjB,aAAWV,KAAOS;AAChB,IAAKD,EAAK,SAASR,CAAG,MACpBU,EAAOV,CAAG,IAAIS,EAAOT,CAAG;AAG5B,SAAOU;AACT;"}
+{"version":3,"file":"jsx-dev-runtime.js","names":[],"sources":["../src/jsx-dev-runtime.js"],"sourcesContent":["import { createMarkup } from \"./core/markup/utils.js\";\n\nexport const Fragment = ({ children }) => children;\n\nexport function jsxDEV(element, props, key, isStaticChildren, source, self) {\n  // TODO: Take additional dev arguments and use them for better debugging.\n  return createMarkup(element, key != null ? { ...props, key } : props);\n}\n"],"mappings":";;AAEA,IAAa,KAAY,EAAE,kBAAe;AAE1C,SAAgB,EAAO,GAAS,GAAO,GAAK,GAAkB,GAAQ,GAAM;AAE1E,QAAO,EAAa,GAAS,KAAO,OAA2B,IAApB;EAAE,GAAG;EAAO;EAAK,CAAS"}

package/dist/jsx-runtime.d.ts

@@ -1,9 +1,11 @@
 /**
  * JSX function for elements with dynamic children.
  */
-export function jsx(element: any, props: any, key: any): import("./markup.ts").Markup;
+export function jsx(element: any, props: any, key: any): import("./core/index.js").Markup<any>;
 /**
  * JSX function for elements with static children.
  */
-export function jsxs(element: any, props: any, key: any): import("./markup.ts").Markup;
-export { Passthrough as Fragment } from "./views/passthrough.ts";
+export function jsxs(element: any, props: any, key: any): import("./core/index.js").Markup<any>;
+export function Fragment({ children }: {
+    children: any;
+}): any;

package/dist/jsx-runtime.js

@@ -1,20 +1,19 @@
-import { r as t } from "./passthrough-9kwwjgWk.js";
-import { P as l } from "./passthrough-9kwwjgWk.js";
-function d(n, e, r) {
-  return t(n, e ? { ...u(["children", "key"], e) } : void 0, e.children);
+import { i as e } from "./view-cBN-hn_T.js";
+//#region src/jsx-runtime.js
+var t = ({ children: e }) => e;
+function n(t, n, r) {
+	return e(t, r == null ? n : {
+		...n,
+		key: r
+	});
 }
-function f(n, e, r) {
-  return t(n, e ? { ...u(["children", "key"], e) } : void 0, e.children);
+function r(t, n, r) {
+	return e(t, r == null ? n : {
+		...n,
+		key: r
+	});
 }
-function u(n, e) {
-  const r = {};
-  for (const i in e)
-    n.includes(i) || (r[i] = e[i]);
-  return r;
-}
-export {
-  l as Fragment,
-  d as jsx,
-  f as jsxs
-};
-//# sourceMappingURL=jsx-runtime.js.map
+//#endregion
+export { t as Fragment, n as jsx, r as jsxs };
+
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-runtime.js","sources":["../src/jsx-runtime.js"],"sourcesContent":["import { createMarkup } from \"./markup.ts\";\nexport { Passthrough as Fragment } from \"./views/passthrough.ts\";\n\n/**\n * JSX function for elements with dynamic children.\n */\nexport function jsx(element, props, key) {\n  return createMarkup(element, props ? { ...omit([\"children\", \"key\"], props) } : undefined, ...[props.children]);\n}\n\n/**\n * JSX function for elements with static children.\n */\nexport function jsxs(element, props, key) {\n  return createMarkup(element, props ? { ...omit([\"children\", \"key\"], props) } : undefined, props.children);\n}\n\nfunction omit(keys, object) {\n  const result = {};\n  for (const key in object) {\n    if (!keys.includes(key)) {\n      result[key] = object[key];\n    }\n  }\n  return result;\n}\n"],"names":["jsx","element","props","key","createMarkup","omit","jsxs","keys","object","result"],"mappings":";;AAMO,SAASA,EAAIC,GAASC,GAAOC,GAAK;AACvC,SAAOC,EAAaH,GAASC,IAAQ,EAAE,GAAGG,EAAK,CAAC,YAAY,KAAK,GAAGH,CAAK,EAAC,IAAK,QAAeA,EAAM,QAAS;AAC/G;AAKO,SAASI,EAAKL,GAASC,GAAOC,GAAK;AACxC,SAAOC,EAAaH,GAASC,IAAQ,EAAE,GAAGG,EAAK,CAAC,YAAY,KAAK,GAAGH,CAAK,EAAC,IAAK,QAAWA,EAAM,QAAQ;AAC1G;AAEA,SAASG,EAAKE,GAAMC,GAAQ;AAC1B,QAAMC,IAAS,CAAE;AACjB,aAAWN,KAAOK;AAChB,IAAKD,EAAK,SAASJ,CAAG,MACpBM,EAAON,CAAG,IAAIK,EAAOL,CAAG;AAG5B,SAAOM;AACT;"}
+{"version":3,"file":"jsx-runtime.js","names":[],"sources":["../src/jsx-runtime.js"],"sourcesContent":["import { createMarkup } from \"./core/markup/utils.js\";\n\nexport const Fragment = ({ children }) => children;\n\n/**\n * JSX function for elements with dynamic children.\n */\nexport function jsx(element, props, key) {\n  return createMarkup(element, key != null ? { ...props, key } : props);\n}\n\n/**\n * JSX function for elements with static children.\n */\nexport function jsxs(element, props, key) {\n  return createMarkup(element, key != null ? { ...props, key } : props);\n}\n"],"mappings":";;AAEA,IAAa,KAAY,EAAE,kBAAe;AAK1C,SAAgB,EAAI,GAAS,GAAO,GAAK;AACvC,QAAO,EAAa,GAAS,KAAO,OAA2B,IAApB;EAAE,GAAG;EAAO;EAAK,CAAS;;AAMvE,SAAgB,EAAK,GAAS,GAAO,GAAK;AACxC,QAAO,EAAa,GAAS,KAAO,OAA2B,IAApB;EAAE,GAAG;EAAO;EAAK,CAAS"}

package/dist/router/index.d.ts

@@ -0,0 +1,4 @@
+import { Context } from "../core";
+export { createRouterPlugin, lazy, Outlet, RedirectError } from "./router";
+export type { RouterOptions } from "./types";
+export declare function getRouter(context: Context): import("./types").Router;

package/dist/router/matcher.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/router/router.d.ts

@@ -0,0 +1,23 @@
+import { Context } from "../core/context.js";
+import { DollaPlugin } from "../core/index.js";
+import { DynamicNode } from "../core/markup/nodes/dynamic.js";
+import type { LazyLoader, LazyView, RouterOptions } from "./types.js";
+/**
+ * Lazy loads a view when its route is first matched.
+ *
+ * @example
+ * {
+ * path: "/users",
+ * view: lazy(() => import("./views/users.js"))
+ * }
+ */
+export declare function lazy(load: LazyLoader): LazyView;
+export declare function createRouterPlugin(options: RouterOptions): DollaPlugin;
+/**
+ * Displays the router's content.
+ */
+export declare function Outlet(this: Context): DynamicNode;
+export declare class RedirectError extends Error {
+    redirectPath: string;
+    constructor(redirectPath: string);
+}

package/dist/router/router.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/router/store.d.ts

@@ -0,0 +1,12 @@
+import { type Context, type Getter, type Setter } from "../core";
+import type { Router } from "./types";
+import { type HistoryAdapter, type Match } from "./utils";
+export interface RouterStoreProps {
+    currentMatch: Getter<Match>;
+    setCurrentMatch: Setter<Match>;
+    progress: Getter<number>;
+    history: HistoryAdapter;
+    updateRoute: () => void;
+    guards: Set<() => boolean | Promise<boolean>>;
+}
+export declare function RouterStore(this: Context, { currentMatch, setCurrentMatch, progress, history, updateRoute, guards }: RouterStoreProps): Router;

package/dist/router/types.d.ts

@@ -0,0 +1,152 @@
+import type { Setter, Getter, MarkupNode, Renderable, View } from "../core";
+import type { Context } from "../core/context";
+import type { Match } from "./utils";
+export type Stringable = {
+    toString(): string;
+};
+export type LazyLoader<Props = any> = () => Promise<{
+    default: View<Props>;
+} | View<Props>>;
+export interface LazyView<Props = any> {
+    _lazy: true;
+    load: LazyLoader<Props>;
+}
+export interface Route<Data = any> {
+    /**
+     * The path or path fragment to match.
+     */
+    path: string;
+    /**
+     * Path to redirect to when this route is matched, or a callback function that returns such path.
+     */
+    redirect?: string | ((match: Match) => string) | ((match: Match) => Promise<string>);
+    preload?: (match: Match) => Data | Promise<Data>;
+    /**
+     * View to display when this route is matched.
+     */
+    view?: View<{
+        data?: Data;
+        children: Renderable;
+    }> | LazyView<{
+        data?: Data;
+        children: Renderable;
+    }>;
+    errorView?: View<{
+        error: Error;
+    }>;
+    /**
+     * Subroutes.
+     */
+    routes?: Route[];
+    /**
+     * Arbitrary data you'd like to store on this route.
+     * This object is accessible via `match.meta` on the `$router` API while the route is active.
+     *
+     * In the case of nested routes, data from all layers will be merged into a single data object.
+     */
+    meta?: Record<string | symbol, any>;
+}
+export interface RouteLayer {
+    id: string;
+    pattern: string;
+    view: View<any> | LazyView<any>;
+    errorView?: View<{
+        error: Error;
+    }>;
+    preload?: (match: Match) => any | Promise<any>;
+}
+/**
+ * An active route layer whose markup has been initialized into a view.
+ */
+export interface ActiveLayer {
+    id: string;
+    key: string;
+    node: MarkupNode;
+    context: Context;
+    slot: Getter<MarkupNode | undefined>;
+    setSlot: Setter<MarkupNode | undefined>;
+}
+/**
+ * A log for a single step in the route resolution process.
+ */
+export interface JourneyStep {
+    kind: "match" | "redirect" | "miss";
+    message: string;
+}
+export interface NavigateOptions {
+    /**
+     * Preserve existing query params (if any) when navigating. Defaults to false.
+     * If true, all existing query params are preserved and merged with new ones.
+     * If an array of strings is passed only those keys will be preserved, then merged with any new ones.
+     */
+    preserveQuery?: boolean | string[];
+}
+export interface RouterOptions {
+    routes: Route[];
+    /**
+     * When true, the router will construct routes like "https://www.example.com/#/sub/route" which work without any backend intervention.
+     */
+    hash?: boolean;
+    /**
+     * Persist query params between pages when navigating. Pass an array to specify a list of params that will be preserved.
+     * By default all query params are cleared when navigating to a new URL (equivalent to `false`).
+     */
+    preserveQuery?: boolean | string[];
+}
+export interface Router {
+    /**
+     * The current path as it is displayed in the URL bar (e.g. `/users/123/edit`).
+     */
+    path: Getter<string>;
+    /**
+     * The route pattern that was matched (e.g. `/users/{#id}/edit`), or undefined if no route is currently matched.
+     */
+    pattern: Getter<string | undefined>;
+    /**
+     * The extracted route parameters from the path. (e.g. `{ id: "123" }`)
+     */
+    params: Getter<Record<string, string>>;
+    /**
+     * The current query params.
+     */
+    query: Getter<Record<string, string>>;
+    /**
+     * The contents of the `meta` fields of all matched route layers.
+     */
+    meta: Getter<Record<string, string>>;
+    /**
+     * Represents the loading progress of the current navigation from 0 to 1.
+     * Returns 0 when no navigation is pending.
+     */
+    progress: Getter<number>;
+    /**
+     * Update query params without changing the route.
+     */
+    setQuery(params: Record<string, Stringable>): Record<string, string>;
+    /**
+     * Go back in the page history. Equivalent to hitting the back button.
+     * Steps is the number of times to hit the back button. The default is 1.
+     */
+    back(steps?: number): void;
+    /**
+     * Go forward in the page history. Equivalent to hitting the forward button.
+     * Steps is the number of times to hit the forward button. The default is 1.
+     */
+    forward(steps?: number): void;
+    /**
+     * Push a new route into the page history and navigate to it.
+     */
+    push(path: string): void;
+    /**
+     * Replace the current route in the page history and navigate to it.
+     */
+    replace(path: string): void;
+    /**
+     * Prevents attempted navigations if the condition returns true.
+     */
+    block(guard: () => boolean | Promise<boolean>): () => void;
+    /**
+     * Contains `true` when the current route matches `path`.
+     */
+    isActive(path: string, exact?: boolean): Getter<boolean>;
+}

package/dist/router/utils.d.ts

@@ -0,0 +1,99 @@
+import type { JourneyStep, Route, RouteLayer, Stringable } from "./types.js";
+export interface Match {
+    /**
+     * The path string that triggered this match.
+     */
+    path: string;
+    /**
+     * The pattern satisfied by `path`.
+     */
+    pattern: string;
+    /**
+     * Named params as parsed from `path`.
+     */
+    params: Record<string, string>;
+    /**
+     * Query params as parsed from `path`.
+     */
+    query: Record<string, string>;
+    /**
+     * Freeform data you wish to store with this route.
+     * Merged `data` from all matched layers are available on the router's `match.meta`.
+     */
+    meta: Record<any, any>;
+}
+export interface RouteMatch extends Match {
+    layers: RouteLayer[];
+    redirect?: string | ((match: Match) => string) | ((match: Match) => Promise<string>);
+}
+export type RoutePayload = {
+    pattern: string;
+    meta: Record<any, any>;
+    layers?: RouteLayer[];
+    redirect?: string | ((match: Match) => string) | ((match: Match) => Promise<string>);
+};
+export type RouteMatchOptions = {
+    willMatch?: (route: RoutePayload) => boolean;
+};
+/**
+ * Separates a URL path into multiple fragments.
+ *
+ * @param path - A path string (e.g. `"/api/users/5"`)
+ * @returns an array of fragments (e.g. `["api", "users", "5"]`)
+ */
+export declare function splitPath(path: string): string[];
+/**
+ * Joins multiple URL path fragments into a single string.
+ *
+ * @param parts - One or more URL fragments (e.g. `["api", "users", 5]`)
+ * @returns a joined path (e.g. `"api/users/5"`)
+ */
+export declare function joinPath(parts: {
+    toString(): string;
+}[]): string;
+export declare function resolvePath(base: string, part?: string | null): string;
+export declare function parseQueryParams(query: string): Record<string, string>;
+export declare function mergeQueryParams(previous: Record<string, string>, current: Record<string, Stringable>, preserve?: boolean | string[]): URLSearchParams;
+export declare class RouteNode {
+    staticChildren: Map<string, RouteNode>;
+    numericChild: RouteNode | null;
+    paramChild: RouteNode | null;
+    wildcardChild: RouteNode | null;
+    route?: RoutePayload;
+    paramName?: string;
+    numericName?: string;
+}
+export declare function buildRouteTree(routes: Route[]): RouteNode;
+export declare function matchRoute(rootNode: RouteNode, url: string, options?: RouteMatchOptions): RouteMatch | undefined;
+export interface ResolvedRoute {
+    match?: RouteMatch;
+    journey: JourneyStep[];
+}
+/**
+ * Takes a URL and finds a match, following redirects.
+ */
+export declare function resolveRoute(rootNode: RouteNode, path: string, journey?: JourneyStep[]): Promise<ResolvedRoute>;
+/**
+ * Intercepts links within the root node.
+ *
+ * This is adapted from https://github.com/choojs/nanohref/blob/master/index.js
+ *
+ * @param root - Element under which to intercept link clicks
+ * @param callback - Function to call when a click event is intercepted
+ * @param _window - (optional) Override for global window object
+ */
+export declare function catchLinks(root: Element, callback: (href: string, anchor: HTMLAnchorElement) => void, _window?: Window & typeof globalThis): () => void;
+export declare function expandOptionalPaths(path: string): string[];
+/**
+ * Replace route pattern param placeholders with real matched values.
+ */
+export declare function replaceParams(path: string, params: Record<string, string | number>): string;
+export interface HistoryAdapter {
+    getPath(): string;
+    getSearch(): string;
+    getKey(): string;
+    getIndex(): number;
+    push(url: string): void;
+    replace(url: string): void;
+}
+export declare function createHistoryAdapter(useHash: boolean): HistoryAdapter;

package/dist/router/utils.test.d.ts

@@ -0,0 +1 @@
+export {};