@davidsouther/jiffies 2.3.0 → 2026.4.1

package/package.json

@@ -1,20 +1,23 @@
 {
   "name": "@davidsouther/jiffies",
-  "version": "2.3.0",
+  "version": "2026.4.1",
   "private": false,
   "displayName": "JEFRi Jiffies",
   "type": "module",
-  "main": "./lib/cjs/",
-  "module": "./lib/esm/",
-  "types": "./lib/esm/index.d.ts",
-  "directories": {
-    "lib": "./lib/cjs"
+  "exports": {
+    "./*.ts": "./src/*.ts"
   },
+  "files": [
+    "src",
+    "LICENSE",
+    "package.json",
+    "README.md",
+    "tsconfig.json"
+  ],
   "engines": {
-    "node": ">=20.0.9"
+    "node": ">=22.18.0"
   },
   "scripts": {
-    "node": "node --import ./src/loader-register.mjs",
     "start": "node ./src/server/main.ts",
     "test": "node ./src/test.mjs",
     "ci": "npm run node ./src/test.mjs --mode=junit",
@@ -22,22 +25,16 @@
     "fix": "biome check --write --unsafe",
     "check:format": "biome format",
     "check:lint": "biome check",
-    "build": "npm run build:esm & npm run build:cjs & npm run build:css",
-    "postbuild": "npm run fixup",
-    "build:esm": "tsc",
-    "build:cjs": "tsc --module commonjs --outDir lib/cjs",
-    "fixup:cjs": "echo '{\"module\":\"commonjs\"}' > lib/cjs/package.json",
-    "fixup": "npm run fixup:cjs",
-    "build:css": "sass ./src/pico/pico.scss ./build/pico.css",
-    "watch": "npx tsc --watch",
-    "all": "npm run check:lint && npm run test && npm run build"
+    "all": "npm run check:lint && npm run test"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.10",
+    "@biomejs/biome": "^2.3.11",
+    "@types/jsdom": "^27.0.0",
     "@types/node": "^20.8.9"
   },
   "dependencies": {
-    "ts-blank-space": "^0.6.2",
+    "jsdom": "^27.4.0",
+    "ts-blank-space": "^0.7.0",
     "typescript": "^5.9.3"
   }
-}
+}

package/src/dom/README.md

@@ -35,7 +35,7 @@ export const Input(name, type="string") => {
     )
 }
 
-document.body.append(
+window.document.body.append(
     Form(
         {
             title: "Details",

package/src/dom/dom.ts

@@ -1,6 +1,13 @@
 import { assertExists } from "../assert.ts";
 import type { Properties as SVGProperties } from "./types/css.ts";
 
+if (typeof window === "undefined") {
+  const { JSDOM } = await import("jsdom");
+  // biome-ignore lint/suspicious/noGlobalAssign: Load JSDom globally
+  window = global.window = new JSDOM().window as unknown as Window &
+    typeof globalThis;
+}
+
 export const XHTML_NAMESPACE_URI = "http://www.w3.org/1999/xhtml";
 export const SVG_NAMESPACE_URI = "http://www.w3.org/2000/svg";
 
@@ -22,7 +29,9 @@ export type DomAttrs = {
 };
 
 export type Attrs<E extends Omit<Element, "update">, S = object> = Partial<
-  Omit<{ [k in keyof E]: string | number | boolean }, "style"> & S & DomAttrs
+  Omit<{ [k in keyof E]: string | number | boolean }, "style" | "toString"> &
+    S &
+    DomAttrs
 >;
 
 export type DenormAttrs<E extends Omit<Element, "update">, S = object> =

package/src/dom/fc.ts

@@ -68,7 +68,10 @@ export function FC<Props extends object, State extends object = object>(
     attrs?: Attrs<Props> | DenormChildren,
     ...children: DenormChildren[]
   ): FCComponent<Props, State> => {
-    const element = document.createElement(name) as FCComponent<Props, State>;
+    const element = window.document.createElement(name) as FCComponent<
+      Props,
+      State
+    >;
     element.update(attrs, ...children);
     return element;
   };

package/src/dom/form/form.ts

@@ -61,10 +61,7 @@ const prepareOptions = (
           : { value, ...label },
       );
 export const Option = (attrs: OptionAttributes) =>
-  option(
-    // @ts-expect-error
-    attrs as Attrs<HTMLOptionElement>,
-  );
+  option(attrs as Attrs<HTMLOptionElement>);
 
 export const Dropdown = (
   attrs: SelectAttributes | { selected?: string },

package/src/dom/html.ts

@@ -7,7 +7,7 @@ const makeHTMLElement =
     ...children: DenormChildren[]
   ) =>
     up(
-      document.createElement(name),
+      window.document.createElement(name),
       attrs,
       ...children,
     ) as HTMLElementTagNameMap[K];

package/src/dom/index.ts

@@ -0,0 +1,2 @@
+export * as fc from "./fc.ts";
+export * as html from "./html.ts";

package/src/dom/router/router.ts

@@ -7,7 +7,7 @@ export interface Router {
   (target: DOMElement): DOMElement;
 }
 
-const baseURI = `${document.baseURI}`;
+const baseURI = `${window.document.baseURI}`;
 const normalizeHref = () => {
   return `${location.href}/` === baseURI ? baseURI : location.href;
 };

package/src/observable/observable.ts

@@ -307,6 +307,8 @@ export function eventListener<E extends Event>() {
 }
 
 export class EventHandler<E extends Event> extends Subject<E> {
+  eventFn: (e: E) => void | Promise<void>;
+
   constructor(eventFn: (e: E) => void | Promise<void>) {
     super(AsyncScheduler);
     this.eventFn = eventFn;

package/src/scope/fix.ts

@@ -3,7 +3,6 @@
  */
 export function fix<T>(n: T): T {
   if (typeof n === "number") {
-    // @ts-expect-error
     return +n.toFixed(1) as T;
   }
   if (n !== Object(n)) {
@@ -11,7 +10,6 @@ export function fix<T>(n: T): T {
     return n;
   }
   if (Array.isArray(n)) {
-    // @ts-expect-error
     return n.map(fix) as T;
   }
   // @ts-expect-error

package/src/transpile.mjs

@@ -1,4 +1,3 @@
-// @ts-expect-error
 import tsBlankSpace from "ts-blank-space";
 
 const tsmap = new Map();

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    // Assume browser environment & esm
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "emitDeclarationOnly": true,
+    "allowJs": true,
+    "checkJs": true,
+    "jsx": "react",
+
+    // Checks and strictness
+    "strict": true,
+    "allowUnreachableCode": false,
+    "allowUnusedLabels": false,
+    // "exactOptionalPropertyTypes": true,
+    "noFallthroughCasesInSwitch": true,
+    // "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    // "noPropertyAccessFromIndexSignature": true,
+    // "noUncheckedIndexedAccess": true,
+    // "noUnusedLocals": true,
+    "skipLibCheck": true,
+    "exactOptionalPropertyTypes": true,
+    "erasableSyntaxOnly": true,
+    "allowImportingTsExtensions": true,
+
+    "incremental": true,
+    "outDir": "lib/esm",
+    "declaration": true
+  },
+  "include": ["src"]
+}

package/lib/cjs/assert.d.ts

@@ -1,26 +0,0 @@
-type AssertMessage = string | (() => string);
-export declare class AssertionError extends Error {
-    constructor(message?: string);
-}
-/**
- * Throw an error when a condition is not met.
- */
-export declare function assert<_T extends true>(condition: boolean, message?: AssertMessage): undefined | never;
-/**
- * Given a value, return it if it is not null nor undefined. Otherwise throw an
- * error.
- *
- * @template T
- * @returns {NonNullable<T>}
- */
-export declare function assertExists<T>(t: T, message?: AssertMessage): NonNullable<T>;
-/**
- * @param {*} n
- * @returns string
- */
-export declare function assertString(n: unknown, message?: AssertMessage): string;
-/**
- * Compile time assertion that no value will used at this point in control flow.
- */
-export declare function checkExhaustive(value: never, message?: AssertMessage): never;
-export {};

package/lib/cjs/awaitable.d.ts

@@ -1 +0,0 @@
-export type Awaitable<T> = T | PromiseLike<T>;

package/lib/cjs/case.d.ts

@@ -1 +0,0 @@
-export declare function dashCase(identifier: string): string;

package/lib/cjs/components/button_bar.d.ts

@@ -1,8 +0,0 @@
-declare const ButtonBar: import("../dom/fc.ts").FCComponentCtor<{
-    value: T;
-    values: T[];
-    events: {
-        onSelect: (current: T) => void;
-    };
-}, object>;
-export default ButtonBar;

package/lib/cjs/components/inline_edit.d.ts

@@ -1,12 +0,0 @@
-export interface InlineEditState {
-    mode: number;
-    value: string;
-}
-export declare const InlineEdit: import("../dom/fc.ts").FCComponentCtor<{
-    mode?: number;
-    value: string;
-    events: {
-        change: (value: string) => void;
-    };
-}, InlineEditState>;
-export default InlineEdit;

package/lib/cjs/components/logger.d.ts

@@ -1,6 +0,0 @@
-import { type Logger } from "../log.ts";
-export interface HTMLLogger extends Logger {
-    root: Element;
-}
-export declare function isHTMLLogger(logger: Logger): logger is HTMLLogger;
-export declare function makeHTMLLogger(name: string): HTMLLogger;

package/lib/cjs/components/select.d.ts

@@ -1,10 +0,0 @@
-import type { EventHandler } from "../dom/dom.ts";
-export declare const Select: import("../dom/fc.ts").FCComponentCtor<{
-    name: string;
-    value: string;
-    events: {
-        change: EventHandler;
-    };
-    disabled: boolean;
-    options: [string, string][];
-}, object>;

package/lib/cjs/components/test.d.ts

@@ -1 +0,0 @@
-export declare function loadTests(): Promise<void>;

package/lib/cjs/components/virtual_scroll.d.ts

@@ -1,42 +0,0 @@
-export interface VirtualScrollSettings {
-    minIndex: number;
-    maxIndex: number;
-    startIndex: number;
-    itemHeight: number;
-    count: number;
-    tolerance: number;
-}
-export type VirtualScrollDataAdapter<T> = (offset: number, limit: number) => Iterable<T>;
-export declare function arrayAdapter<T>(data: T[]): VirtualScrollDataAdapter<T>;
-export interface VirtualScrollProps<T, U extends HTMLElement> {
-    settings: Partial<VirtualScrollSettings>;
-    get: VirtualScrollDataAdapter<T>;
-    row: (t: T) => U;
-}
-export declare function fillVirtualScrollSettings(settings: Partial<VirtualScrollSettings>): VirtualScrollSettings;
-export declare function initialState<T>(settings: VirtualScrollSettings): VirtualScrollState<T>;
-export declare function getData<T>(minIndex: number, maxIndex: number, offset: number, limit: number, get: VirtualScrollDataAdapter<T>): T[];
-export declare function doScroll<T>(scrollTop: number, state: VirtualScrollState<T>, get: VirtualScrollDataAdapter<T>): {
-    scrollTop: number;
-    topPaddingHeight: number;
-    bottomPaddingHeight: number;
-    data: T[];
-};
-interface VirtualScrollState<T, U extends HTMLElement = HTMLElement> {
-    settings: VirtualScrollSettings;
-    scrollTop: number;
-    bufferedItems: number;
-    totalHeight: number;
-    viewportHeight: number;
-    topPaddingHeight: number;
-    bottomPaddingHeight: number;
-    toleranceHeight: number;
-    data: T[];
-    rows: U[];
-}
-export interface VirtualScroll<T, U extends HTMLElement> {
-    state: VirtualScrollState<T>;
-    rows: U[];
-}
-export declare const VirtualScroll: import("../dom/fc.ts").FCComponentCtor<VirtualScrollProps<unknown, HTMLElement>, VirtualScrollState<unknown, HTMLElement>>;
-export default VirtualScroll;

package/lib/cjs/components/virtual_scroll.test.d.ts

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

package/lib/cjs/context.d.ts

@@ -1,11 +0,0 @@
-import { Err, type Result } from "./result.ts";
-export declare const Enter: unique symbol;
-export declare const Exit: unique symbol;
-export interface Context {
-    [Enter]: () => void;
-    [Exit]: () => void;
-}
-export type Operation<T, E extends Error, C extends Context> = (c: C) => T | Result<T, E>;
-export type AsyncOperation<T, E extends Error, C extends Context> = (c: C) => Promise<T | Result<T, E>>;
-export declare function using<T, E extends Error, C extends Context>(context: C | (() => C) | Operation<T, E, C>, operation?: Operation<T, E, C>, normalizeError?: (e: Error | unknown) => Err<E>): Result<T, E>;
-export declare function asyncUsing<T, E extends Error, C extends Context>(context: C | (() => Promise<C>), operation: AsyncOperation<T, E, C>, normalizeError?: (e: E) => Err<E>): Promise<Result<T, E>>;

package/lib/cjs/context.test.d.ts

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

package/lib/cjs/debounce.d.ts

@@ -1 +0,0 @@
-export declare function debounce<T extends unknown[]>(fn: (...args: T) => void, ms?: number): (...args: T) => void;

package/lib/cjs/diff.d.ts

@@ -1,15 +0,0 @@
-export declare const DiffA: unique symbol;
-export declare const DiffB: unique symbol;
-export type DiffIndex = string | number;
-export type DiffPrimitive = string | number | boolean | null | undefined;
-interface DiffEntry {
-    key: DiffIndex;
-    left: DiffPrimitive;
-    right: DiffPrimitive;
-}
-interface DiffList {
-    key: DiffIndex;
-    children: (DiffEntry | DiffList)[];
-}
-export declare function diff<T>(a: Partial<T>, b: Partial<T>): (DiffEntry | DiffList)[];
-export {};

package/lib/cjs/diff.test.d.ts

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

package/lib/cjs/display.d.ts

@@ -1,5 +0,0 @@
-export type Display = string | {
-    toString(): string;
-};
-export declare const isDisplay: (a: unknown) => a is Display;
-export declare const display: (a: unknown | Display) => string;

package/lib/cjs/dom/css/border.d.ts

@@ -1,11 +0,0 @@
-import type { Properties } from "../types/css.ts";
-import type { Side, Size } from "./constants.ts";
-export declare function rounded(size?: Size, side?: Side): Properties<0 | (string & {}), string & {}>;
-export declare function border({ side, style, radius, width, color, }: {
-    side?: Side;
-    style?: "solid" | "dotted" | "dashed" | "double" | "none";
-    radius?: Size;
-    width?: 0 | 1 | 2 | 4 | 8;
-    color?: string;
-}): {};
-export declare function inset(width: 0 | 1 | 2 | 4 | 8, color1?: string, color2?: string): {};

package/lib/cjs/dom/css/constants.d.ts

@@ -1,31 +0,0 @@
-export declare const Sizes: {
-    none: string;
-    sm: string;
-    "": string;
-    md: string;
-    lg: string;
-    xl: string;
-    "2xl": string;
-    "3xl": string;
-    full: string;
-};
-export declare const Sides: {
-    "": string;
-    t: string;
-    r: string;
-    l: string;
-    b: string;
-    tl: string;
-    tr: string;
-    bl: string;
-    br: string;
-};
-export declare const Widths: {
-    "1/4": string;
-    "1/2": string;
-    "3/4": string;
-    full: string;
-};
-export type Size = keyof typeof Sizes;
-export type Side = keyof typeof Sides;
-export type Width = keyof typeof Widths;

package/lib/cjs/dom/css/core.d.ts

@@ -1,5 +0,0 @@
-import { type Side, type Size, Sizes } from "./constants.ts";
-export declare function isSide(v: string): v is Side;
-export declare function isSize(v: string): v is Size;
-export declare function getSize(size: keyof typeof Sizes): string;
-export declare function getSide(side: Side): string[];

package/lib/cjs/dom/css/fstyle.d.ts

@@ -1,5 +0,0 @@
-import type { Properties } from "../types/css.ts";
-export type FStyle = Properties | {
-    [k: string]: FStyle;
-};
-export declare function compileFStyle(fstyle: FStyle, prefix?: string): string;

package/lib/cjs/dom/css/sizing.d.ts

@@ -1,5 +0,0 @@
-import { type Width } from "./constants.ts";
-export declare function width(amount: Width, block?: "inline"): {
-    width: string;
-    display?: string;
-};

package/lib/cjs/dom/dom.d.ts

@@ -1,27 +0,0 @@
-import type { Properties } from "./types/css.ts";
-declare const Events: unique symbol;
-export declare const CLEAR: unique symbol;
-export type EventHandler = EventListenerOrEventListenerObject;
-export type DenormChildren = Node | string | typeof CLEAR;
-export type DOMElement = Element & ElementCSSInlineStyle;
-export type DomAttrs = {
-    class: string | string[];
-    style: Partial<Properties> | string;
-    role: "button" | "list" | "listbox";
-    events: Partial<{
-        [K in keyof HTMLElementEventMap]: EventHandler | null;
-    }>;
-};
-export type Attrs<E extends Omit<Element, "update">, S = object> = Partial<Omit<E, "style"> & S & DomAttrs>;
-export type DenormAttrs<E extends Omit<Element, "update">, S = object> = Attrs<E, S> | DenormChildren;
-declare global {
-    interface Element {
-        [Events]: Map<string, EventHandler>;
-        update(attrs?: DenormAttrs<Element>, ...children: DenormChildren[]): this;
-    }
-}
-export type DOMUpdates<E extends Element = Element> = [DenormAttrs<E>, ...DenormChildren[]] | DenormChildren[];
-export declare function normalizeArguments<E extends Element>(attrs?: DenormAttrs<E>, children?: DenormChildren[], defaultAttrs?: Attrs<E>): [Attrs<E>, DenormChildren[]];
-export declare function up<E extends Element>(element: Omit<E, "update">, attrs?: DenormAttrs<E>, ...children: DenormChildren[]): E;
-export declare function update(element: Omit<Element, "update">, attrs: Attrs<Element>, children: DenormChildren[]): Element;
-export {};

package/lib/cjs/dom/fc.d.ts

@@ -1,10 +0,0 @@
-import { type DenormChildren, type DomAttrs } from "./dom.ts";
-export type Attrs<S> = S & Partial<DomAttrs>;
-export declare const State: unique symbol;
-export interface FCComponent<Props extends object, State extends object> extends Element {
-    [State]?: Partial<State>;
-    update(attrs?: Partial<Attrs<Props> & DomAttrs> | DenormChildren, ...children: DenormChildren[]): this;
-}
-export type RenderFn<Props extends object, State extends object> = (el: FCComponent<Props, State>, attrs: Attrs<Props>, children: DenormChildren[]) => Element | Element[];
-export type FCComponentCtor<Props extends object, State extends object> = (attrs?: Attrs<Props> | DenormChildren, ...children: DenormChildren[]) => FCComponent<Props, State>;
-export declare function FC<Props extends object, State extends object = object>(name: string, component: RenderFn<Props, State>): FCComponentCtor<Props, State>;

package/lib/cjs/dom/fc.test.d.ts

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

package/lib/cjs/dom/form/form.app.d.ts

@@ -1 +0,0 @@
-export declare const App: () => HTMLElement;

package/lib/cjs/dom/form/form.d.ts

@@ -1,25 +0,0 @@
-import type { DenormChildren } from "../dom.ts";
-import type { FormAttributes, InputAttributes, LabelAttributes, OptionAttributes, SelectAttributes } from "../types/html";
-export declare const Form: (attrs: FormAttributes, ...children: DenormChildren[]) => HTMLFormElement;
-export declare const Input: (attrs: InputAttributes, ...children: DenormChildren[]) => HTMLLabelElement;
-export declare const Select: (attrs: {
-    options: string[] | object;
-    selected?: string;
-} & SelectAttributes & LabelAttributes) => HTMLLabelElement;
-export declare const Button: () => void;
-declare const prepareOptions: (attrs: string[] | Record<string, string | {
-    label: string;
-    disabled?: boolean;
-    selected?: boolean;
-}>, selected?: string) => Parameters<typeof Option>[0][];
-export declare const Option: (attrs: OptionAttributes) => HTMLOptionElement;
-export declare const Dropdown: (attrs: SelectAttributes | {
-    selected?: string;
-}, ...options: Parameters<typeof prepareOptions>[0][]) => HTMLLabelElement;
-export declare const Radios: () => void;
-export declare const Checks: () => void;
-export declare const Switches: () => void;
-export declare const Radio: (attrs: Omit<InputAttributes, "type">) => HTMLLabelElement;
-export declare const Checkbox: (attrs: Omit<InputAttributes, "type">) => HTMLLabelElement;
-export declare const Switch: () => HTMLLabelElement;
-export {};