@davidsouther/jiffies 2.2.5 → 2026.4.0

package/src/generator.test.ts

@@ -1,12 +1,13 @@
-import { takeWhile } from "./generator.js";
-import { describe, it, expect } from "./scope/index.js";
+import { takeWhile } from "./generator.ts";
+import { describe, expect, it } from "./scope/index.ts";
 
 describe("Generator", () => {
   it("takes from a generator until a predicate", () => {
     const generator = function* () {
       let i = 1;
       while (true) {
-        yield (i = i * 2);
+        i = i * 2;
+        yield i;
       }
     };
     const filter = () => {

package/src/generator.ts

@@ -1,6 +1,6 @@
 export function* takeWhile<T>(
   predicate: (t: T) => boolean,
-  iterator: Iterable<T>
+  iterator: Iterable<T>,
 ) {
   for (const x of iterator) {
     if (predicate(x)) {

package/src/hooks/_notes

@@ -1,3 +1,6 @@
 useEffect
 useState
-useContext
+useContext
+
+
+signal(n) => n, setN

package/src/index.html

@@ -23,10 +23,10 @@
         import("./components/test.js"),
       ]);
 
-      import { execute } from "./scope/execute.js";
-      import { displayStatistics } from "./scope/display/dom.js";
-      import { onConsole } from "./scope/display/console.js";
-      import { asXML } from "./scope/display/junit.js";
+      import { onConsole } from "./scope/display/console.ts";
+      import { displayStatistics } from "./scope/display/dom.ts";
+      import { asXML } from "./scope/display/junit.ts";
+      import { execute } from "./scope/execute.ts";
 
       function write(id, value) {
         const start = `--- START_${id.toUpperCase()} ---`;
@@ -46,8 +46,8 @@
       })();
     </script>
     <script type="module">
-      import { nav, ul, li, strong } from "./dom/html.js";
-      import { link } from "./dom/router/link.js";
+      import { li, nav, strong, ul } from "./dom/html.ts";
+      import { link } from "./dom/router/link.ts";
 
       const getUrls = async () => {
         const sitemap = await fetch("/sitemap.json");
@@ -65,7 +65,7 @@
       const urls = (await getUrls()).map((url) => ({
         href: url.replace("index.html", ""),
         link:
-          url.match(/\/(?<link>[^\/]+)(\/index\.html)?$/)?.groups["link"] ??
+          url.match(/\/(?<link>[^/]+)(\/index\.html)?$/)?.groups.link ??
           url.replace("index.html", ""),
       }));
 

package/src/lock.test.ts

@@ -1,10 +1,10 @@
-import { describe, it, expect } from "./scope/index.js";
-import { lock } from "./lock.js";
+import { lock } from "./lock.ts";
+import { describe, expect, it } from "./scope/index.ts";
 
 describe("Lock", () => {
-  it("prevents reentry", function () {
+  it("prevents reentry", () => {
     let count = 0;
-    const inc = lock(function () {
+    const inc = lock(() => {
       if (count > 4) {
         return;
       }

package/src/lock.ts

@@ -1,13 +1,13 @@
-const locks = new WeakSet<Function>();
+const locks = new WeakSet<CallableFunction>();
 
-export function lock(fn: Function): Function {
-  return function (...args: unknown[]) {
-    let ret = null;
+export function lock<CF extends (...args: unknown[]) => unknown>(fn: CF): CF {
+  const lockingFn = (...args: unknown[]): ReturnType<CF> => {
+    let ret: ReturnType<CF>;
     let ex = null;
     if (!locks.has(fn)) {
       locks.add(fn);
       try {
-        ret = fn(...args);
+        ret = fn(...args) as ReturnType<CF>;
       } catch (e) {
         ex = e;
       }
@@ -15,8 +15,9 @@ export function lock(fn: Function): Function {
     locks.delete(fn);
     if (ex !== null) {
       throw ex;
-    } else {
-      return ret;
     }
+    // @ts-expect-error 2454 can't track ret's assignment
+    return ret;
   };
+  return lockingFn as CF;
 }

package/src/log.ts

@@ -1,8 +1,6 @@
-import { display, Display } from "./display.js";
+import { type Display, display } from "./display.ts";
 
-export interface Log {
-  (message: Display, data?: {}): void;
-}
+export type Log = (message: Display, data?: object) => void;
 
 export interface Logger {
   logAt: (level: number, prefix: string, fn?: (logLine: string) => void) => Log;
@@ -14,9 +12,9 @@ export interface Logger {
       level: number;
       message: string;
       source: string;
-    }
+    },
   >(
-    data: D
+    data: D,
   ) => string;
   console: Console;
   default: (logLine: string) => void;
@@ -48,7 +46,8 @@ export const LEVELS: Record<string, number> = {
 
 export function getLogLevel(level = ""): number {
   return (
-    LEVELS[level.toLowerCase()] ?? (!isNaN(+level) ? Number(level) : LEVEL.INFO)
+    LEVELS[level.toLowerCase()] ??
+    (!Number.isNaN(+level) ? Number(level) : LEVEL.INFO)
   );
 }
 
@@ -80,9 +79,9 @@ type LoggerFormatFn = <
     level: number;
     message: string;
     source: string;
-  }
+  },
 >(
-  data: D
+  data: D,
 ) => string;
 
 export function getLogger(
@@ -90,7 +89,7 @@ export function getLogger(
   args: LoggerFormatFn | { format?: LoggerFormatFn; console?: Console } = {
     format: JSON.stringify,
     console,
-  }
+  },
 ): Logger {
   if (args instanceof Function) {
     args = { format: args };
@@ -102,19 +101,19 @@ export function getLogger(
     (
       level: number,
       prefix: string,
-      fn: (logLine: string) => void = defaultLog
+      fn: (logLine: string) => void = defaultLog,
     ): Log =>
-    (message: Display, data?: {}) =>
+    (message: Display, data?: object) =>
       level >= (logger.level ?? LEVEL.SILENT)
         ? fn(
-            logger.format!({
+            logger.format?.({
               name,
               prefix,
               level,
               message: display(message),
               ...data,
               source: findSource(),
-            })
+            }),
           )
         : undefined;
 
@@ -135,22 +134,22 @@ export function getLogger(
 
 export const DEFAULT_LOGGER = getLogger("default");
 
-export function debug(message: Display, data?: {}) {
+export function debug(message: Display, data?: object) {
   if (data) DEFAULT_LOGGER.debug(message, data);
   else DEFAULT_LOGGER.debug(message);
 }
 
-export function info(message: Display, data?: {}) {
+export function info(message: Display, data?: object) {
   if (data) DEFAULT_LOGGER.info(message, data);
   else DEFAULT_LOGGER.info(message);
 }
 
-export function warn(message: Display, data?: {}) {
+export function warn(message: Display, data?: object) {
   if (data) DEFAULT_LOGGER.warn(message, data);
   else DEFAULT_LOGGER.warn(message);
 }
 
-export function error(message: Display, data?: {}) {
+export function error(message: Display, data?: object) {
   if (data) DEFAULT_LOGGER.error(message, data);
   else DEFAULT_LOGGER.error(message);
 }

package/src/observable/event.ts

@@ -1,5 +1,5 @@
-import { display } from "../display.js"
-import { Observable } from "./observable.js"
+import { display } from "../display.ts";
+import type { Observable } from "./observable.ts";
 
 export interface Next<T> {
   value: T;
@@ -47,7 +47,7 @@ export const isNext = <T>(event: Event<T, unknown>): event is Next<T> =>
 export const isError = <E>(event: Event<unknown, E>): event is Error<E> =>
   event.failed && !event.completed;
 export const isCompleted = (
-  event: Event<unknown, unknown>
+  event: Event<unknown, unknown>,
 ): event is Completed => event.completed && !event.failed;
 export const isFailed = (event: Event<unknown, unknown>): event is Failed =>
   event.completed && event.failed;
@@ -64,10 +64,10 @@ const marble = <T, E>(event: Event<T, E>): string =>
   isError(event)
     ? "X"
     : isFailed(event)
-    ? "!"
-    : isCompleted(event)
-    ? "|"
-    : `(${display(event.value)})`;
+      ? "!"
+      : isCompleted(event)
+        ? "|"
+        : `(${display(event.value)})`;
 
 export const marbles = <T, E>(events: Event<T, E>[]): string =>
   `:${events.map(marble).join("-")}`;

package/src/observable/observable.test.ts

@@ -1,5 +1,5 @@
-import { describe, expect, it } from "../scope/index.js"
-import { Observable, Subject, filter, map } from "./observable.js"
+import { describe, expect, it } from "../scope/index.ts";
+import { filter, map, Observable, Subject } from "./observable.ts";
 
 describe("Observables", () => {
   describe("basics", () => {
@@ -23,7 +23,7 @@ describe("Observables", () => {
   describe("creation", () => {
     it("builds an observable of items", async () => {
       const stream = Observable.of(2, 4, 8, 16);
-      let values: number[] = [];
+      const values: number[] = [];
       await new Promise<void>((resolve) => {
         stream.subscribe({
           next: (n) => {

package/src/observable/observable.ts

@@ -1,16 +1,18 @@
-import { DEFAULT_LOGGER, Logger } from "../log.js"
+import { assertExists } from "../assert.ts";
+import type { Display } from "../display.ts";
+import { DEFAULT_LOGGER, type Logger } from "../log.ts";
 
 export interface FullSubscriber<T, E> {
   // (t: T): void | Promise<undefined>;
-  next?: (t: T) => void | Promise<undefined>;
-  error?: (e: E) => void | Promise<undefined>;
-  complete?: () => void | Promise<undefined>;
+  next?: (t: T) => void | Promise<void>;
+  error?: (e: E) => void | Promise<void>;
+  complete?: () => void | Promise<void>;
 }
 
 export type Subscriber<T, E> =
   | FullSubscriber<T, E>
   // | EventSubscriber<T, E>
-  | ((t: T) => void | Promise<undefined>);
+  | ((t: T) => void | Promise<void>);
 
 export interface Subscription {
   // (): void;
@@ -23,7 +25,7 @@ export interface Observable<T, E = unknown> {
   pipe<T1>(o1: Subscriber<T, E> & Observable<T1, E>): Observable<T1, E>;
   pipe<T1, T2>(
     o1: Subscriber<T, E> & Observable<T1, E>,
-    o2: Subscriber<T1, E> & Observable<T2, E>
+    o2: Subscriber<T1, E> & Observable<T2, E>,
   ): Observable<T2, E>;
   filter(fn: (t: T) => boolean): Observable<T, E>;
   distinct(fn?: (t1: T, t2: T) => boolean): Observable<T, E>;
@@ -45,7 +47,7 @@ export const Observable = {
         subject.complete();
         return;
       }
-      const t = ts.shift()!;
+      const t = assertExists(ts.shift());
       await subject.next(t);
       next();
     })();
@@ -53,9 +55,9 @@ export const Observable = {
   },
   combineLatest<T1, T2, E>(
     o1: Observable<T1, E>,
-    o2: Observable<T2, E>
+    o2: Observable<T2, E>,
   ): Observable<[T1, T2], E> {
-    let latestSubject = new Subject<[T1, T2], E>();
+    const latestSubject = new Subject<[T1, T2], E>();
     let o1LatestSet = false;
     let o1Latest: T1;
     let o2LatestSet = false;
@@ -77,7 +79,7 @@ export const Observable = {
       o2sub.unsubscribe();
     }
 
-    let o1sub = o1.subscribe({
+    const o1sub = o1.subscribe({
       next(t: T1) {
         o1Latest = t;
         o1LatestSet = true;
@@ -87,7 +89,7 @@ export const Observable = {
       complete,
     });
 
-    let o2sub = o2.subscribe({
+    const o2sub = o2.subscribe({
       next(t: T2) {
         o2Latest = t;
         o2LatestSet = true;
@@ -102,25 +104,31 @@ export const Observable = {
 };
 
 interface Scheduler {
-  execute(fn: () => (void | Promise<undefined>)[]): void | Promise<undefined>;
+  execute(fn: () => (void | Promise<void>)[]): void | Promise<void>;
 }
 
 export const AsyncScheduler: Scheduler = {
-  execute(fn: () => Promise<undefined>[]): Promise<undefined> {
+  execute(fn: () => Promise<void>[]): Promise<void> {
     return Promise.all(fn()).then(() => undefined);
   },
 };
 
 export const SyncScheduler: Scheduler = {
-  execute(fn: () => void[]): void {
+  execute(fn: () => undefined[]): void {
     fn();
   },
 };
 
+let DefaultScheduler = SyncScheduler;
+export function setDefaultScheduler(scheduler: Scheduler) {
+  DefaultScheduler = scheduler;
+}
+
 export class Subject<T, E = unknown, T2 = T>
   implements FullSubscriber<T, E>, Observable<T, E>
 {
-  #coldWaiters = new Set<Function>();
+  private readonly scheduler: Scheduler;
+  #coldWaiters = new Set<CallableFunction>();
   #subscribers = new Set<FullSubscriber<T, E>>();
   #complete = false;
 
@@ -136,34 +144,36 @@ export class Subject<T, E = unknown, T2 = T>
     return !this.hot;
   }
 
-  constructor(private readonly scheduler: Scheduler = AsyncScheduler) {}
+  constructor(scheduler: Scheduler = DefaultScheduler) {
+    this.scheduler = scheduler;
+  }
 
-  onWarm(fn: Function) {
+  onWarm(fn: CallableFunction) {
     if (this.cold) this.#coldWaiters.add(fn);
   }
 
-  next(t: T | T2): void | Promise<undefined> {
+  next(t: T | T2): void | Promise<void> {
     if (this.#complete)
       throw new Error("Cannot call next on a completed subject");
     return this.scheduler.execute(() =>
-      [...this.#subscribers].map((s) => s.next?.(t as T))
+      [...this.#subscribers].map((s) => s.next?.(t as T)),
     );
   }
 
-  error(e: E): void | Promise<undefined> {
+  error(e: E): void | Promise<void> {
     if (this.#complete)
       throw new Error("Cannot call error on a completed subject");
     return this.scheduler.execute(() =>
-      [...this.#subscribers].map((s) => s.error?.(e))
+      [...this.#subscribers].map((s) => s.error?.(e)),
     );
   }
 
-  complete(): void | Promise<undefined> {
+  complete(): void | Promise<void> {
     if (this.#complete)
       throw new Error("Cannot call complete on a completed subject");
     this.#complete = true;
     const finished = this.scheduler.execute(() =>
-      [...this.#subscribers].map((s) => s.complete?.())
+      [...this.#subscribers].map((s) => s.complete?.()),
     );
     this.#subscribers.clear(); // Free subscribers for garbage collection
     return finished;
@@ -179,7 +189,7 @@ export class Subject<T, E = unknown, T2 = T>
 
     this.#subscribers.add(subscriber);
 
-    [...this.#coldWaiters].forEach((w) => w());
+    for (const w of this.#coldWaiters) w();
     this.#coldWaiters.clear();
 
     return {
@@ -191,7 +201,7 @@ export class Subject<T, E = unknown, T2 = T>
   pipe<T1>(o1: Subscriber<T, E> & Observable<T1, E>): Observable<T1, E>;
   pipe<T1, T2>(
     o1: Subscriber<T, E> & Observable<T1, E>,
-    o2: Subscriber<T1, E> & Observable<T2, E>
+    o2: Subscriber<T1, E> & Observable<T2, E>,
   ): Observable<T2, E>;
   pipe(
     ...os: (Subscriber<unknown, unknown> & Observable<unknown, unknown>)[]
@@ -232,7 +242,7 @@ export class BehaviorSubject<T, E = unknown, T2 = T> extends Subject<T, E, T2> {
   #current: T;
 
   constructor(t: T, scheduler?: Scheduler) {
-    super(scheduler);
+    super(scheduler ?? AsyncScheduler);
     this.#current = t;
   }
 
@@ -255,10 +265,12 @@ export class BehaviorSubject<T, E = unknown, T2 = T> extends Subject<T, E, T2> {
 }
 
 export class ReplaySubject<T, E = unknown> extends Subject<T, E> {
+  readonly n: number;
   #history: T[] = [];
 
-  constructor(private readonly n: number, scheduler?: Scheduler) {
-    super(scheduler);
+  constructor(n: number, scheduler?: Scheduler) {
+    super(scheduler ?? SyncScheduler);
+    this.n = n;
   }
 
   next(t: T) {
@@ -275,8 +287,8 @@ export class ReplaySubject<T, E = unknown> extends Subject<T, E> {
     }
     const history = [...this.#history];
     (function send() {
-      if (history.length == 0) return;
-      const t = history.shift()!;
+      if (history.length === 0) return;
+      const t = assertExists(history.shift());
       subscriber.next?.(t);
       new Promise(send);
     })();
@@ -295,27 +307,30 @@ export function eventListener<E extends Event>() {
 }
 
 export class EventHandler<E extends Event> extends Subject<E> {
-  constructor(private readonly eventFn: (e: E) => void | Promise<undefined>) {
-    super();
+  eventFn: (e: E) => void | Promise<void>;
+
+  constructor(eventFn: (e: E) => void | Promise<void>) {
+    super(AsyncScheduler);
+    this.eventFn = eventFn;
   }
 
-  next(e: E) {
+  async next(e: E): Promise<undefined> {
     e.preventDefault();
     super.next(e);
   }
 }
 
 export const watch =
-  <T, E>(logger: Logger = DEFAULT_LOGGER) =>
+  <T extends Display, E extends Display>(logger: Logger = DEFAULT_LOGGER) =>
   (observable: Observable<T, E>) => {
     observable.tap({
-      next(t: T) {
+      async next(t: T) {
         logger.info(t);
       },
-      complete() {
+      async complete() {
         logger.info("Observable completed");
       },
-      error(e: E) {
+      async error(e: E) {
         logger.warn(e);
       },
     });
@@ -325,11 +340,13 @@ class MapOperator<T, U, E>
   extends Subject<U, E, T>
   implements FullSubscriber<T, E>, Observable<U, E>
 {
-  constructor(private readonly mapFn: (t: T) => U) {
-    super();
+  private readonly mapFn: (t: T) => U;
+  constructor(mapFn: (t: T) => U) {
+    super(SyncScheduler);
+    this.mapFn = mapFn;
   }
 
-  next(t: T): void | Promise<undefined> {
+  next(t: T): void | Promise<void> {
     return super.next(this.mapFn(t));
   }
 }
@@ -338,11 +355,13 @@ class FilterOperator<T, E>
   extends Subject<T, E>
   implements FullSubscriber<T, E>, Observable<T, E>
 {
-  constructor(private readonly filterFn: (t: T) => boolean) {
-    super();
+  private readonly filterFn: (t: T) => boolean;
+  constructor(filterFn: (t: T) => boolean) {
+    super(SyncScheduler);
+    this.filterFn = filterFn;
   }
 
-  next(t: T): void | Promise<undefined> {
+  next(t: T): void | Promise<void> {
     return this.filterFn(t) ? super.next(t) : undefined;
   }
 }
@@ -352,19 +371,19 @@ class DistinctOperator<T, E>
   implements FullSubscriber<T, E>, Observable<T, E>
 {
   #prior: T | undefined = undefined;
+  private readonly distinctFn: (t1: T, t2: T) => boolean;
 
-  constructor(
-    private readonly distinctFn: (t1: T, t2: T) => boolean = Object.is
-  ) {
-    super();
+  constructor(distinctFn: (t1: T, t2: T) => boolean = Object.is) {
+    super(SyncScheduler);
+    this.distinctFn = distinctFn;
   }
 
-  next(t: T): void | Promise<undefined> {
+  next(t: T): void | Promise<void> {
     if (this.#prior === undefined) {
       this.#prior = t;
       return super.next(t);
     }
-    const same = this.distinctFn(this.#prior!, t);
+    const same = this.distinctFn(assertExists(this.#prior), t);
     if (!same) {
       this.#prior = t;
       return super.next(t);
@@ -374,8 +393,10 @@ class DistinctOperator<T, E>
 }
 
 class ReduceOperator<A, T, E> extends BehaviorSubject<A, E, T> {
-  constructor(private readonly fn: (acc: A, t: T) => A, init: A) {
+  private readonly fn: (acc: A, t: T) => A;
+  constructor(fn: (acc: A, t: T) => A, init: A) {
     super(init);
+    this.fn = fn;
   }
 
   next(t: T) {
@@ -413,7 +434,7 @@ export class TapOperator<T, E> extends Subject<T, E> {
 }
 
 class FirstOperator<T, E> extends Subject<T, E> {
-  next(t: T): void | Promise<undefined> {
+  next(t: T): void | Promise<void> {
     const next = super.next(t);
     this.complete();
     return next;
@@ -427,7 +448,7 @@ class LastOperator<T, E = Error> extends Subject<T, E> {
     this.#latest = t;
   }
 
-  complete(): void | Promise<undefined> {
+  complete(): void | Promise<void> {
     if (this.#latest !== undefined) {
       super.next(this.#latest);
     }

package/src/result.test.ts

@@ -2,14 +2,14 @@ import {
   Err,
   None,
   Ok,
-  Result,
+  type Result,
   Some,
   unwrap,
   unwrapOr,
   unwrapOrElse,
-} from "./result.js";
-import { describe, it } from "./scope/describe.js";
-import { expect } from "./scope/expect.js";
+} from "./result.ts";
+import { describe, it } from "./scope/describe.ts";
+import { expect } from "./scope/expect.ts";
 
 describe("Result", () => {
   it("converts Nones", () => {
@@ -40,7 +40,7 @@ describe("Result", () => {
     expect(b).toMatchObject({ message: "a error" });
 
     // Assign Err to Result
-    const c: Result<string> = a;
+    const _c: Result<string> = a;
   });
 
   it("converts Oks", () => {
@@ -49,7 +49,7 @@ describe("Result", () => {
     expect(b).toBe("a ok");
 
     // Assign ok to Result
-    const c: Result<string> = a;
+    const _c: Result<string> = a;
   });
 
   it("unwraps", () => {
@@ -95,10 +95,7 @@ describe("Result", () => {
   });
 
   it("allows Result<void> with Ok()", () => {
-    let a: Result<void>;
-    a = Ok();
+    const a: Result<void> = Ok();
     expect(unwrap(a)).toBe(undefined);
   });
 });
-
-export {};