@barchart/common-js/dist/cjs/collections/Stack.js

Library of common JavaScript utilities

var __create = Object.create;
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __getProtoOf = Object.getPrototypeOf;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
  for (var name in all)
    __defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
  if (from && typeof from === "object" || typeof from === "function") {
    for (let key of __getOwnPropNames(from))
      if (!__hasOwnProp.call(to, key) && key !== except)
        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
  }
  return to;
};
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
  // If the importer is in node compatibility mode or this is not an ESM
  // file that has been converted to a CommonJS file using a Babel-
  // compatible transform (i.e. "__esModule" has not been set), then set
  // "default" to the CommonJS "module.exports" for node compatibility.
  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
  mod
));
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
var Stack_exports = {};
__export(Stack_exports, {
  default: () => Stack
});
module.exports = __toCommonJS(Stack_exports);
var assert = __toESM(require("./../lang/assert.js"));
class Stack {
  #array;
  constructor() {
    this.#array = [];
  }
  /**
   * Adds an item to the stack.
   *
   * @public
   * @param {object} item
   * @returns {object} - The item added to the stack.
   */
  push(item) {
    this.#array.push(item);
    return item;
  }
  /**
   * Removes and returns an item from the stack. Throws if the stack is empty.
   *
   * @public
   * @returns {object} - The removed from the stack.
   */
  pop() {
    if (this.empty()) {
      throw new Error("Stack is empty");
    }
    return this.#array.pop();
  }
  /**
   * Returns the next item in the stack (without removing it). Throws if the stack is empty.
   *
   * @public
   * @returns {object} - The item added to the stack.
   */
  peek() {
    if (this.empty()) {
      throw new Error("Stack is empty");
    }
    return this.#array[this.#array.length - 1];
  }
  /**
   * Returns true if the stack is empty; otherwise false.
   *
   * @public
   * @returns {boolean}
   */
  empty() {
    return this.#array.length === 0;
  }
  /**
   * Runs an action on each item in the stack.
   *
   * @public
   * @param {Function} action - The action to run.
   */
  scan(action) {
    assert.argumentIsRequired(action, "action", Function);
    for (let i = this.#array.length - 1; i >= 0; i--) {
      action(this.#array[i]);
    }
  }
  /**
   * Outputs an array of the stack's items; without affecting the
   * stack's internal state;
   *
   * @public
   * @returns {Array}
   */
  toArray() {
    return this.#array.slice(0).reverse();
  }
  /**
   * Returns a string representation.
   *
   * @public
   * @returns {string}
   */
  toString() {
    return "[Stack]";
  }
}

{
	const cjsExports = module.exports;
	const cjsDefaultExport = cjsExports && cjsExports.__esModule ? cjsExports.default : cjsExports;

	if (cjsDefaultExport && (typeof cjsDefaultExport === 'function' || typeof cjsDefaultExport === 'object')) {
		Object.keys(cjsExports).forEach((key) => {
			if (key !== 'default' && key !== '__esModule') {
				cjsDefaultExport[key] = cjsExports[key];
			}
		});
	}

	module.exports = cjsDefaultExport;
}