@angular-wave/angular.ts 0.7.7 → 0.7.8

package/src/core/task-tracker-factory.js

@@ -1,145 +0,0 @@
-/** @typedef {import('../interface.ts').ServiceProvider} ServiceProvider */
-/** @typedef {import('../interface.ts').AnnotatedFactory} AnnotatedFactory */
-
-/**
- * @implements {ServiceProvider}
- */
-export class TaskTrackerFactoryProvider {
-  /** @type {AnnotatedFactory} */
-  $get = [
-    "$log",
-    /**
-     * Creates a new `TaskTracker` instance.
-     *
-     * @param {import('../services/log/interface.ts').LogService} log - The logging service.
-     * @returns {TaskTracker} A new `TaskTracker` instance.
-     */
-    (log) => new TaskTracker(log),
-  ];
-}
-
-/**
- * A factory function to create `TaskTracker` instances.
- *
- * A `TaskTracker` tracks pending tasks (grouped by type) and notifies interested
- * parties when all pending tasks (or tasks of a specific type) have been completed.
- */
-export class TaskTracker {
-  /**
-   * @param {import('../services/log/interface.ts').LogService} log - The logging service.
-   */
-  constructor(log) {
-    /** @private */
-    this.log = log;
-
-    /** @private */
-    this.taskCounts = {};
-
-    /** @private */
-    this.taskCallbacks = [];
-
-    /**
-     * Special task types used for tracking all tasks and default tasks.
-     * @type {string}
-     */
-    this.ALL_TASKS_TYPE = "$$all$$";
-
-    /**
-     * Default task type.
-     * @type {string}
-     */
-    this.DEFAULT_TASK_TYPE = "$$default$$";
-  }
-
-  /**
-   * Completes a task and decrements the associated task counter.
-   * If the counter reaches 0, all corresponding callbacks are executed.
-   *
-   * @param {Function} fn - The function to execute when completing the task.
-   * @param {string} [taskType=this.DEFAULT_TASK_TYPE] - The type of task being completed.
-   */
-  completeTask(fn, taskType = this.DEFAULT_TASK_TYPE) {
-    try {
-      fn();
-    } finally {
-      if (this.taskCounts[taskType]) {
-        this.taskCounts[taskType]--;
-        this.taskCounts[this.ALL_TASKS_TYPE]--;
-      }
-
-      const countForType = this.taskCounts[taskType];
-      const countForAll = this.taskCounts[this.ALL_TASKS_TYPE];
-
-      // If either the overall task queue or the specific task type queue is empty, run callbacks.
-      if (!countForAll || !countForType) {
-        const getNextCallback = !countForAll
-          ? this.getLastCallback.bind(this)
-          : () => this.getLastCallbackForType(taskType);
-
-        let nextCb;
-        while ((nextCb = getNextCallback())) {
-          try {
-            nextCb();
-          } catch (e) {
-            this.log.error(e);
-          }
-        }
-      }
-    }
-  }
-
-  /**
-   * Increments the task count for the specified task type.
-   *
-   * @param {string} [taskType=this.DEFAULT_TASK_TYPE] - The type of task whose count will be increased.
-   */
-  incTaskCount(taskType = this.DEFAULT_TASK_TYPE) {
-    this.taskCounts[taskType] = (this.taskCounts[taskType] || 0) + 1;
-    this.taskCounts[this.ALL_TASKS_TYPE] =
-      (this.taskCounts[this.ALL_TASKS_TYPE] || 0) + 1;
-  }
-
-  /**
-   * Registers a callback to be executed when all pending tasks of the specified type are completed.
-   * If there are no pending tasks of the specified type, the callback is executed immediately.
-   *
-   * @param {Function} callback - The function to execute when no pending tasks remain.
-   * @param {string} [taskType=this.ALL_TASKS_TYPE] - The type of tasks to wait for completion.
-   */
-  notifyWhenNoPendingTasks(callback, taskType = this.ALL_TASKS_TYPE) {
-    if (!this.taskCounts[taskType]) {
-      callback();
-    } else {
-      this.taskCallbacks.push({ type: taskType, cb: callback });
-    }
-  }
-
-  /**
-   * Retrieves and removes the last registered callback from the queue.
-   *
-   * @private
-   * @returns {Function|undefined} The last callback function or undefined if none exist.
-   */
-  getLastCallback() {
-    const cbInfo = this.taskCallbacks.pop();
-    return cbInfo ? cbInfo.cb : undefined;
-  }
-
-  /**
-   * Retrieves and removes the last registered callback for the specified task type.
-   *
-   * @private
-   * @param {string} taskType - The type of task for which the callback was registered.
-   * @returns {Function|undefined} The last callback function for the task type, or undefined if none exist.
-   */
-  getLastCallbackForType(taskType) {
-    for (let i = this.taskCallbacks.length - 1; i >= 0; --i) {
-      const cbInfo = this.taskCallbacks[i];
-      if (cbInfo.type === taskType) {
-        this.taskCallbacks.splice(i, 1);
-        return cbInfo.cb;
-      }
-    }
-    return undefined;
-  }
-}

package/src/services/browser.js

@@ -1,212 +0,0 @@
-import { urlResolve } from "../core/url-utils/url-utils.js";
-import { equals } from "../shared/utils.js";
-
-/**
- * Removes a trailing hash ('#') from the given URL if it exists.
- *
- * @param {string} url
- * @returns {string}
- */
-export function trimEmptyHash(url) {
-  return url.replace(/#$/, "");
-}
-
-/**
- * @typedef {function(string, string|null): any} UrlChangeListener
- */
-
-/**
- * This object has two goals:
- *
- * - hide all the global state in the browser caused by the window object
- * - abstract away all the browser specific features and inconsistencies
- */
-export class Browser {
-  /**
-   * @param {import('../core/task-tracker-factory.js').TaskTracker} taskTracker
-   */
-  constructor(taskTracker) {
-    /**
-     * @type {import('../core/task-tracker-factory.js').TaskTracker} taskTracker
-     */
-    this.taskTracker = taskTracker;
-    this.pendingDeferIds = {};
-    /** @type {Array<UrlChangeListener>} */
-    this.urlChangeListeners = [];
-    this.urlChangeInit = false;
-
-    /** @type {any} */
-    this.cachedState = null;
-    /** @type {any} */
-    this.lastHistoryState = null;
-    /** @type {string} */
-    this.lastBrowserUrl = window.location.href;
-    /** @type {HTMLBaseElement | null} */
-    this.baseElement = document.querySelector("base");
-
-    // Task-tracking API
-    this.$$completeOutstandingRequest =
-      this.taskTracker.completeTask.bind(taskTracker);
-    this.$$incOutstandingRequestCount =
-      this.taskTracker.incTaskCount.bind(taskTracker);
-    this.notifyWhenNoOutstandingRequests =
-      this.taskTracker.notifyWhenNoPendingTasks.bind(taskTracker);
-
-    this.cacheState();
-  }
-
-  /// ///////////////////////////////////////////////////////////
-  // URL API
-  /// ///////////////////////////////////////////////////////////
-
-  url(url, state) {
-    if (state === undefined) {
-      state = null;
-    }
-
-    // setter
-    if (url) {
-      url = urlResolve(url).href;
-
-      if (this.lastBrowserUrl === url && this.lastHistoryState === state) {
-        return this;
-      }
-
-      this.lastBrowserUrl = url;
-      this.lastHistoryState = state;
-      history.pushState(state, "", url);
-      this.cacheState();
-      return this;
-    }
-
-    // getter
-    return trimEmptyHash(window.location.href);
-  }
-
-  /**
-   * Returns the cached state.
-   *
-   * @returns {any} The cached state.
-   */
-  state() {
-    return this.cachedState;
-  }
-
-  /**
-   * Caches the current state and fires the URL change event.
-   *
-   * @private
-   */
-  cacheStateAndFireUrlChange() {
-    this.fireStateOrUrlChange();
-  }
-
-  /**
-   * Caches the current state.
-   *
-   * @private
-   */
-  cacheState() {
-    const currentState = history.state ?? null;
-    if (!equals(currentState, this.lastCachedState)) {
-      this.cachedState = currentState;
-      this.lastCachedState = currentState;
-      this.lastHistoryState = currentState;
-    }
-  }
-
-  /**
-   * Fires the state or URL change event.
-   *
-   * @private
-   */
-  fireStateOrUrlChange() {
-    const prevLastHistoryState = this.lastHistoryState;
-    this.cacheState();
-
-    if (
-      this.lastBrowserUrl === this.url() &&
-      prevLastHistoryState === this.cachedState
-    ) {
-      return;
-    }
-
-    this.lastBrowserUrl = /** @type {string} */ (this.url());
-    this.lastHistoryState = this.cachedState;
-    this.urlChangeListeners.forEach((listener) => {
-      listener(trimEmptyHash(window.location.href), this.cachedState);
-    });
-  }
-
-  /**
-   * Registers a callback to be called when the URL changes.
-   *
-   * @param {UrlChangeListener} callback - The callback function to register.
-   * @returns {UrlChangeListener} The registered callback function.
-   */
-  onUrlChange(callback) {
-    if (!this.urlChangeInit) {
-      window.addEventListener(
-        "popstate",
-        this.cacheStateAndFireUrlChange.bind(this),
-      );
-      window.addEventListener(
-        "hashchange",
-        this.cacheStateAndFireUrlChange.bind(this),
-      );
-
-      this.urlChangeInit = true;
-    }
-
-    this.urlChangeListeners.push(callback);
-    return callback;
-  }
-
-  $$applicationDestroyed() {
-    window.removeEventListener(
-      "popstate",
-      this.cacheStateAndFireUrlChange.bind(this),
-    );
-    window.removeEventListener(
-      "hashchange",
-      this.cacheStateAndFireUrlChange.bind(this),
-    );
-  }
-
-  $$checkUrlChange() {
-    this.fireStateOrUrlChange();
-  }
-
-  /// ///////////////////////////////////////////////////////////
-  // Misc API
-  /// ///////////////////////////////////////////////////////////
-
-  /**
-   * Returns the base href of the document.
-   *
-   * @returns {string} The base href.
-   */
-  baseHref() {
-    const href = this.baseElement?.getAttribute("href");
-    return href ? href.replace(/^(https?:)?\/\/[^/]*/, "") : "";
-  }
-}
-
-/**
- * This object has two goals:
- *
- * - hide all the global state in the browser caused by the window object
- * - abstract away all the browser specific features and inconsistencies
- *
- * Remove this in the future
- */
-export class BrowserProvider {
-  $get = [
-    "$$taskTrackerFactory",
-    /**
-     * @param {import('../core/task-tracker-factory.js').TaskTracker} $$taskTrackerFactory
-     * @returns {Browser}
-     */
-    ($$taskTrackerFactory) => new Browser($$taskTrackerFactory),
-  ];
-}