@manyducks.co/dolla 2.0.0 → 3.1.0

package/dist/core/markup.d.ts

@@ -1,82 +0,0 @@
-import type { IntrinsicElements, Renderable, View } from "../types.js";
-import { Context } from "./context.js";
-import { MarkupNode } from "./nodes/_markup.js";
-import { KeyFn, RenderFn } from "./nodes/repeat.js";
-import { type Signal } from "./signals.js";
-export { MarkupNode };
-type PropsOf<V extends string | View<any>> = V extends View<infer U> ? U : any;
-/**
- * `Markup` is a set of metadata that will be constructed into a `MarkupNode`.
- */
-export declare class Markup<Type extends string | View<any> = string | View<any>> {
-    /**
-     * In the case of a view, type will be the View function itself. It can also hold an identifier for special nodes like "$cond", "$repeat", etc.
-     * DOM nodes can be created by name, such as HTML elements like "div", "ul" or "span", SVG elements like ""
-     */
-    type: Type;
-    /**
-     * Data that will be passed to a new MarkupNode instance when it is constructed.
-     * Includes a `children` prop if children were passed.
-     */
-    props: PropsOf<Type>;
-    constructor(type: Type, props: PropsOf<Type>);
-}
-export declare enum MarkupType {
-    DOM = "$dom",
-    Dynamic = "$dynamic",
-    Portal = "$portal",
-    Repeat = "$repeat"
-}
-export interface MarkupNodeProps {
-    [MarkupType.DOM]: {
-        value: Node;
-    };
-    [MarkupType.Dynamic]: {
-        source: Signal<any>;
-    };
-    [MarkupType.Portal]: {
-        content: Renderable;
-        parent: Element;
-    };
-    [MarkupType.Repeat]: {
-        items: Signal<any[]>;
-        key: KeyFn<any>;
-        render: RenderFn<any>;
-    };
-}
-export interface MarkupCustomElementProps {
-    /**
-     * Custom element tagName pattern (must include a hyphen).
-     */
-    [tag: `${string}-${string}`]: Record<string, any>;
-}
-/**
- * Creates a `Markup` element that defines an HTML element.
- */
-export declare function createMarkup<T extends keyof IntrinsicElements>(tag: T, attrs: IntrinsicElements[T] & {
-    children?: Renderable;
-}): Markup;
-/**
- * Creates a `Markup` element that defines an HTML custom element.
- */
-export declare function createMarkup<T extends keyof MarkupCustomElementProps>(type: T, props: MarkupCustomElementProps[T]): Markup;
-/**
- * Creates a `Markup` element that defines a `MarkupNode`.
- */
-export declare function createMarkup<T extends keyof MarkupNodeProps>(type: T, props: MarkupNodeProps[T]): Markup;
-/**
- * Creates a `Markup` element that defines a view.
- */
-export declare function createMarkup<P extends {}>(type: View<P>, props?: P): Markup;
-/**
- * Creates a `Markup` element that defines a view.
- */
-export declare function createMarkup<P>(type: View<P>, props: P): Markup;
-/**
- * Takes any `Renderable` value and returns a `MarkupNode` that will display it.
- */
-export declare function render(content: Renderable, context?: Context): MarkupNode;
-/**
- * Convert basically anything into a set of `MarkupNode`s.
- */
-export declare function toMarkupNodes(context: Context, ...content: any[]): MarkupNode[];

package/dist/core/nodes/_markup.d.ts

@@ -1,36 +0,0 @@
-/**
- * A node that can be mounted by the Markup layout engine. Can be extended to create new custom node types.
- *
- * A `MarkupNode` instance can be passed anywhere a `Renderable` is required.
- */
-export declare abstract class MarkupNode {
-    /**
-     * Returns a single DOM node to represent this MarkupNode's position in the DOM.
-     * Usually the parent element, but it can be an empty Text node used as a marker.
-     *
-     * It only needs to be defined while the node is mounted, so it can be created in the `mount` function.
-     */
-    getRoot(): Node | undefined;
-    /**
-     * Returns true while this node is mounted.
-     */
-    isMounted(): boolean;
-    /**
-     * Mount this node to a `parent` element.
-     * If passed, this node will be mounted as the next sibling of `after`.
-     */
-    mount(parent: Element, after?: Node): void;
-    /**
-     * Unmount this MarkupNode from its parent element.
-     *
-     * The `skipDOM` option can be passed as an optimization when unmounting a parent node.
-     * A value of `true` indicates that no DOM operations need to happen because the parent is already being unmounted.
-     *
-     * @param skipDOM - No DOM updates will be performed when true. Lifecycle methods will be called regardless.
-     */
-    unmount(skipDOM?: boolean): void;
-    /**
-     * Moves a node without unmounting and remounting (if the browser supports Element.moveBefore).
-     */
-    move(parent: Element, after?: Node): void;
-}

package/dist/core/nodes/dynamic.d.ts

@@ -1,22 +0,0 @@
-import type { Context } from "../context.js";
-import { type Signal } from "../signals.js";
-import { MarkupNode } from "./_markup.js";
-/**
- * Renders any kind of content; markup, signals, DOM nodes, etc.
- * If it can be rendered by Dolla then Dynamic will do it.
- */
-export declare class DynamicNode extends MarkupNode {
-    private root;
-    private children;
-    private context;
-    private $slot;
-    private unsubscribe?;
-    constructor(context: Context, $slot: Signal<any>);
-    getRoot(): Text;
-    isMounted(): boolean;
-    mount(parent: Node, after?: Node): void;
-    unmount(skipDOM?: boolean): void;
-    move(parent: Element, after?: Node): void;
-    private cleanup;
-    private update;
-}

package/dist/core/nodes/element.d.ts

@@ -1,27 +0,0 @@
-import { Context } from "../context.js";
-import { MarkupNode } from "./_markup.js";
-/**
- * Renders an HTML or SVG element.
- */
-export declare class ElementNode extends MarkupNode {
-    private root;
-    private id;
-    readonly tag: string;
-    readonly props: Record<string, any>;
-    private context;
-    private childNodes;
-    private unsubscribers;
-    private ref?;
-    private canClickAway;
-    constructor(context: Context, tag: string, props: Record<string, any>);
-    getRoot(): HTMLElement | SVGElement;
-    isMounted(): boolean;
-    mount(parent: Node, after?: Node): void;
-    unmount(skipDOM?: boolean): void;
-    move(parent: Element, after?: Node): void;
-    private attachProp;
-    private getKey;
-    private applyProps;
-    private applyStyles;
-    private applyClasses;
-}

package/dist/core/nodes/portal.d.ts

@@ -1,18 +0,0 @@
-import type { Renderable } from "../../types.js";
-import { Context } from "../context.js";
-import { MarkupNode } from "./_markup.js";
-/**
- * Renders content into a specified parent node.
- */
-export declare class PortalNode extends MarkupNode {
-    private context;
-    private value;
-    private parent;
-    private node?;
-    constructor(context: Context, value: Renderable, parent: Element);
-    getRoot(): Node | undefined;
-    isMounted(): boolean;
-    mount(_parent: Element, _after?: Node): void;
-    unmount(skipDOM?: boolean): void;
-    move(_parent: Element, _after?: Node): void;
-}

package/dist/core/nodes/repeat.d.ts

@@ -1,27 +0,0 @@
-import type { Renderable } from "../../types.js";
-import type { Context } from "../context.js";
-import { type Signal } from "../signals.js";
-import { MarkupNode } from "./_markup.js";
-export type Key = any;
-export type KeyFn<T> = (item: T, index: number) => Key;
-export type RenderFn<T> = (item: Signal<T>, index: Signal<number>) => Renderable;
-/**
- * Renders a list of items.
- */
-export declare class RepeatNode<T> extends MarkupNode {
-    private root;
-    private context;
-    private items;
-    private key;
-    private render;
-    private unsubscribe;
-    private connectedItems;
-    constructor(context: Context, items: Signal<T[]>, key: KeyFn<T>, render: RenderFn<T>);
-    getRoot(): Text;
-    isMounted(): boolean;
-    mount(parent: Element, after?: Node): void;
-    unmount(skipDOM?: boolean): void;
-    move(parent: Element, after?: Node): void;
-    private _cleanup;
-    private _update;
-}

package/dist/core/nodes/view.d.ts

@@ -1,25 +0,0 @@
-import type { View } from "../../types.js";
-import { Context } from "../context.js";
-import { MarkupNode } from "./_markup.js";
-export declare const VIEW: unique symbol;
-/**
- * Renders a View.
- */
-export declare class ViewNode<P> extends MarkupNode {
-    readonly id: string;
-    readonly props: P;
-    readonly context: Context;
-    readonly view: View<P>;
-    node?: MarkupNode;
-    /**
-     * @param context - Parent contenxt to link to.
-     * @param view - View function to mount.
-     * @param props - Props to pass to view function.
-     */
-    constructor(context: Context, view: View<P>, props: P);
-    getRoot(): Node | undefined;
-    isMounted(): boolean;
-    mount(parent: Element, after?: Node): void;
-    unmount(skipDOM?: boolean): void;
-    move(parent: Element, after?: Node): void;
-}

package/dist/core/views/default-crash-view.d.ts

@@ -1,25 +0,0 @@
-/**
- * Props passed to the crash view when a crash occurs.
- */
-export interface CrashViewProps {
-    /**
-     * JavaScript Error object.
-     */
-    error: Error;
-    /**
-     * A string to identify the logger that reported this error.
-     */
-    loggerName: string;
-    /**
-     * Unique identifier to pinpoint the specific view that reported the crash.
-     */
-    tag?: string;
-    /**
-     * Label for the tag.
-     */
-    tagName?: string;
-}
-/**
- * The crash view displayed unless you specify your own.
- */
-export declare function DefaultCrashView(props: CrashViewProps): import("../markup.js").Markup<string | import("../index.js").View<any>>;

package/dist/core/views/for.d.ts

@@ -1,21 +0,0 @@
-import { type Key, RenderFn, RepeatNode } from "../nodes/repeat";
-import { type MaybeSignal } from "../signals";
-export interface ForProps<T> {
-    /**
-     * An array of items to render.
-     */
-    each: MaybeSignal<T[]>;
-    /**
-     * A function to extract a unique key that identifies each item.
-     * If no `key` function is passed, object identity (===) will be used.
-     */
-    key?: (item: T, index: number) => Key;
-    /**
-     * A render function. Takes the item and its index in signal form and returns something to display for each item.
-     */
-    children: RenderFn<T>;
-}
-/**
- *
- */
-export declare function For<T>(props: ForProps<T>): RepeatNode<T>;

package/dist/core/views/fragment.d.ts

@@ -1,7 +0,0 @@
-import type { Renderable } from "../../types.js";
-/**
- * A utility view that displays its children.
- */
-export declare function Fragment(props: {
-    children?: Renderable;
-}): Renderable;

package/dist/core/views/portal.d.ts

@@ -1,16 +0,0 @@
-import type { Renderable } from "../../types";
-import { Markup, MarkupType } from "../markup";
-export interface PortalProps {
-    /**
-     * The parent element or a selector that will match it.
-     */
-    into: Element | string;
-    /**
-     * Content to render inside the `into` element.
-     */
-    children: Renderable;
-}
-/**
- * Render content into any element on the page.
- */
-export declare function Portal(props: PortalProps): Markup<MarkupType.Portal>;

package/dist/core/views/show.d.ts

@@ -1,25 +0,0 @@
-import type { Renderable } from "../../types";
-import { DynamicNode } from "../nodes/dynamic";
-import { type MaybeSignal } from "../signals";
-export interface ShowProps {
-    /**
-     * If present, children will be rendered only when this signal holds a truthy value.
-     */
-    when?: MaybeSignal<any>;
-    /**
-     * If present, children will be rendered only when this signal holds a falsy value.
-     */
-    unless?: MaybeSignal<any>;
-    /**
-     * Content to render if conditions permit.
-     */
-    children: Renderable;
-    /**
-     * Content to render when conditions don't permit `children` to render.
-     */
-    fallback?: Renderable;
-}
-/**
- * Conditionally display children.
- */
-export declare function Show(props: ShowProps): DynamicNode;

package/dist/fragment-BahD_BJA.js

@@ -1,7 +0,0 @@
-function r(n) {
-  return n.children;
-}
-export {
-  r as F
-};
-//# sourceMappingURL=fragment-BahD_BJA.js.map

package/dist/fragment-BahD_BJA.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fragment-BahD_BJA.js","sources":["../src/core/views/fragment.ts"],"sourcesContent":["import type { Renderable } from \"../../types.js\";\n\n/**\n * A utility view that displays its children.\n */\nexport function Fragment(props: { children?: Renderable }) {\n  return props.children;\n}\n"],"names":["Fragment","props"],"mappings":"AAKO,SAASA,EAASC,GAAkC;AACzD,SAAOA,EAAM;AACf;"}

package/dist/i18n/index.d.ts

@@ -1,134 +0,0 @@
-import { type MaybeSignal, type Signal } from "../core/signals.js";
-/**
- * A JSON object of translated strings. Values can be string templates or nested objects.
- */
-interface LocalizedStrings extends Record<string, string | LocalizedStrings> {
-}
-/**
- * A formatter to be applied to a variable.
- */
-type Format = {
-    name: string;
-    options: Record<string, any>;
-};
-export interface TranslationConfig {
-    /**
-     * Name of the locale this translation is for (BCP 47 locale names recommended).
-     */
-    locale: string;
-    /**
-     * An object with translated strings for this language.
-     */
-    strings?: LocalizedStrings;
-    /**
-     * A callback function that returns a Promise that resolves to the translation object for this language.
-     */
-    fetch?: () => Promise<LocalizedStrings>;
-    /**
-     * Path to a JSON file with translated strings for this language.
-     */
-    path?: string;
-}
-export type I18nSetupOptions = {
-    /**
-     * Default locale to load on startup
-     */
-    locale?: string | null;
-    translations: TranslationConfig[];
-};
-export type TOptions = {
-    /**
-     *
-     */
-    count?: MaybeSignal<number>;
-    /**
-     *
-     */
-    context?: MaybeSignal<string>;
-    /**
-     * Override formats specified in the template with the ones in the array for each named variable.
-     *
-     * @example
-     * t("example_key", {
-     *   count: 5,
-     *   formatOverrides: {
-     *     count: [ { name: "datetime", options: { style: "currency", currency: "JPY" } } ]
-     *   }
-     * });
-     */
-    formatOverrides?: MaybeSignal<Record<string, Record<string, Format[]>>>;
-    [value: string]: MaybeSignal<any>;
-};
-export type Formatter = (locale: string, value: unknown, options: Record<string, any>) => string;
-/**
- * Dolla's I(nternationalizatio)n module. Manages language translations and locale-based formatting.
- */
-declare class I18n {
-    #private;
-    readonly $locale: Signal<string>;
-    constructor();
-    get locales(): string[];
-    setup(options: I18nSetupOptions): Promise<void>;
-    setLocale(name: string): Promise<void>;
-    /**
-     * Returns a State containing the value at `key`.
-  
-     * @param selector - Key to the translated value.
-     * @param options - A map of `{{placeholder}}` names and the values to replace them with.
-     *
-     * @example
-     * const $value = t("your.key.here", { count: 5 });
-     */
-    t(selector: string, options?: TOptions): Signal<string>;
-    /**
-     * Add a custom format callback.
-     *
-     * @example
-     * Dolla.i18n.addFormat("uppercase", (locale, value, options) => {
-     *   return value.toUpperCase();
-     * });
-     *
-     * {
-     *   "greeting": "Hello, {{name|uppercase}}!"
-     * }
-     *
-     * t("greeting", {name: "world"}); // State<"Hello, WORLD!">
-     */
-    addFormat(name: string, callback: (locale: string, value: unknown, options: Record<string, any>) => string): void;
-    /**
-     * Creates an `Intl.Collator` configured for the current locale.
-     * NOTE: The locale is tracked if called within a signal tracking context.
-     *
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator/Collator#options
-     */
-    collator(options?: Intl.CollatorOptions): Intl.Collator;
-    /**
-     * Formats a number for the current locale. Uses `Intl.NumberFormat` under the hood.
-     *
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options
-     */
-    number(count: MaybeSignal<number | bigint>, options?: Intl.NumberFormatOptions): Signal<string>;
-    /**
-     * Formats a date for the current locale. Uses `Intl.DateTimeFormat` under the hood.
-     *
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#options
-     *
-     * @example
-     * const date = new Date();
-     * const $formatted = Dolla.i18n.dateTime(date, { dateFormat: "short" });
-     */
-    dateTime(date?: MaybeSignal<string | number | Date | undefined>, options?: Intl.DateTimeFormatOptions): Signal<string>;
-    /**
-     * Formats a list for the current locale. Uses `Intl.ListFormat` under the hood.
-     *
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#options
-     *
-     * @example
-     * const list = new Date();
-     * const $formatted = Dolla.i18n.list(list, {  });
-     */
-    list(list: MaybeSignal<Iterable<string>>, options?: Intl.ListFormatOptions): Signal<string>;
-}
-export declare const i18n: I18n;
-export declare const t: (selector: string, options?: TOptions) => Signal<string>;
-export {};