@manyducks.co/dolla 2.0.0-alpha.34 → 2.0.0-alpha.36

package/notes/elimination.md

@@ -0,0 +1,33 @@
+# What can we remove?
+
+I still want to get this library with all its features down below 15kb. It's currently at 17.8kb. That said, I don't want to strip out things that are actually useful. The mission of this library is to be batteries-included, which implies some extra weight.
+
+What can be removed without compromising the basics?
+
+## Events?
+
+> 1st ELIMINATED. We're at 16.77kb now.
+
+If we have the ability to get contexts and call methods on them, isn't that just a better version of events?
+
+## Logger / Built-in Crash View
+
+> REDUCED! Removed simple-color-hash in favor of custom OKLCH hash and we're down to 15.9kb.
+
+Logger could be a different package. Crashes could be handled by a crash handler you attach.
+
+```js
+Dolla.onCrash((error) => {
+  // Do what you will with this error.
+});
+```
+
+## HTTP Client?
+
+Do we really need this? It's kind of a nice wrapper but the only thing I use the middleware for is to add auth headers for API calls, and it's trivial to write a function around `fetch` that does that. No need for the complexity of middleware.
+
+Not really. Fetch is hella basic. I just tried to write my own trivial wrapper around fetch and it took a little too much thought. I don't want to do that for every project. Adding middleware to authenticate feels trivial with `http`.
+
+## Markup?
+
+Can JSX and `html` return DOM nodes directly? Not really, because views need to be mounted and unmounted like DOM nodes but they don't have the same API. Although I could define a minimal DOM-compatible API so that DOM nodes could directly work.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manyducks.co/dolla",
-  "version": "2.0.0-alpha.34",
+  "version": "2.0.0-alpha.36",
   "description": "Front-end components, routing and state management.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
     "url": "git+https://github.com/manyducksco/dolla.git"
   },
   "scripts": {
-    "test": "npm run build && node --test",
+    "test": "vitest",
     "build:esbuild": "tsc && node build.js",
     "build": "vite build && tsc",
     "start": "tsc --watch",
@@ -39,15 +39,17 @@
       "types": "./jsx-dev-runtime.d.ts"
     }
   },
+  "dependencies": {
+    "alien-signals": "^1.0.3",
+    "fast-deep-equal": "^3.1.3",
+    "htm": "^3.1.1"
+  },
   "devDependencies": {
-    "@manyducks.co/emitter": "^1.1.2",
     "@types/node": "^22.12.0",
     "csstype": "^3.1.3",
-    "fast-deep-equal": "^3.1.3",
-    "htm": "^3.1.1",
     "prettier": "^3.4.2",
-    "simple-color-hash": "^1.0.2",
     "typescript": "^5.7.3",
-    "vite": "^6.0.11"
+    "vite": "^6.0.11",
+    "vitest": "^3.0.5"
   }
 }

package/vite.config.js

@@ -8,6 +8,9 @@ export default defineConfig({
     lib: {
       entry: {
         index: resolve(__dirname, "src/index.ts"),
+        // http: resolve(__dirname, "src/http/index.ts"),
+        // router: resolve(__dirname, "src/router/index.ts"),
+        // translate: resolve(__dirname, "src/translate/index.ts"),
         "jsx-runtime": resolve(__dirname, "src/jsx-runtime.js"),
         "jsx-dev-runtime": resolve(__dirname, "src/jsx-dev-runtime.js"),
       },

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

@@ -1,36 +0,0 @@
-import { type ElementContext } from "../context.js";
-import { type MarkupElement } from "../markup.js";
-import { type Setter, type State, type StopFunction } from "../state.js";
-import { IS_MARKUP_ELEMENT } from "../symbols.js";
-import { type ViewContext, type ViewResult } from "./view.js";
-interface RepeatOptions<T> {
-    elementContext: ElementContext;
-    $items: State<T[]>;
-    keyFn: (value: T, index: number) => string | number | symbol;
-    renderFn: ($value: State<T>, $index: State<number>, ctx: ViewContext) => ViewResult;
-}
-type ConnectedItem<T> = {
-    key: any;
-    $value: State<T>;
-    setValue: Setter<T>;
-    $index: State<number>;
-    setIndex: Setter<number>;
-    element: MarkupElement;
-};
-export declare class Repeat<T> implements MarkupElement {
-    [IS_MARKUP_ELEMENT]: boolean;
-    node: Text;
-    $items: State<T[]>;
-    stopCallback?: StopFunction;
-    connectedItems: ConnectedItem<T>[];
-    elementContext: ElementContext;
-    renderFn: (this: ViewContext, $value: State<T>, $index: State<number>, context: ViewContext) => ViewResult;
-    keyFn: (value: T, index: number) => string | number | symbol;
-    get isMounted(): boolean;
-    constructor({ elementContext, $items, renderFn, keyFn }: RepeatOptions<T>);
-    mount(parent: Node, after?: Node): void;
-    unmount(parentIsUnmounting?: boolean): void;
-    _cleanup(parentIsUnmounting: boolean): void;
-    _update(value: T[]): void;
-}
-export {};

package/dist/core/state.d.ts

@@ -1,126 +0,0 @@
-import { strictEqual } from "../utils";
-import { IS_STATE } from "./symbols";
-/**
- * Stops the observer that created it when called.
- */
-export type StopFunction = () => void;
-type Unwrapped<T> = T extends State<infer V> ? V : T;
-/**
- * Extracts value types from an array of states.
- */
-export type StateValues<T extends MaybeState<any>[]> = {
-    [K in keyof T]: Unwrapped<T[K]>;
-};
-export interface CreateStateOptions<T> {
-    /**
-     * Determines if the `next` value is equal to the `current` value.
-     * If this function returns true, watchers will be notified of changes. If it returns false, watchers will not be notified.
-     * Default equals check is `===` (strict) equality.
-     *
-     * @param next - The new value being set.
-     * @param current - The current value being replaced.
-     */
-    equals?: (next: T, current: T) => boolean;
-}
-export interface WatchOptions<T> {
-    /**
-     * If true the watch callback will be called for the first time on the next change.
-     * Callback is immediately called with the state's current value by default.
-     */
-    lazy?: boolean;
-}
-export interface State<T> {
-    /**
-     * Returns the current value.
-     */
-    get(): T;
-    /**
-     * Watch this state's value with a `callback` function.
-     * The `callback` is only called if the value is not equal to the current value.
-     *
-     * > NOTE: If watching a state inside a view, use the `.watch` method on the `ViewContext`. That method will automatically
-     * clean up all watchers when the view is disconnected. Watchers created here must be cleaned up manually.
-     */
-    watch(callback: (value: T) => void, options?: WatchOptions<T>): StopFunction;
-}
-/** A new value for a state, or a callback that receives the current value and returns a new one. */
-export type SetAction<I, O = I> = O | SetFunction<I, O>;
-export type SetFunction<I, O = I> = (current: I) => O;
-/** Callback that updates the value of a state. */
-export type Setter<I, O = I> = (value: SetAction<I, O>) => void;
-export type MaybeState<T> = State<T> | T;
-export declare function isState<T>(value: any): value is State<T>;
-/**
- * Retrieves a plain value from a variable that may be a state.
- */
-export declare function toValue<T>(source: MaybeState<T>): T;
-/**
- * Ensures a variable that may be a state or plain value is a state.
- */
-export declare function toState<T>(value: MaybeState<T>): State<T>;
-/**
- * ValueHolder implements the core functionality of a State.
- * It holds a value, which can be retrieved with `get`, updated with `set` and observed with `watch`.
- * The user-facing API splits up access into a read-only State and a setter function.
- */
-export declare class ValueHolder<T> implements State<T> {
-    value: T;
-    watchers: ((value: T) => void)[];
-    equals: typeof strictEqual;
-    constructor(value: T, options?: CreateStateOptions<T>);
-    get(): T;
-    set(action: T | SetFunction<T>): void;
-    watch(callback: (value: T) => void, options?: WatchOptions<T>): () => void;
-}
-/**
- * Signal is the implementation of a read-only State.
- */
-export declare class Signal<T> implements State<T> {
-    [IS_STATE]: boolean;
-    __value: State<T>;
-    constructor(value: State<T>);
-    get(): T;
-    watch(callback: (value: T) => void, options?: WatchOptions<T>): StopFunction;
-}
-/**
- * Creates a state and setter.
- */
-export declare function createState<T>(value: T, options?: CreateStateOptions<T>): [State<T>, Setter<T>];
-/**
- * Creates a state and setter.
- */
-export declare function createState<T>(value?: T, options?: CreateStateOptions<T | undefined>): [State<T | undefined>, Setter<T | undefined>];
-export interface DeriveOptions {
-    equals?: (next: unknown, current: unknown) => boolean;
-}
-/**
- * Derives a new `State` from one or more existing states.
- *
- * @param sources - Array of source states to track.
- * @param fn - A function called to recompute the value when any tracked source states receive a new value.
- *
- * @example
- * // With one source...
- * const [$count, setCount] = createState(5);
- * const $doubled = derive([$count], count => count * 2);
- * // ... or many:
- * const [$greeting, setGreeting] = createState("Hello");
- * const [$name, setName] = createState("World");
- * const $hello = derive([$greeting, name], (greeting, name) => `${greeting}, ${name}!`);
- */
-export declare function derive<Sources extends MaybeState<any>[], T>(sources: [...Sources], fn: (...values: StateValues<Sources>) => T | State<T>, options?: DeriveOptions): State<T>;
-export interface StateWatcher {
-    /**
-     * Watch one or more states, calling the provided `fn` each time one of their values changes.
-     *
-     * @param states - An array of states or plain values. States will be unwrapped before being passed to `fn`.
-     * @param fn - A function that takes the values of `states` in the same order they were passed.
-     */
-    watch<I extends MaybeState<any>[]>(states: [...I], fn: (...currentValues: StateValues<I>) => void): StopFunction;
-    /**
-     * Stop all watch callbacks registered to this watcher.
-     */
-    stopAll(): void;
-}
-export declare function createWatcher(): StateWatcher;
-export {};

package/dist/core/stats.d.ts

@@ -1,31 +0,0 @@
-import { Emitter } from "@manyducks.co/emitter";
-import type { Dolla } from "./dolla";
-interface StatsStore {
-    emitter: Emitter<StatsStoreEvents>;
-    stats: {
-        watcherCount: number;
-        viewCount: number;
-    };
-}
-type StatsStoreEvents = {
-    /**
-     * Emitted when any stats are updated in the store.
-     */
-    statsChanged: [];
-    _incrementWatcherCount: [amount: number];
-    _incrementViewCount: [amount: number];
-};
-/**
- * Tracks runtime statistics.
- */
-export declare class Stats {
-    #private;
-    constructor(dolla: Dolla);
-}
-export declare function _createStore(): StatsStore;
-export declare function _getStore(): StatsStore;
-export declare function _onWatcherAdded(): void;
-export declare function _onWatcherRemoved(): void;
-export declare function _onViewMounted(): void;
-export declare function _onViewUnmounted(): void;
-export {};