@angular-wave/angular.ts 0.9.4 → 0.9.6

package/src/router/transition/hook-registry.js

@@ -1,181 +0,0 @@
-import { removeFrom, tail, map } from "../../shared/common.js";
-import { isString, isFunction } from "../../shared/utils.js";
-import { Glob } from "../glob/glob.js";
-import { TransitionHookScope } from "./interface.js";
-/**
- * Determines if the given state matches the matchCriteria
- *
- * @internal
- *
- * @param state a State Object to test against
- * @param criterion
- * - If a string, matchState uses the string as a glob-matcher against the state name
- * - If an array (of strings), matchState uses each string in the array as a glob-matchers against the state name
- *   and returns a positive match if any of the globs match.
- * - If a function, matchState calls the function with the state and returns true if the function's result is truthy.
- * @returns {boolean}
- */
-export function matchState(state, criterion, transition) {
-  const toMatch = isString(criterion) ? [criterion] : criterion;
-  function matchGlobs(_state) {
-    const globStrings = toMatch;
-    for (let i = 0; i < globStrings.length; i++) {
-      const glob = new Glob(globStrings[i]);
-      if (
-        (glob && glob.matches(_state.name)) ||
-        (!glob && globStrings[i] === _state.name)
-      ) {
-        return true;
-      }
-    }
-    return false;
-  }
-  const matchFn = isFunction(toMatch) ? toMatch : matchGlobs;
-  return !!matchFn(state, transition);
-}
-/**
- * The registration data for a registered transition hook
- */
-export class RegisteredHook {
-  /**
-   * @param {import("./transition-service.js").TransitionProvider} tranSvc
-   * @param eventType
-   * @param callback
-   * @param matchCriteria
-   * @param removeHookFromRegistry
-   * @param options
-   */
-  constructor(
-    tranSvc,
-    eventType,
-    callback,
-    matchCriteria,
-    removeHookFromRegistry,
-    options = {},
-  ) {
-    /** @type {import("./transition-service.js").TransitionProvider} */
-    this.tranSvc = tranSvc;
-    this.eventType = eventType;
-    this.callback = callback;
-    this.matchCriteria = matchCriteria;
-    this.removeHookFromRegistry = removeHookFromRegistry;
-    this.invokeCount = 0;
-    this._deregistered = false;
-    this.priority = options.priority || 0;
-    this.bind = options.bind || null;
-    this.invokeLimit = options.invokeLimit;
-  }
-  /**
-   * Gets the matching [[PathNode]]s
-   *
-   * Given an array of [[PathNode]]s, and a [[HookMatchCriterion]], returns an array containing
-   * the [[PathNode]]s that the criteria matches, or `null` if there were no matching nodes.
-   *
-   * Returning `null` is significant to distinguish between the default
-   * "match-all criterion value" of `true` compared to a `() => true` function,
-   * when the nodes is an empty array.
-   *
-   * This is useful to allow a transition match criteria of `entering: true`
-   * to still match a transition, even when `entering === []`.  Contrast that
-   * with `entering: (state) => true` which only matches when a state is actually
-   * being entered.
-   */
-  _matchingNodes(nodes, criterion, transition) {
-    if (criterion === true) return nodes;
-    const matching = nodes.filter((node) =>
-      matchState(node.state, criterion, transition),
-    );
-    return matching.length ? matching : null;
-  }
-  /**
-   * Gets the default match criteria (all `true`)
-   *
-   * Returns an object which has all the criteria match paths as keys and `true` as values, i.e.:
-   *
-   * ```js
-   * {
-   *   to: true,
-   *   from: true,
-   *   entering: true,
-   *   exiting: true,
-   *   retained: true,
-   * }
-   */
-  _getDefaultMatchCriteria() {
-    return map(this.tranSvc._getPathTypes(), () => true);
-  }
-  /**
-   * Gets matching nodes as [[IMatchingNodes]]
-   *
-   * Create a IMatchingNodes object from the TransitionHookTypes that is roughly equivalent to:
-   *
-   * ```js
-   * let matches: IMatchingNodes = {
-   *   to:       _matchingNodes([tail(treeChanges.to)],   mc.to),
-   *   from:     _matchingNodes([tail(treeChanges.from)], mc.from),
-   *   exiting:  _matchingNodes(treeChanges.exiting,      mc.exiting),
-   *   retained: _matchingNodes(treeChanges.retained,     mc.retained),
-   *   entering: _matchingNodes(treeChanges.entering,     mc.entering),
-   * };
-   * ```
-   */
-  _getMatchingNodes(treeChanges, transition) {
-    const criteria = Object.assign(
-      this._getDefaultMatchCriteria(),
-      this.matchCriteria,
-    );
-    const paths = Object.values(this.tranSvc._getPathTypes());
-    return paths.reduce((mn, pathtype) => {
-      // STATE scope criteria matches against every node in the path.
-      // TRANSITION scope criteria matches against only the last node in the path
-      const isStateHook = pathtype.scope === TransitionHookScope.STATE;
-      const path = treeChanges[pathtype.name] || [];
-      const nodes = isStateHook ? path : [tail(path)];
-      mn[pathtype.name] = this._matchingNodes(
-        nodes,
-        criteria[pathtype.name],
-        transition,
-      );
-      return mn;
-    }, {});
-  }
-  /**
-   * Determines if this hook's [[matchCriteria]] match the given [[TreeChanges]]
-   *
-   * @returns an IMatchingNodes object, or null. If an IMatchingNodes object is returned, its values
-   * are the matching [[PathNode]]s for each [[HookMatchCriterion]] (to, from, exiting, retained, entering)
-   */
-  matches(treeChanges, transition) {
-    const matches = this._getMatchingNodes(treeChanges, transition);
-    // Check if all the criteria matched the TreeChanges object
-    const allMatched = Object.values(matches).every((x) => x);
-    return allMatched ? matches : null;
-  }
-  deregister() {
-    this.removeHookFromRegistry(this);
-    this._deregistered = true;
-  }
-}
-/** Return a registration function of the requested type. */
-export function makeEvent(registry, transitionService, eventType) {
-  // Create the object which holds the registered transition hooks.
-  const _registeredHooks = (registry._registeredHooks =
-    registry._registeredHooks || {});
-  const hooks = (_registeredHooks[eventType.name] = []);
-  const removeHookFn = (x) => removeFrom(hooks, x);
-  // Create hook registration function on the IHookRegistry for the event
-  registry[eventType.name] = hookRegistrationFn;
-  function hookRegistrationFn(matchObject, callback, options = {}) {
-    const registeredHook = new RegisteredHook(
-      transitionService,
-      eventType,
-      callback,
-      matchObject,
-      removeHookFn,
-      options,
-    );
-    hooks.push(registeredHook);
-    return registeredHook.deregister.bind(registeredHook);
-  }
-  return hookRegistrationFn;
-}

package/src/router/transition/interface.js

@@ -1,18 +0,0 @@
-/**
- * An object for Transition Hook Phases
- * @enum {number}
- * @readonly
- */
-export const TransitionHookPhase = {
-  CREATE: 0,
-  BEFORE: 1,
-  RUN: 2,
-  SUCCESS: 3,
-  ERROR: 4,
-};
-
-/** An object for Transition Hook Scopes */
-export const TransitionHookScope = {
-  TRANSITION: 0,
-  STATE: 1,
-};