@angular-wave/angular.ts 0.9.4 → 0.9.5

package/src/shared/queue.js

@@ -1,105 +0,0 @@
-/**
- * A simple bounded FIFO queue with optional eviction notifications.
- * @template T
- */
-export class Queue {
-  /**
-   * @param {T[]} [items=[]] - Initial queue items.
-   * @param {number|null} [limit=null] - Maximum allowed items before eviction (null = unlimited).
-   */
-  constructor(items = [], limit = null) {
-    /** @type {T[]} */
-    this._items = Array.isArray(items) ? [...items] : [];
-
-    /** @type {number|null} */
-    this._limit = Number.isInteger(limit) && limit > 0 ? limit : null;
-
-    /** @type {Array<(item: T) => void>} */
-    this._evictListeners = [];
-  }
-
-  /**
-   * Register a listener that will be called with the evicted item.
-   * @param {(item: T) => void} listener
-   */
-  onEvict(listener) {
-    this._evictListeners.push(listener);
-  }
-
-  /**
-   * Adds an item to the end of the queue, evicting the head if over limit.
-   * @param {T} item
-   * @returns {T}
-   */
-  enqueue(item) {
-    this._items.push(item);
-    if (this._limit !== null && this._items.length > this._limit) {
-      this.evict();
-    }
-    return item;
-  }
-
-  /**
-   * Removes the head item and notifies eviction listeners.
-   * @returns {T|undefined}
-   */
-  evict() {
-    const item = this._items.shift();
-    if (item !== undefined) {
-      this._evictListeners.forEach((fn) => fn(item));
-    }
-    return item;
-  }
-
-  /**
-   * Removes and returns the first item in the queue.
-   * @returns {T|undefined}
-   */
-  dequeue() {
-    return this._items.length > 0 ? this._items.shift() : undefined;
-  }
-
-  /**
-   * Clears all items from the queue.
-   * @returns {T[]} The previously stored items.
-   */
-  clear() {
-    const cleared = [...this._items];
-    this._items.length = 0;
-    return cleared;
-  }
-
-  /**
-   * Returns the current number of items.
-   * @returns {number}
-   */
-  size() {
-    return this._items.length;
-  }
-
-  /**
-   * Removes a specific item from the queue.
-   * @param {T} item
-   * @returns {T|false} The removed item, or false if not found.
-   */
-  remove(item) {
-    const index = this._items.indexOf(item);
-    return index !== -1 ? this._items.splice(index, 1)[0] : false;
-  }
-
-  /**
-   * Returns the item at the tail (last).
-   * @returns {T|undefined}
-   */
-  peekTail() {
-    return this._items[this._items.length - 1];
-  }
-
-  /**
-   * Returns the item at the head (first).
-   * @returns {T|undefined}
-   */
-  peekHead() {
-    return this._items[0];
-  }
-}

package/src/shared/queue.spec.js

@@ -1,80 +0,0 @@
-import { Queue } from "./queue.js";
-
-describe("Queue", () => {
-  let queue;
-
-  beforeEach(() => {
-    queue = new Queue();
-  });
-
-  it("should enqueue items", () => {
-    queue.enqueue("a");
-    queue.enqueue("b");
-    expect(queue.size()).toBe(2);
-    expect(queue.peekHead()).toBe("a");
-    expect(queue.peekTail()).toBe("b");
-  });
-
-  it("should dequeue items", () => {
-    queue.enqueue("x");
-    queue.enqueue("y");
-    const item = queue.dequeue();
-    expect(item).toBe("x");
-    expect(queue.size()).toBe(1);
-    expect(queue.peekHead()).toBe("y");
-  });
-
-  it("should evict when over limit", () => {
-    const evicted = [];
-    queue = new Queue([], 2);
-    queue.onEvict((item) => evicted.push(item));
-    queue.enqueue("1");
-    queue.enqueue("2");
-    queue.enqueue("3"); // should evict "1"
-    expect(queue.size()).toBe(2);
-    expect(evicted).toEqual(["1"]);
-    expect(queue.peekHead()).toBe("2");
-  });
-
-  it("should remove specific items", () => {
-    queue.enqueue("a");
-    queue.enqueue("b");
-    queue.enqueue("c");
-    const removed = queue.remove("b");
-    expect(removed).toBe("b");
-    expect(queue.size()).toBe(2);
-    expect(queue._items).toEqual(["a", "c"]);
-  });
-
-  it("should clear the queue", () => {
-    queue.enqueue("foo");
-    queue.enqueue("bar");
-    const cleared = queue.clear();
-    expect(cleared).toEqual(["foo", "bar"]);
-    expect(queue.size()).toBe(0);
-  });
-
-  it("should peek at head and tail", () => {
-    queue.enqueue("first");
-    queue.enqueue("last");
-    expect(queue.peekHead()).toBe("first");
-    expect(queue.peekTail()).toBe("last");
-  });
-
-  it("should return undefined when dequeueing from empty queue", () => {
-    expect(queue.dequeue()).toBeUndefined();
-  });
-
-  it("should return undefined when peeking head in empty queue", () => {
-    expect(queue.peekHead()).toBeUndefined();
-  });
-
-  it("should not evict if limit is not reached", () => {
-    const evicted = [];
-    queue = new Queue([], 3);
-    queue.onEvict((item) => evicted.push(item));
-    queue.enqueue("1");
-    queue.enqueue("2");
-    expect(evicted.length).toBe(0);
-  });
-});

package/src/shared/shared.html

@@ -1,24 +0,0 @@
-<!doctype html>
-<html>
-  <head>
-    <meta charset="utf-8" />
-    <title>AngularTS Test Runner</title>
-
-    <link rel="shortcut icon" type="image/png" href="/images/favicon.ico" />
-    <link rel="stylesheet" href="/jasmine/jasmine.css" />
-    <link rel="stylesheet" href="/public/jasmine-helper.css" />
-    <script src="/jasmine/jasmine.js"></script>
-    <script src="/jasmine/jasmine-html.js"></script>
-    <script src="/jasmine/boot0.js"></script>
-    <script src="/jasmine/boot1.js"></script>
-    <script type="module" src="/src/shared/common.spec.js"></script>
-    <script type="module" src="/src/shared/hof.spec.js"></script>
-    <script type="module" src="/src/shared/min-err.spec.js"></script>
-    <script type="module" src="/src/shared/queue.spec.js"></script>
-    <script type="module" src="/src/shared/strings.spec.js"></script>
-    <script type="module" src="/src/shared/utils.spec.js"></script>
-  </head>
-  <body>
-    <div id="app"></div>
-  </body>
-</html>

package/src/shared/shared.test.js

@@ -1,12 +0,0 @@
-import { test, expect } from "@playwright/test";
-
-const TEST_URL = "src/shared/shared.html";
-
-test("unit tests contain no errors", async ({ page }) => {
-  await page.goto(TEST_URL);
-  await page.content();
-  await page.waitForTimeout(1000);
-  await expect(page.locator(".jasmine-overall-result")).toHaveText(
-    / 0 failures/,
-  );
-});

package/src/shared/strings.js

@@ -1,142 +0,0 @@
-import { isInjectable, isPromise } from "./predicates.js";
-import {
-  isUndefined,
-  isFunction,
-  isNull,
-  isString,
-  isObject,
-} from "./utils.js";
-import { pushR, tail } from "./common.js";
-import { pattern, val } from "./hof.js";
-
-/**
- * Functions that manipulate strings
- */
-
-/**
- * Returns a string shortened to a maximum length
- *
- * If the string is already less than the `max` length, return the string.
- * Else return the string, shortened to `max - 3` and append three dots ("...").
- *
- * @param max the maximum length of the string to return
- * @param str the input string
- */
-export function maxLength(max, str) {
-  if (str.length <= max) return str;
-  return str.substring(0, max - 3) + "...";
-}
-/**
- * Returns a string, with spaces added to the end, up to a desired str length
- *
- * If the string is already longer than the desired length, return the string.
- * Else returns the string, with extra spaces on the end, such that it reaches `length` characters.
- *
- * @param length the desired length of the string to return
- * @param str the input string
- */
-export function padString(length, str) {
-  while (str.length < length) str += " ";
-  return str;
-}
-export function kebobString(camelCase) {
-  return camelCase
-    .replace(/^([A-Z])/, ($1) => $1.toLowerCase()) // replace first char
-    .replace(/([A-Z])/g, ($1) => "-" + $1.toLowerCase()); // replace rest
-}
-export function functionToString(fn) {
-  const fnStr = fnToString(fn);
-  const namedFunctionMatch = fnStr.match(/^(function [^ ]+\([^)]*\))/);
-  const toStr = namedFunctionMatch ? namedFunctionMatch[1] : fnStr;
-  const fnName = fn["name"] || "";
-  if (fnName && toStr.match(/function \(/)) {
-    return "function " + fnName + toStr.substring(9);
-  }
-  return toStr;
-}
-export function fnToString(fn) {
-  const _fn = Array.isArray(fn) ? fn.slice(-1)[0] : fn;
-  return (_fn && _fn.toString()) || "undefined";
-}
-export function stringify(o) {
-  const seen = [];
-  const isRejection = (obj) => {
-    return (
-      obj &&
-      typeof obj.then === "function" &&
-      obj.constructor.name == "Rejection"
-    );
-  };
-  const hasToString = (obj) =>
-    isObject(obj) &&
-    !Array.isArray(obj) &&
-    obj.constructor !== Object &&
-    isFunction(obj.toString);
-  const stringifyPattern = pattern([
-    [isUndefined, val("undefined")],
-    [isNull, val("null")],
-    [isPromise, val("[Promise]")],
-    [isRejection, (x) => x._transitionRejection.toString()],
-    [hasToString, (x) => x.toString()],
-    [isInjectable, functionToString],
-    [val(true), (x) => x],
-  ]);
-  function format(value) {
-    if (isObject(value)) {
-      if (seen.indexOf(value) !== -1) return "[circular ref]";
-      seen.push(value);
-    }
-    return stringifyPattern(value);
-  }
-  if (isUndefined(o)) {
-    // Workaround for IE & Edge Spec incompatibility where replacer function would not be called when JSON.stringify
-    // is given `undefined` as value. To work around that, we simply detect `undefined` and bail out early by
-    // manually stringifying it.
-    return format(o);
-  }
-  return JSON.stringify(o, (key, value) => format(value)).replace(/\\"/g, '"');
-}
-/** Returns a function that splits a string on a character or substring */
-export const beforeAfterSubstr = (char) => (str) => {
-  if (!str) return ["", ""];
-  const idx = str.indexOf(char);
-  if (idx === -1) return [str, ""];
-  return [str.substring(0, idx), str.substring(idx + 1)];
-};
-export const hostRegex = new RegExp("^(?:[a-z]+:)?//[^/]+/");
-export const stripLastPathElement = (str) => str.replace(/\/[^/]*$/, "");
-export const splitHash = beforeAfterSubstr("#");
-export const splitQuery = beforeAfterSubstr("?");
-export const splitEqual = beforeAfterSubstr("=");
-export const trimHashVal = (str) => (str ? str.replace(/^#/, "") : "");
-/**
- * Splits on a delimiter, but returns the delimiters in the array
- *
- * #### Example:
- * ```js
- * var splitOnSlashes = splitOnDelim('/');
- * splitOnSlashes("/foo"); // ["/", "foo"]
- * splitOnSlashes("/foo/"); // ["/", "foo", "/"]
- * ```
- */
-export function splitOnDelim(delim) {
-  const re = new RegExp("(" + delim + ")", "g");
-  return (str) => str.split(re).filter(Boolean);
-}
-/**
- * Reduce fn that joins neighboring strings
- *
- * Given an array of strings, returns a new array
- * where all neighboring strings have been joined.
- *
- * #### Example:
- * ```js
- * let arr = ["foo", "bar", 1, "baz", "", "qux" ];
- * arr.reduce(joinNeighborsR, []) // ["foobar", 1, "bazqux" ]
- * ```
- */
-export function joinNeighborsR(acc, x) {
-  if (isString(tail(acc)) && isString(x))
-    return acc.slice(0, -1).concat(tail(acc) + x);
-  return pushR(acc, x);
-}

package/src/shared/strings.spec.js

@@ -1,40 +0,0 @@
-import { stripLastPathElement } from "./strings.js";
-
-describe("string functions:", () => {
-  describe("stripLastPathElement", () => {
-    it("should strip trailing filenames from a path", () => {
-      const result = stripLastPathElement("/some/path/to/file.html");
-      expect(result).toBe("/some/path/to");
-    });
-
-    it("should strip a filename (with no extension) from a path ", () => {
-      const result = stripLastPathElement("/some/path/to/file");
-      expect(result).toBe("/some/path/to");
-    });
-
-    it("should strip trailing filenames from a root path", () => {
-      const result = stripLastPathElement("/file.html");
-      expect(result).toBe("");
-    });
-
-    it("should strip a filename (with no extension) from a root path", () => {
-      const result = stripLastPathElement("/file");
-      expect(result).toBe("");
-    });
-
-    it("should strip a trailing slash", () => {
-      expect(stripLastPathElement("/path/")).toBe("/path");
-      expect(stripLastPathElement("/path/foo/")).toBe("/path/foo");
-    });
-
-    it("should return empty string given an empty string", () => {
-      const result = stripLastPathElement("");
-      expect(result).toBe("");
-    });
-
-    it("should return an empty string given a slash", () => {
-      const result = stripLastPathElement("/");
-      expect(result).toBe("");
-    });
-  });
-});

package/src/shared/test-utils.js

@@ -1,47 +0,0 @@
-import { isObject } from "./utils.js";
-import { dealoc } from "./dom.js";
-
-/**
- * Triggers a browser event on the specified element.
- * @param {HTMLElement} element - The target element.
- * @param {Object} options - The event type and properties.
- */
-export function browserTrigger(element, options) {
-  const { type, ...eventProps } = options;
-  let event;
-  if (isObject(options) && type.startsWith("key")) {
-    event = new KeyboardEvent(type, eventProps);
-  } else if (isObject(options) && type.startsWith("mouse")) {
-    event = new MouseEvent(type, eventProps);
-  } else {
-    event = new Event(type || options, { bubbles: true, cancelable: true });
-  }
-
-  element.dispatchEvent(event);
-}
-
-/**
- * Delays execution for a specified number of milliseconds.
- * TODO remove
- *
- * @param {number} [t=0] - The number of milliseconds to wait. Defaults to 0.
- * @returns {Promise<void>} A promise that resolves after the delay.
- */
-export function wait(t = 0) {
-  return new Promise((resolve) => setTimeout(resolve, t));
-}
-
-let ELEMENT;
-
-/**
- * Helper for bootstraping content onto default element
- */
-export function bootstrap(htmlContent, moduleName) {
-  if (!ELEMENT) {
-    ELEMENT = document.getElementById("app");
-    window["ELEMENT"] = ELEMENT;
-  }
-  dealoc(ELEMENT);
-  ELEMENT.innerHTML = htmlContent;
-  return window["angular"].bootstrap(ELEMENT, [moduleName || "myModule"]);
-}

package/src/shared/url-utils/interface.ts

@@ -1,54 +0,0 @@
-/**
- * A normalized representation of a parsed URL.
- */
-export interface ParsedUrl {
-  /**
-   * The full URL string, including protocol, host, path, query, and hash.
-   * Example: "https://example.com:8080/path?query=1#section"
-   */
-  href: string;
-
-  /**
-   * The protocol scheme of the URL, without the trailing colon.
-   * Example: "http" or "https"
-   */
-  protocol: string;
-
-  /**
-   * The host part of the URL, including hostname and port (if specified).
-   * Example: "example.com:8080"
-   */
-  host: string;
-
-  /**
-   * The query string portion of the URL, without the leading "?".
-   * Example: "query=1&sort=asc"
-   */
-  search: string;
-
-  /**
-   * The fragment identifier (hash) of the URL, without the leading "#".
-   * Example: "section2"
-   */
-  hash: string;
-
-  /**
-   * The domain or IP address (including IPv6 in brackets) of the URL.
-   * Example: "example.com" or "[::1]"
-   */
-  hostname: string;
-
-  /**
-   * The port number of the URL as a string, or an empty string if not specified.
-   * Example: "8080" or ""
-   */
-  port: string;
-
-  /**
-   * The path of the URL, always beginning with a leading slash.
-   * Example: "/path/to/resource"
-   */
-  pathname: string;
-}
-
-export type ResolvableUrl = string | ParsedUrl;

package/src/shared/url-utils/url-utils.html

@@ -1,22 +0,0 @@
-<!doctype html>
-<html>
-  <head>
-    <meta charset="utf-8" />
-    <title>AngularTS Test Runner</title>
-
-    <link rel="shortcut icon" type="image/png" href="/images/favicon.ico" />
-    <link rel="stylesheet" href="/jasmine/jasmine.css" />
-    <link rel="stylesheet" href="/public/jasmine-helper.css" />
-    <script src="/jasmine/jasmine.js"></script>
-    <script src="/jasmine/jasmine-html.js"></script>
-    <script src="/jasmine/boot0.js"></script>
-    <script src="/jasmine/boot1.js"></script>
-    <script
-      type="module"
-      src="/src/shared/url-utils/url-utils.spec.js"
-    ></script>
-  </head>
-  <body>
-    <div id="app"></div>
-  </body>
-</html>

package/src/shared/url-utils/url-utils.js

@@ -1,122 +0,0 @@
-import { isString } from "../../shared/utils.js";
-
-const originUrl = urlResolve(window.location.href);
-
-/**
- * @param {import("./interface.js").ResolvableUrl} url
- * @return {import("./interface.js").ParsedUrl}
- */
-export function urlResolve(url) {
-  if (!isString(url))
-    return /** @type {import("./interface.js").ParsedUrl} */ (url);
-
-  const urlParsingNode = new URL(
-    /** @type {string} */ (url),
-    window.location.href,
-  );
-
-  const hostname = urlParsingNode.hostname.includes(":")
-    ? `[${urlParsingNode.hostname}]`
-    : urlParsingNode.hostname;
-
-  return {
-    href: urlParsingNode.href,
-    protocol: urlParsingNode.protocol,
-    host: urlParsingNode.host,
-    search: urlParsingNode.search
-      ? urlParsingNode.search.replace(/^\?/, "")
-      : "",
-    hash: urlParsingNode.hash ? urlParsingNode.hash.replace(/^#/, "") : "",
-    hostname,
-    port: urlParsingNode.port,
-    pathname:
-      urlParsingNode.pathname.charAt(0) === "/"
-        ? urlParsingNode.pathname
-        : `/${urlParsingNode.pathname}`,
-  };
-}
-
-/**
- * Parse a request URL and determine whether this is a same-origin request as the application
- * document.
- *
- * @param {import("./interface.js").ResolvableUrl} requestUrl The url of the request as a string that will be resolved
- * or a parsed URL object.
- * @returns {boolean} Whether the request is for the same origin as the application document.
- */
-export function urlIsSameOrigin(requestUrl) {
-  return urlsAreSameOrigin(requestUrl, originUrl);
-}
-
-/**
- * Parse a request URL and determine whether it is same-origin as the current document base URL.
- *
- * Note: The base URL is usually the same as the document location (`location.href`) but can
- * be overriden by using the `<base>` tag.
- *
- * @param {import("./interface.js").ResolvableUrl} requestUrl The url of the request as a string that will be resolved
- * or a parsed URL object.
- * @returns {boolean} Whether the URL is same-origin as the document base URL.
- */
-export function urlIsSameOriginAsBaseUrl(requestUrl) {
-  return urlsAreSameOrigin(requestUrl, document.baseURI);
-}
-
-/**
- * Create a function that can check a URL's origin against a list of allowed/trusted origins.
- * The current location's origin is implicitly trusted.
- *
- * @param {string[]} trustedOriginUrls - A list of URLs (strings), whose origins are trusted.
- *
- * @returns {(url: import("./interface.js").ResolvableUrl) => boolean } - A function that receives a URL (string or parsed URL object) and returns
- *     whether it is of an allowed origin.
- */
-export function urlIsAllowedOriginFactory(trustedOriginUrls) {
-  const parsedAllowedOriginUrls = [originUrl].concat(
-    trustedOriginUrls.map(urlResolve),
-  );
-
-  /**
-   * Check whether the specified URL (string or parsed URL object) has an origin that is allowed
-   * based on a list of trusted-origin URLs. The current location's origin is implicitly
-   * trusted.
-   *
-   * @param {import("./interface.js").ResolvableUrl} requestUrl - The URL to be checked (provided as a string that will be
-   *     resolved or a parsed URL object).
-   *
-   * @returns {boolean} - Whether the specified URL is of an allowed origin.
-   */
-  return function urlIsAllowedOrigin(requestUrl) {
-    const parsedUrl = urlResolve(requestUrl);
-    return parsedAllowedOriginUrls.some(
-      urlsAreSameOrigin.bind(null, parsedUrl),
-    );
-  };
-}
-
-/**
- * Determine if two URLs share the same origin.
- *
- * @param {import("./interface.js").ResolvableUrl} url1 - First URL to compare as a string or a normalized URL in the form of
- *     a dictionary object returned by `urlResolve()`.
- * @param {import("./interface.js").ResolvableUrl} url2 - Second URL to compare as a string or a normalized URL in the form
- *     of a dictionary object returned by `urlResolve()`.
- *
- * @returns {boolean} - True if both URLs have the same origin, and false otherwise.
- */
-export function urlsAreSameOrigin(url1, url2) {
-  url1 = urlResolve(url1);
-  url2 = urlResolve(url2);
-
-  return url1.protocol === url2.protocol && url1.host === url2.host;
-}
-
-/**
- * Removes a trailing hash ('#') from the given URL if it exists.
- *
- * @param {string} url
- * @returns {string}
- */
-export function trimEmptyHash(url) {
-  return url.replace(/#$/, "");
-}