@design-edito/tools 0.3.0 → 1.0.1

package/agnostic/html/replace-in-element/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * Replaces specific descendant nodes of a given element according to a
- * replacement map.
- *
- * Only entries whose target nodes are descendants of `inputElement`
- * are applied. Each target node is removed after its replacement node(s)
- * are inserted in its place.
- *
- * @param {Element} inputElement - The root element within which replacements are applied.
- * @param {Map<Node, Node | NodeListOf<Node>>} replaceMap
- * - A map associating nodes to be replaced with either a single replacement
- *   node or a list of replacement nodes.
- * @returns {Element} The original `inputElement`, after replacements have been applied.
- */
-export declare function replaceInElement(inputElement: Element, replaceMap: Map<Node, Node | NodeListOf<Node>>): Element;

package/agnostic/html/replace-in-element/index.js

@@ -1,26 +0,0 @@
-import {
-  getNodeAncestors
-} from "../../../chunks/chunk-3MPXVP4L.js";
-import "../../../chunks/chunk-ROWPCMQY.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/html/replace-in-element/index.ts
-function replaceInElement(inputElement, replaceMap) {
-  const actualReplaceMap = new Map(Array.from(replaceMap).filter(([toReplace]) => {
-    const toReplaceAncestors = getNodeAncestors(toReplace);
-    return toReplaceAncestors.includes(inputElement);
-  }));
-  actualReplaceMap.forEach((replacer, toReplace) => {
-    if ("nodeType" in replacer) {
-      toReplace.parentNode?.insertBefore(replacer, toReplace);
-    } else {
-      const replacerNodes = Array.from(replacer);
-      replacerNodes.forEach((rpl) => toReplace.parentNode?.insertBefore(rpl, toReplace));
-    }
-    toReplace.parentNode?.removeChild(toReplace);
-  });
-  return inputElement;
-}
-export {
-  replaceInElement
-};

package/agnostic/html/replace-in-element/index.test.d.ts

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

package/agnostic/html/selector-to-element/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * Creates a DOM element from a CSS-like selector string.
- * Tag name defaults to div.
- *
- * Supports simple tag, ID, class, and attribute syntax:
- * - Tag name (e.g., `"div"`)
- * - ID (e.g., `"#myId"`)
- * - Classes (e.g., `".class1.class2"`)
- * - Attributes (e.g., `"[attr=value]"`)
- *
- * @param {string} selector - The selector string used to construct the element.
- * @returns {Element} A newly created DOM element corresponding to the selector.
- *
- * @throws Will throw an error if no document object is available for element creation.
- */
-export declare function selectorToElement(selector: string): Element;

package/agnostic/html/selector-to-element/index.js

@@ -1,34 +0,0 @@
-import {
-  get
-} from "../../../chunks/chunk-ROWPCMQY.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/html/selector-to-element/index.ts
-function selectorToElement(selector) {
-  const tagRegexp = /^[A-Za-z]+/;
-  const idRegexp = /#[A-Za-z]+[\w\-\:]*/;
-  const classRegexp = /\.[A-Za-z]+[\w\-]*/g;
-  const attributeRegexp = /\[[A-Za-z]+[\w\-]*(="[\w\-]+")?\]/g;
-  const matchedTags = selector.match(tagRegexp) ?? [];
-  const matchedIds = selector.match(idRegexp) ?? [];
-  const matchedClasses = selector.match(classRegexp) ?? [];
-  const matchedAttrs = selector.match(attributeRegexp) ?? [];
-  const tag = matchedTags[matchedTags.length - 1] ?? "div";
-  const id = matchedIds.length > 0 ? matchedIds[matchedIds.length - 1]?.replace(/^#/, "") : null;
-  const classes = matchedClasses.map((matchedClass) => matchedClass.replace(/^\./, ""));
-  const attributes = matchedAttrs.map((matchedAttr) => matchedAttr.replace(/^\[/, "").replace(/\]$/, "").split("="));
-  const element = get().document.createElement(tag);
-  if (id !== null) {
-    element.id = id;
-  }
-  element.classList.add(...classes);
-  attributes.forEach(([name, value = ""]) => {
-    if (name === void 0) return;
-    const cleanValue = value.replace(/^"(.*)"$/, "$1");
-    element.setAttribute(name, cleanValue);
-  });
-  return element;
-}
-export {
-  selectorToElement
-};

package/agnostic/html/selector-to-element/index.test.d.ts

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

package/agnostic/html/string-to-nodes/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * Converts a string into an array of DOM nodes.
- *
- * If sanitization options are provided, the string is first sanitized
- * using `Sanitize.sanitize`.
- *
- * Only element and text nodes are included in the returned array; comment
- * and other node types are ignored.
- *
- * @param {string} inputStr - The input string to convert into nodes.
- * @param {SanitizeHtmlOptions} [options.sanitize] - Sanitization options for the input string.
- * @returns {Node[]} An array of DOM nodes created from the string.
- */
-export declare function stringToNodes(inputStr: string): Node[];

package/agnostic/html/string-to-nodes/index.js

@@ -1,20 +0,0 @@
-import {
-  get
-} from "../../../chunks/chunk-ROWPCMQY.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/html/string-to-nodes/index.ts
-function stringToNodes(inputStr) {
-  const window = get();
-  const { document, Node } = window;
-  const wrapperDiv = document.createElement("div");
-  wrapperDiv.innerHTML = inputStr;
-  const nodes = Array.from(wrapperDiv.childNodes).filter((node) => {
-    const allowedNodeTypes = [Node.ELEMENT_NODE, Node.TEXT_NODE];
-    return allowedNodeTypes.includes(node.nodeType);
-  });
-  return nodes;
-}
-export {
-  stringToNodes
-};

package/agnostic/html/string-to-nodes/index.test.d.ts

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

package/agnostic/misc/assert/index.d.ts

@@ -1,5 +0,0 @@
-import * as Outcome from '../outcome/index.js';
-type Assertion = (() => boolean) | (() => Promise<boolean>) | boolean;
-export declare function assert(label: string, assertion: Assertion | Array<Assertion> | Map<string, Assertion> | Record<string, Assertion>): Promise<Outcome.Either<string, string>>;
-export declare function assertVerbose(label: string, assertion: Assertion | Array<Assertion> | Map<string, Assertion>): Promise<void | Outcome.Success<string>>;
-export {};

package/agnostic/misc/assert/index.js

@@ -1,64 +0,0 @@
-import {
-  makeFailure,
-  makeSuccess
-} from "../../../chunks/chunk-QEKI6WGQ.js";
-import {
-  unknownToString
-} from "../../../chunks/chunk-FENXVJYO.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/misc/assert/index.ts
-function makeSuccess2(label) {
-  const formattedLabel = label.split("\n").join("\n  ");
-  console.info(`\u2705 SUCCESS:
-  ${formattedLabel}`);
-}
-function makeFailure2(label) {
-  const formattedLabel = label.split("\n").join("\n  ");
-  throw new Error(`\u{1F6AB} FAILURE:
-  ${formattedLabel}`);
-}
-async function assert(label, assertion) {
-  if (typeof assertion === "boolean") return assertion ? makeSuccess(label) : makeFailure(label);
-  else if (typeof assertion === "function") {
-    try {
-      const result = await assertion();
-      if (result === false) return makeFailure(label);
-      else return makeSuccess(label);
-    } catch (err) {
-      const errStr = unknownToString(err);
-      return makeFailure(`${label} / ${errStr}`);
-    }
-  } else {
-    let assertions;
-    if (Array.isArray(assertion)) {
-      assertions = [...assertion].map((a, p) => [`${p}`, a]);
-    } else if (assertion instanceof Map) {
-      assertions = Array.from(assertion);
-    } else {
-      assertions = Object.entries(assertion);
-    }
-    const allAsserted = await Promise.all(assertions.map(([innerLabel, innerAssertion]) => {
-      const fullLabel = `${label} / ${innerLabel}`;
-      const asserted = assert(fullLabel, innerAssertion);
-      return asserted;
-    }));
-    const allSuccess = allAsserted.every((asserted) => asserted.success);
-    if (allSuccess) return makeSuccess(allAsserted.map((e) => e.payload).join("\n"));
-    const failures = allAsserted.filter((asserted) => asserted.success === false);
-    const failuresStr = failures.map((failure) => failure.error).join("\n  ");
-    return makeFailure(failuresStr);
-  }
-}
-async function assertVerbose(label, assertion) {
-  const asserted = await assert(label, assertion);
-  if (asserted?.success) {
-    makeSuccess2(asserted.payload);
-    return asserted;
-  }
-  return makeFailure2(asserted.error);
-}
-export {
-  assert,
-  assertVerbose
-};

package/agnostic/misc/cast/index.d.ts

@@ -1,81 +0,0 @@
-/**
- * Converts a value to a boolean.
- *
- * - Booleans are returned as-is.
- * - Strings equal to `"true"` (case-insensitive, trimmed) are `true`, others `false`.
- * - Other values are coerced using `!isFalsy`.
- *
- * @param {unknown} value - The value to convert.
- * @returns {boolean} The boolean representation of the input.
- */
-export declare function toBoolean(value: unknown): boolean;
-/**
- * Converts a value to a number.
- *
- * - Numbers are returned as-is.
- * - Strings are parsed as floats.
- * - Other values return 0.
- *
- * @param {unknown} value - The value to convert.
- * @returns {number} The numeric representation of the input.
- */
-export declare function toNumber(value: unknown): number;
-/**
- * Converts a value to a string.
- *
- * - Strings are returned as-is.
- * - Other values are converted using `String()`.
- *
- * @param {unknown} value - The value to convert.
- * @returns {string} The string representation of the input.
- */
-export declare function toString(value: unknown): string;
-/**
- * Converts any value to `null`.
- *
- * @param {unknown} _value - The input value (ignored).
- * @returns {null} Always returns `null`.
- */
-export declare function toNull(_value: unknown): null;
-/**
- * Converts a value to an array.
- *
- * - Arrays are returned as-is.
- * - Objects are converted to an array of `[key, value]` pairs.
- * - Other values are wrapped in a single-element array.
- *
- * @param {unknown} value - The value to convert.
- * @returns {Array<unknown>} The array representation of the input.
- */
-export declare function toArray(value: unknown): Array<unknown>;
-/**
- * Converts a value to an array of numbers.
- *
- * - Uses `toArray` to ensure an array.
- * - Each element is converted to a number using `toNumber`.
- *
- * @param {unknown} value - The value to convert.
- * @returns {number[]} Array of numeric values.
- */
-export declare function toNumberArr(value: unknown): number[];
-/**
- * Converts a value to a plain object (record).
- *
- * - Keys and values of objects are copied.
- * - Non-object values return an empty object.
- *
- * @param {unknown} value - The value to convert.
- * @returns {Record<string, unknown>} The object representation of the input.
- */
-export declare function toRecord(value: unknown): Record<string, unknown>;
-/**
- * Converts a value to an `Error` object.
- *
- * - Returns the value if it is already an `Error`.
- * - Strings are used as the error message.
- * - Other values are converted to string and used as the error message.
- *
- * @param {unknown} value - The value to convert.
- * @returns {Error} An `Error` instance representing the input.
- */
-export declare function toError(value: unknown): Error;

package/agnostic/misc/cast/index.js

@@ -1,23 +0,0 @@
-import {
-  toArray,
-  toBoolean,
-  toError,
-  toNull,
-  toNumber,
-  toNumberArr,
-  toRecord,
-  toString
-} from "../../../chunks/chunk-YWSXCFYY.js";
-import "../../../chunks/chunk-QXAJXTXV.js";
-import "../../../chunks/chunk-HC6ZOHCS.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-export {
-  toArray,
-  toBoolean,
-  toError,
-  toNull,
-  toNumber,
-  toNumberArr,
-  toRecord,
-  toString
-};

package/agnostic/misc/cast/index.test.d.ts

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

package/agnostic/misc/connection/index.d.ts

@@ -1,26 +0,0 @@
-/**
- * Represents a minimal network connection object.
- *
- * @property {number} downlink - Estimated downlink speed in Mbps.
- * @property {'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown'} type - Connection type.
- * @property {'slow-2g' | '2g' | '3g' | '4g'} effectiveType - Effective connection type.
- */
-export type MinimalConnection = {
-    downlink: number;
-    type: 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
-    effectiveType: 'slow-2g' | '2g' | '3g' | '4g';
-};
-/**
- * Retrieves the current network connection information from the environment.
- *
- * Uses the `navigator.connection` API or vendor-prefixed alternatives.
- *
- * @returns {MinimalConnection | undefined} A minimal connection object if available, otherwise `undefined`.
- */
-export declare function getConnection(): MinimalConnection | undefined;
-/**
- * Retrieves the estimated downlink speed of the current network connection.
- *
- * @returns {number | undefined} Downlink speed in Mbps, or `undefined` if not available.
- */
-export declare function getCurrentDownlink(): number | undefined;

package/agnostic/misc/connection/index.js

@@ -1,39 +0,0 @@
-import {
-  get
-} from "../../../chunks/chunk-ROWPCMQY.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/misc/connection/index.ts
-function isType(unk) {
-  return unk === "bluetooth" || unk === "cellular" || unk === "ethernet" || unk === "none" || unk === "wifi" || unk === "wimax" || unk === "other" || unk === "unknown";
-}
-function isEffectiveType(unk) {
-  return unk === "slow-2g" || unk === "2g" || unk === "3g" || unk === "4g";
-}
-function isConnection(unk) {
-  if (typeof unk !== "object") return false;
-  if (unk === null) return false;
-  if (!("downlink" in unk)) return false;
-  if (typeof unk.downlink !== "number") return false;
-  if (!("type" in unk)) return false;
-  if (!isType(unk.type)) return false;
-  if (!("effectiveType" in unk)) return false;
-  if (!isEffectiveType(unk.effectiveType)) return false;
-  unk;
-  return true;
-}
-function getConnection() {
-  const window = get();
-  const navigator = window.navigator;
-  if (typeof navigator !== "object" || navigator === null) return void 0;
-  const connection = navigator.connection ?? navigator.mozConnection ?? navigator.webkitConnection;
-  if (!isConnection(connection)) return void 0;
-  return connection;
-}
-function getCurrentDownlink() {
-  return getConnection()?.downlink;
-}
-export {
-  getConnection,
-  getCurrentDownlink
-};

package/agnostic/misc/connection/index.test.d.ts

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

package/agnostic/misc/crawler/index.d.ts

@@ -1,63 +0,0 @@
-/**
- * Function that fetches content from a URL asynchronously.
- *
- * @template T - The type of content returned by the fetcher.
- * @param {string} url - The URL to fetch.
- * @returns {Promise<T>} A promise resolving to the fetched content.
- */
-export type Fetcher<T> = (url: string) => Promise<T>;
-/**
- * Function that processes fetched content for a given URL.
- *
- * @template T - The type of content provided by the fetcher.
- * @param {string} url - The URL of the content being processed.
- * @param {T} content - The content fetched from the URL.
- * @param {{ push: (...urls: string[]) => void, flush: () => void }} hooks - Hooks for dynamically enqueuing or clearing URLs.
- * @returns {any} The result of processing (ignored by the crawler).
- */
-export type Processor<T> = (url: string, content: T, hooks: {
-    push: (...urls: string[]) => void;
-    flush: () => void;
-}) => any;
-/**
- * Optional logging function called during crawling.
- *
- * @param {number} ops - Number of processed URLs so far.
- * @param {string} url - The URL currently being processed.
- * @param {string[]} waitlist - The current waitlist of URLs.
- * @param {Set<string>} processed - Set of URLs already processed.
- */
-export type Logger = (ops: number, url: string, waitlist: string[], processed: Set<string>) => void;
-/**
- * Configuration options for the crawler.
- *
- * @template T - The type of content returned by the fetcher.
- * @property {number} limit - Maximum number of URLs to process.
- * @property {number | (() => number)} [delayMs] - Optional delay between processing URLs, in milliseconds, or a function returning the delay.
- * @property {Fetcher<T>} fetcher - Function that fetches content for each URL.
- * @property {Processor<T>} processor - Function that processes fetched content.
- * @property {Logger} [logger] - Optional function for logging crawl progress.
- */
-export type Options<T extends any> = {
-    limit: number;
-    delayMs?: number | (() => number);
-    fetcher: Fetcher<T>;
-    processor: Processor<T>;
-    logger?: Logger;
-};
-/**
- * Creates a sequential crawler with optional logging and delay.
- *
- * @template T - The type of content returned by the fetcher.
- * @param {Options<T>} options - Crawler configuration options.
- * @returns {{
- *   crawl: (startUrl: string) => Promise<void>,
- *   push: (url: string) => void,
- *   flush: () => void
- * }} An object with methods to start crawling, enqueue URLs, and flush the waitlist.
- */
-export declare function create<T extends any>(options: Options<T>): {
-    crawl: (startUrl: string) => Promise<void>;
-    push: (url: string) => void;
-    flush: () => void;
-};

package/agnostic/misc/crawler/index.js

@@ -1,35 +0,0 @@
-import {
-  wait
-} from "../../../chunks/chunk-4CIS3R7T.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/misc/crawler/index.ts
-function create(options) {
-  let ops = 0;
-  const waitlist = [];
-  const push = (url) => waitlist.push(url);
-  const flush = () => {
-    waitlist.length = 0;
-  };
-  const processed = /* @__PURE__ */ new Set();
-  const crawl = async (startUrl) => {
-    push(startUrl);
-    while (waitlist.length > 0 && ops < options.limit) {
-      ops++;
-      const currentUrl = waitlist[0];
-      if (options.logger !== void 0) options.logger(ops, currentUrl, waitlist, processed);
-      if (!processed.has(currentUrl)) {
-        const content = await options.fetcher(currentUrl);
-        await options.processor(currentUrl, content, { push, flush });
-      }
-      waitlist.shift();
-      processed.add(currentUrl);
-      const delayMs = typeof options.delayMs === "function" ? options.delayMs() : typeof options.delayMs === "number" ? options.delayMs : 0;
-      if (delayMs !== 0) await wait(delayMs);
-    }
-  };
-  return { crawl, push, flush };
-}
-export {
-  create
-};

package/agnostic/misc/crawler/index.test.d.ts

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

package/agnostic/misc/crossenv/detect-runtime/index.d.ts

@@ -1,12 +0,0 @@
-import { RuntimeName } from '../types.js';
-/**
- * Detects the current JavaScript runtime environment.
- *
- * Checks for Node.js, Browser, Deno, React Native, Electron,
- * Cloudflare Workers, and AWS Lambda.
- *
- * @returns {RuntimeName | null}
- * - The detected runtime as a `RuntimeName` enum value.
- * - `null` if the runtime cannot be determined.
- */
-export declare function detectRuntime(): RuntimeName | null;

package/agnostic/misc/crossenv/detect-runtime/index.js

@@ -1,17 +0,0 @@
-import "../../../../chunks/chunk-XIIJYVJZ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/misc/crossenv/detect-runtime/index.ts
-function detectRuntime() {
-  if (typeof process !== "undefined" && typeof process.versions !== "undefined" && typeof process.versions.node !== "undefined") return "Node.js" /* NODE */;
-  if (typeof window !== "undefined" && typeof window.document !== "undefined") return "Browser" /* BROWSER */;
-  if (typeof Deno !== "undefined") return "Deno" /* DENO */;
-  if (typeof process !== "undefined" && typeof navigator.userAgent === "string" && /ReactNative/.test(navigator.userAgent)) return "React Native" /* REACT_NATIVE */;
-  if (typeof process !== "undefined" && typeof process.versions !== "undefined" && typeof process.version.electron !== "undefined") return "Electron" /* ELECTRON */;
-  if (typeof self !== "undefined" && typeof self.addEventListener === "function" && typeof Headers !== "undefined") return "Cloudflare Workers" /* CLOUDFLARE */;
-  if (typeof AWS !== "undefined" && typeof AWS.Lambda !== "undefined") return "AWS Lambda" /* AWS_LAMBDA */;
-  return null;
-}
-export {
-  detectRuntime
-};

package/agnostic/misc/crossenv/detect-runtime/index.test.d.ts

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

package/agnostic/misc/crossenv/types.d.ts

@@ -1,40 +0,0 @@
-/**
- * Enum representing the possible runtime environments.
- *
- * - `NODE`         : Node.js
- * - `BROWSER`      : Web browser
- * - `DENO`         : Deno runtime
- * - `REACT_NATIVE` : React Native
- * - `ELECTRON`     : Electron
- * - `CLOUDFLARE`   : Cloudflare Workers
- * - `AWS_LAMBDA`   : AWS Lambda
- */
-export declare enum RuntimeName {
-    NODE = "Node.js",
-    BROWSER = "Browser",
-    DENO = "Deno",
-    REACT_NATIVE = "React Native",
-    ELECTRON = "Electron",
-    CLOUDFLARE = "Cloudflare Workers",
-    AWS_LAMBDA = "AWS Lambda"
-}
-/**
- * Minimal subset of the `window` object, sufficient to work with DOM-like APIs.
- *
- * Provides access to the basic constructors and the document object:
- * - `Node`
- * - `Element`
- * - `Text`
- * - `NodeList`
- * - `Attr`
- * - `document`
- */
-export interface MinimalWindow {
-    Node: typeof Node;
-    Element: typeof Element;
-    Text: typeof Text;
-    NodeList: typeof NodeList;
-    Attr: typeof Attr;
-    ShadowRoot: typeof ShadowRoot;
-    document: Document;
-}

package/agnostic/misc/crossenv/types.js

@@ -1,7 +0,0 @@
-import {
-  RuntimeName
-} from "../../../chunks/chunk-XIIJYVJZ.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-export {
-  RuntimeName
-};

package/agnostic/misc/crossenv/window/index.d.ts

@@ -1,28 +0,0 @@
-import { MinimalWindow } from '../types.js';
-/**
- * Checks whether a `window` object exists in the current environment.
- *
- * @returns {boolean} `true` if `window` is present, `false` otherwise.
- */
-export declare function exists(): boolean;
-/**
- * Sets a custom `window` object to be used internally.
- *
- * @param {MinimalWindow | null} customWindow - The window object to set, or `null` to unset.
- * @returns {MinimalWindow | null} The window object that was set.
- */
-export declare function set(customWindow: MinimalWindow | null): MinimalWindow | null;
-/**
- * Resets the internal window reference to the global `window` if it exists,
- * or `null` if no global `window` is available.
- *
- * @returns {MinimalWindow | null} The current internal window object after reset.
- */
-export declare function unset(): MinimalWindow | null;
-/**
- * Retrieves the currently set `window` object.
- *
- * @returns {MinimalWindow} The internal window object.
- * @throws Will throw an error if no window has been set and none exists globally.
- */
-export declare function get(): MinimalWindow;

package/agnostic/misc/crossenv/window/index.js

@@ -1,13 +0,0 @@
-import {
-  exists,
-  get,
-  set,
-  unset
-} from "../../../../chunks/chunk-ROWPCMQY.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  exists,
-  get,
-  set,
-  unset
-};

package/agnostic/misc/crossenv/window/index.test.d.ts

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