@converse/skeletor 0.0.8 → 1.0.0

package/src/element.js

@@ -1,188 +0,0 @@
-import extend from "lodash-es/extend.js";
-import isElement from "lodash-es/isElement.js";
-import isFunction from "lodash-es/isFunction.js";
-import pick from "lodash-es/pick.js";
-import result from "lodash-es/result.js";
-import uniqueId from "lodash-es/uniqueId.js";
-import { Events } from './events.js';
-import { inherits, NotImplementedError } from './helpers.js';
-import { render } from 'lit-html';
-
-
-const paddedLt = /^\s*</;
-
-// Caches a local reference to `Element.prototype` for faster access.
-const ElementProto = (typeof Element !== 'undefined' && Element.prototype) || {};
-
-// Cached regex to split keys for `delegate`.
-const delegateEventSplitter = /^(\S+)\s*(.*)$/;
-
-// List of view options to be set as properties.
-const viewOptions = ['model', 'collection', 'events'];
-
-
-export class ElementView extends HTMLElement {
-
-  events = {}
-
-  constructor(options) {
-    super();
-    // Creating a View creates its initial element outside of the DOM,
-    // if an existing element is not provided...
-    this.cid = uniqueId('view');
-    this._domEvents = [];
-    extend(this, pick(options, viewOptions));
-  }
-
-  createRenderRoot () {
-    // Render without the shadow DOM
-    return this;
-  }
-
-  connectedCallback () {
-    if (!this._initialized) {
-      this.preinitialize.apply(this, arguments);
-      this.initialize.apply(this, arguments);
-      this._initialized = true;
-    }
-    this.delegateEvents();
-  }
-
-  disconnectedCallback () {
-    this.undelegateEvents();
-    this.stopListening();
-  }
-
-  // preinitialize is an empty function by default. You can override it with a function
-  // or object.  preinitialize will run before any instantiation logic is run in the View
-  preinitialize () {  // eslint-disable-line class-methods-use-this
-  }
-
-  // Initialize is an empty function by default. Override it with your own
-  // initialization logic.
-  initialize() {}  // eslint-disable-line class-methods-use-this
-
-  // **render** is the core function that your view should override, in order
-  // to populate its element (`this.el`), with the appropriate HTML. The
-  // convention is for **render** to always return `this`.
-  render() {
-    isFunction(this.beforeRender) && this.beforeRender();
-    isFunction(this.toHTML) && render(this.toHTML(), this);
-    isFunction(this.afterRender) && this.afterRender();
-    return this;
-  }
-
-  // Set callbacks, where `this.events` is a hash of
-  //
-  // *{"event selector": "callback"}*
-  //
-  //     {
-  //       'mousedown .title':  'edit',
-  //       'click .button':     'save',
-  //       'click .open':       function(e) { ... }
-  //     }
-  //
-  // pairs. Callbacks will be bound to the view, with `this` set properly.
-  // Uses event delegation for efficiency.
-  // Omitting the selector binds the event to `this.el`.
-  delegateEvents() {
-    if (!this.events) {
-      return this;
-    }
-    this.undelegateEvents();
-    for (const key in this.events) {
-      let method = this.events[key];
-      if (!isFunction(method)) method = this[method];
-      if (!method) continue;
-      const match = key.match(delegateEventSplitter);
-      this.delegate(match[1], match[2], method.bind(this));
-    }
-    return this;
-  }
-
-  // Make a event delegation handler for the given `eventName` and `selector`
-  // and attach it to `this.el`.
-  // If selector is empty, the listener will be bound to `this.el`. If not, a
-  // new handler that will recursively traverse up the event target's DOM
-  // hierarchy looking for a node that matches the selector. If one is found,
-  // the event's `delegateTarget` property is set to it and the return the
-  // result of calling bound `listener` with the parameters given to the
-  // handler.
-  delegate(eventName, selector, listener) {
-    const root = this;
-    if (!root) {
-      return this;
-    }
-    if (typeof selector === 'function') {
-      listener = selector;
-      selector = null;
-    }
-    // Given that `focus` and `blur` events do not bubble, do not delegate these events
-    if (['focus', 'blur'].indexOf(eventName) !== -1) {
-      const els = this.querySelectorAll(selector);
-      for (let i = 0, len = els.length; i < len; i++) {
-        const item = els[i];
-        item.addEventListener(eventName, listener, false);
-        this._domEvents.push({el: item, eventName: eventName, handler: listener});
-      }
-      return listener;
-    }
-
-    const handler = selector ? function (e) {
-      let node = e.target || e.srcElement;
-      for (; node && node != root; node = node.parentNode) {
-        if (node.matches(selector)) {
-          e.delegateTarget = node;
-          listener(e);
-        }
-      }
-    } : listener;
-
-    this.addEventListener(eventName, handler, false);
-    this._domEvents.push({el: this, eventName: eventName, handler: handler, listener: listener, selector: selector});
-    return this;
-  }
-
-  // Clears all callbacks previously bound to the view by `delegateEvents`.
-  // You usually don't need to use this, but may wish to if you have multiple
-  // Backbone views attached to the same DOM element.
-  undelegateEvents() {
-    if (this) {
-      for (let i = 0, len = this._domEvents.length; i < len; i++) {
-        const item = this._domEvents[i];
-        item.el.removeEventListener(item.eventName, item.handler, false);
-      }
-      this._domEvents.length = 0;
-    }
-    return this;
-  }
-
-  // A finer-grained `undelegateEvents` for removing a single delegated event.
-  // `selector` and `listener` are both optional.
-  undelegate(eventName, selector, listener) {
-    if (typeof selector === 'function') {
-      listener = selector;
-      selector = null;
-    }
-    if (this) {
-      const handlers = this._domEvents.slice();
-      let i = handlers.length;
-      while (i--) {
-        const item = handlers[i];
-        const match = item.eventName === eventName &&
-            (listener ? item.listener === listener : true) &&
-            (selector ? item.selector === selector : true);
-
-        if (!match) {
-          continue;
-        }
-        item.el.removeEventListener(item.eventName, item.handler, false);
-        this._domEvents.splice(i, 1);
-      }
-    }
-    return this;
-  }
-}
-
-// Set up all inheritable **View** properties and methods.
-Object.assign(ElementView.prototype, Events);

package/src/events.js

@@ -1,328 +0,0 @@
-//     Backbone.js 1.4.0
-//     (c) 2010-2019 Jeremy Ashkenas and DocumentCloud
-//     Backbone may be freely distributed under the MIT license.
-
-// Events
-// ------
-
-// A module that can be mixed in to *any object* in order to provide it with
-// a custom event channel. You may bind a callback to an event with `on` or
-// remove with `off`; `trigger`-ing an event fires all callbacks in
-// succession.
-//
-//     let object = {};
-//     extend(object, Backbone.Events);
-//     object.on('expand', function(){ alert('expanded'); });
-//     object.trigger('expand');
-//
-
-import isEmpty from 'lodash-es/isEmpty.js';
-import keys from 'lodash-es/keys.js';
-import once from 'lodash-es/once.js';
-import uniqueId from 'lodash-es/uniqueId.js';
-
-export const Events = {};
-
-// Regular expression used to split event strings.
-const eventSplitter = /\s+/;
-
-// A private global variable to share between listeners and listenees.
-let _listening;
-
-// Iterates over the standard `event, callback` (as well as the fancy multiple
-// space-separated events `"change blur", callback` and jQuery-style event
-// maps `{event: callback}`).
-const eventsApi = function(iteratee, events, name, callback, opts) {
-  let i = 0, names;
-  if (name && typeof name === 'object') {
-    // Handle event maps.
-    if (callback !== undefined && 'context' in opts && opts.context === undefined) opts.context = callback;
-    for (names = keys(name); i < names.length ; i++) {
-      events = eventsApi(iteratee, events, names[i], name[names[i]], opts);
-    }
-  } else if (name && eventSplitter.test(name)) {
-    // Handle space-separated event names by delegating them individually.
-    for (names = name.split(eventSplitter); i < names.length; i++) {
-      events = iteratee(events, names[i], callback, opts);
-    }
-  } else {
-    // Finally, standard events.
-    events = iteratee(events, name, callback, opts);
-  }
-  return events;
-};
-
-// Bind an event to a `callback` function. Passing `"all"` will bind
-// the callback to all events fired.
-Events.on = function(name, callback, context) {
-  this._events = eventsApi(onApi, this._events || {}, name, callback, {
-    context: context,
-    ctx: this,
-    listening: _listening
-  });
-
-  if (_listening) {
-    const listeners = this._listeners || (this._listeners = {});
-    listeners[_listening.id] = _listening;
-    // Allow the listening to use a counter, instead of tracking
-    // callbacks for library interop
-    _listening.interop = false;
-  }
-
-  return this;
-};
-
-// Inversion-of-control versions of `on`. Tell *this* object to listen to
-// an event in another object... keeping track of what it's listening to
-// for easier unbinding later.
-Events.listenTo = function(obj, name, callback) {
-  if (!obj) return this;
-  const id = obj._listenId || (obj._listenId = uniqueId('l'));
-  const listeningTo = this._listeningTo || (this._listeningTo = {});
-  let listening = _listening = listeningTo[id];
-
-  // This object is not listening to any other events on `obj` yet.
-  // Setup the necessary references to track the listening callbacks.
-  if (!listening) {
-    this._listenId || (this._listenId = uniqueId('l'));
-    listening = _listening = listeningTo[id] = new Listening(this, obj);
-  }
-
-  // Bind callbacks on obj.
-  const error = tryCatchOn(obj, name, callback, this);
-  _listening = undefined;
-
-  if (error) throw error;
-  // If the target obj is not Backbone.Events, track events manually.
-  if (listening.interop) listening.on(name, callback);
-
-  return this;
-};
-
-// The reducing API that adds a callback to the `events` object.
-const onApi = function(events, name, callback, options) {
-  if (callback) {
-    const handlers = events[name] || (events[name] = []);
-    const context = options.context, ctx = options.ctx, listening = options.listening;
-    if (listening) listening.count++;
-
-    handlers.push({callback: callback, context: context, ctx: context || ctx, listening: listening});
-  }
-  return events;
-};
-
-// An try-catch guarded #on function, to prevent poisoning the global
-// `_listening` variable.
-const tryCatchOn = function(obj, name, callback, context) {
-  try {
-    obj.on(name, callback, context);
-  } catch (e) {
-    return e;
-  }
-};
-
-// Remove one or many callbacks. If `context` is null, removes all
-// callbacks with that function. If `callback` is null, removes all
-// callbacks for the event. If `name` is null, removes all bound
-// callbacks for all events.
-Events.off = function(name, callback, context) {
-  if (!this._events) return this;
-  this._events = eventsApi(offApi, this._events, name, callback, {
-    context: context,
-    listeners: this._listeners
-  });
-
-  return this;
-};
-
-// Tell this object to stop listening to either specific events ... or
-// to every object it's currently listening to.
-Events.stopListening = function(obj, name, callback) {
-  const listeningTo = this._listeningTo;
-  if (!listeningTo) return this;
-
-  const ids = obj ? [obj._listenId] : keys(listeningTo);
-  for (let i = 0; i < ids.length; i++) {
-    const listening = listeningTo[ids[i]];
-
-    // If listening doesn't exist, this object is not currently
-    // listening to obj. Break out early.
-    if (!listening) break;
-
-    listening.obj.off(name, callback, this);
-    if (listening.interop) listening.off(name, callback);
-  }
-  if (isEmpty(listeningTo)) this._listeningTo = undefined;
-
-  return this;
-};
-
-// The reducing API that removes a callback from the `events` object.
-const offApi = function(events, name, callback, options) {
-  if (!events) return;
-
-  const context = options.context, listeners = options.listeners;
-  let i = 0, names;
-
-  // Delete all event listeners and "drop" events.
-  if (!name && !context && !callback) {
-    for (names = keys(listeners); i < names.length; i++) {
-      listeners[names[i]].cleanup();
-    }
-    return;
-  }
-
-  names = name ? [name] : keys(events);
-  for (; i < names.length; i++) {
-    name = names[i];
-    const handlers = events[name];
-
-    // Bail out if there are no events stored.
-    if (!handlers) {
-      break;
-    }
-
-    // Find any remaining events.
-    const remaining = [];
-    for (let j = 0; j < handlers.length; j++) {
-      const handler = handlers[j];
-      if (
-        callback && callback !== handler.callback &&
-          callback !== handler.callback._callback ||
-            context && context !== handler.context
-      ) {
-        remaining.push(handler);
-      } else {
-        const listening = handler.listening;
-        if (listening) listening.off(name, callback);
-      }
-    }
-
-    // Replace events if there are any remaining.  Otherwise, clean up.
-    if (remaining.length) {
-      events[name] = remaining;
-    } else {
-      delete events[name];
-    }
-  }
-
-  return events;
-};
-
-// Bind an event to only be triggered a single time. After the first time
-// the callback is invoked, its listener will be removed. If multiple events
-// are passed in using the space-separated syntax, the handler will fire
-// once for each event, not once for a combination of all events.
-Events.once = function(name, callback, context) {
-  // Map the event into a `{event: once}` object.
-  const events = eventsApi(onceMap, {}, name, callback, this.off.bind(this));
-  if (typeof name === 'string' && (context === null || context === undefined)) callback = undefined;
-  return this.on(events, callback, context);
-};
-
-// Inversion-of-control versions of `once`.
-Events.listenToOnce = function(obj, name, callback) {
-  // Map the event into a `{event: once}` object.
-  const events = eventsApi(onceMap, {}, name, callback, this.stopListening.bind(this, obj));
-  return this.listenTo(obj, events);
-};
-
-// Reduces the event callbacks into a map of `{event: onceWrapper}`.
-// `offer` unbinds the `onceWrapper` after it has been called.
-const onceMap = function(map, name, callback, offer) {
-  if (callback) {
-    const _once = map[name] = once(function() {
-      offer(name, _once);
-      callback.apply(this, arguments);
-    });
-    _once._callback = callback;
-  }
-  return map;
-};
-
-// Trigger one or many events, firing all bound callbacks. Callbacks are
-// passed the same arguments as `trigger` is, apart from the event name
-// (unless you're listening on `"all"`, which will cause your callback to
-// receive the true name of the event as the first argument).
-Events.trigger = function(name) {
-  if (!this._events) return this;
-
-  const length = Math.max(0, arguments.length - 1);
-  const args = Array(length);
-  for (let i = 0; i < length; i++) args[i] = arguments[i + 1];
-
-  eventsApi(triggerApi, this._events, name, undefined, args);
-  return this;
-};
-
-// Handles triggering the appropriate event callbacks.
-const triggerApi = function(objEvents, name, callback, args) {
-  if (objEvents) {
-    const events = objEvents[name];
-    let allEvents = objEvents.all;
-    if (events && allEvents) allEvents = allEvents.slice();
-    if (events) triggerEvents(events, args);
-    if (allEvents) triggerEvents(allEvents, [name].concat(args));
-  }
-  return objEvents;
-};
-
-// A difficult-to-believe, but optimized internal dispatch function for
-// triggering events. Tries to keep the usual cases speedy (most internal
-// Backbone events have 3 arguments).
-const triggerEvents = function(events, args) {
-  let ev, i = -1;
-  const l = events.length,
-    a1 = args[0],
-    a2 = args[1],
-    a3 = args[2];
-  switch (args.length) {
-    case 0: while (++i < l) (ev = events[i]).callback.call(ev.ctx); return;
-    case 1: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1); return;
-    case 2: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1, a2); return;
-    case 3: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1, a2, a3); return;
-    default: while (++i < l) (ev = events[i]).callback.apply(ev.ctx, args); return;
-  }
-};
-
-// A listening class that tracks and cleans up memory bindings
-// when all callbacks have been offed.
-const Listening = function(listener, obj) {
-  this.id = listener._listenId;
-  this.listener = listener;
-  this.obj = obj;
-  this.interop = true;
-  this.count = 0;
-  this._events = undefined;
-};
-
-Listening.prototype.on = Events.on;
-
-// Offs a callback (or several).
-// Uses an optimized counter if the listenee uses Backbone.Events.
-// Otherwise, falls back to manual tracking to support events
-// library interop.
-Listening.prototype.off = function(name, callback) {
-  let cleanup;
-  if (this.interop) {
-    this._events = eventsApi(offApi, this._events, name, callback, {
-      context: undefined,
-      listeners: undefined
-    });
-    cleanup = !this._events;
-  } else {
-    this.count--;
-    cleanup = this.count === 0;
-  }
-  if (cleanup) this.cleanup();
-};
-
-// Cleans up memory bindings between the listener and the listenee.
-Listening.prototype.cleanup = function() {
-  delete this.listener._listeningTo[this.obj._listenId];
-  if (!this.interop) delete this.obj._listeners[this.id];
-};
-
-// Aliases for backwards compatibility.
-Events.bind   = Events.on;
-Events.unbind = Events.off;

package/src/helpers.js

@@ -1,167 +0,0 @@
-//     (c) 2010-2019 Jeremy Ashkenas and DocumentCloud
-
-import create from 'lodash-es/create.js';
-import extend from 'lodash-es/extend.js';
-import has from 'lodash-es/has.js';
-import result from 'lodash-es/result.js';
-
-/**
- * Custom error for indicating timeouts
- * @namespace _converse
- */
-export class NotImplementedError extends Error {}
-
-function S4() {
-    // Generate four random hex digits.
-    return (((1+Math.random())*0x10000)|0).toString(16).substring(1);
-}
-
-export function guid() {
-    // Generate a pseudo-GUID by concatenating random hexadecimal.
-    return (S4()+S4()+"-"+S4()+"-"+S4()+"-"+S4()+"-"+S4()+S4()+S4());
-}
-
-// Helpers
-// -------
-
-// Helper function to correctly set up the prototype chain for subclasses.
-// Similar to `goog.inherits`, but uses a hash of prototype properties and
-// class properties to be extended.
-//
-export function inherits(protoProps, staticProps) {
-    const parent = this;
-    let child;
-
-    // The constructor function for the new subclass is either defined by you
-    // (the "constructor" property in your `extend` definition), or defaulted
-    // by us to simply call the parent constructor.
-    if (protoProps && has(protoProps, 'constructor')) {
-        child = protoProps.constructor;
-    } else {
-        child = function(){ return parent.apply(this, arguments); };
-    }
-
-    // Add static properties to the constructor function, if supplied.
-    extend(child, parent, staticProps);
-
-    // Set the prototype chain to inherit from `parent`, without calling
-    // `parent`'s constructor function and add the prototype properties.
-    child.prototype = create(parent.prototype, protoProps);
-    child.prototype.constructor = child;
-
-    // Set a convenience property in case the parent's prototype is needed
-    // later.
-    child.__super__ = parent.prototype;
-
-    return child;
-}
-
-
-export function getResolveablePromise () {
-    const wrapper = {
-        isResolved: false,
-        isPending: true,
-        isRejected: false
-    };
-    const promise = new Promise((resolve, reject) => {
-        wrapper.resolve = resolve;
-        wrapper.reject = reject;
-    })
-    Object.assign(promise, wrapper);
-    promise.then(
-        function (v) {
-            promise.isResolved = true;
-            promise.isPending = false;
-            promise.isRejected = false;
-            return v;
-        },
-        function (e) {
-            promise.isResolved = false;
-            promise.isPending = false;
-            promise.isRejected = true;
-            throw (e);
-        }
-    );
-    return promise;
-}
-
-
-// Throw an error when a URL is needed, and none is supplied.
-export function urlError() {
-    throw new Error('A "url" property or function must be specified');
-}
-
-// Wrap an optional error callback with a fallback error event.
-export function wrapError(model, options) {
-    const error = options.error;
-    options.error = function(resp) {
-        if (error) error.call(options.context, model, resp, options);
-        model.trigger('error', model, resp, options);
-    };
-}
-
-// Map from CRUD to HTTP for our default `sync` implementation.
-const methodMap = {
-    create: 'POST',
-    update: 'PUT',
-    patch: 'PATCH',
-    delete: 'DELETE',
-    read: 'GET'
-};
-
-export function getSyncMethod(model) {
-    const store = result(model, 'browserStorage') || result(model.collection, 'browserStorage');
-    return store ? store.sync() : sync;
-}
-
-// sync
-// ----
-
-// Override this function to change the manner in which Backbone persists
-// models to the server. You will be passed the type of request, and the
-// model in question. By default, makes a RESTful Ajax request
-// to the model's `url()`. Some possible customizations could be:
-//
-// * Use `setTimeout` to batch rapid-fire updates into a single request.
-// * Send up the models as XML instead of JSON.
-// * Persist models via WebSockets instead of Ajax.
-//
-export function sync(method, model, options={}) {
-    const type = methodMap[method];
-
-    // Default JSON-request options.
-    const params = {type: type, dataType: 'json'};
-
-    // Ensure that we have a URL.
-    if (!options.url) {
-        params.url = result(model, 'url') || urlError();
-    }
-
-    // Ensure that we have the appropriate request data.
-    if (options.data == null && model && (method === 'create' || method === 'update' || method === 'patch')) {
-        params.contentType = 'application/json';
-        params.data = JSON.stringify(options.attrs || model.toJSON(options));
-    }
-
-    // Don't process data on a non-GET request.
-    if (params.type !== 'GET') {
-        params.processData = false;
-    }
-
-    // Pass along `textStatus` and `errorThrown` from jQuery.
-    const error = options.error;
-    options.error = function(xhr, textStatus, errorThrown) {
-        options.textStatus = textStatus;
-        options.errorThrown = errorThrown;
-        if (error) error.call(options.context, xhr, textStatus, errorThrown);
-    };
-
-    // Make the request, allowing the user to override any Ajax options.
-    const xhr = options.xhr = ajax(extend(params, options));
-    model.trigger('request', model, xhr, options);
-    return xhr;
-}
-
-export function ajax() {
-    return fetch.apply(this, arguments);
-}