solarite 0.2.0 → 0.2.2

package/docs/js/util/Input.js

@@ -1,253 +0,0 @@
-import Html from "./Html.js";
-
-
-var keys = {
-	specialKeys: {
-		8: "backspace", 9: "tab", 10: "return", 13: "return", 16: "shift", 17: "ctrl", 18: "alt", 19: "pause",
-		20: "capslock", 27: "esc", 32: "space", 33: "pageup", 34: "pagedown", 35: "end", 36: "home",
-		37: "left", 38: "up", 39: "right", 40: "down", 45: "insert", 46: "del", 59: ";", 61: "=",
-		96: "0", 97: "1", 98: "2", 99: "3", 100: "4", 101: "5", 102: "6", 103: "7",
-		104: "8", 105: "9", 106: "*", 107: "+", 109: "-", 110: ".", 111 : "/",
-		112: "f1", 113: "f2", 114: "f3", 115: "f4", 116: "f5", 117: "f6", 118: "f7", 119: "f8",
-		120: "f9", 121: "f10", 122: "f11", 123: "f12", 144: "numlock", 145: "scroll", 173: "-", 186: ";", 187: "=",
-		188: ",", 189: "-", 190: ".", 191: "/", 192: "`", 219: "[", 220: "\\", 221: "]", 222: "'"
-	},
-	shiftNums: {
-		"`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%", "6": "^", "7": "&",
-		"8": "*", "9": "(", "0": ")", "-": "_", "=": "+", ";": ": ", "'": "\"", ",": "<",
-		".": ">",  "/": "?",  "\\": "|"
-	},
-
-	nonEditing: ['ctrl', 'alt', 'shift', 'capslock', 'numlock', 'esc',
-		'up', 'down', 'left', 'right', 'home', 'end', 'insert', 'pageup', 'pagedown', 'scroll', 'pause',
-		'f1', 'f2', 'f3', 'f4', 'f5', 'f6', 'f7', 'f8', 'f9', 'f10', 'f11', 'f12',
-		'f13', 'f14', 'f15', 'f16', 'f17', 'f18', 'f19', 'f20', 'f21', 'f22', 'f23', 'f24']
-};
-
-var Input = {
-
-	/**
-	 * Write the text to the clipboard.
-	 * @param text {string} */
-	copyText(text) {
-		let input = document.createElement('textarea');
-		input.style.width = 0;
-		input.innerHTML = text;
-		document.body.appendChild(input);
-		input.select();
-		let result = document.execCommand('copy');
-		document.body.removeChild(input);
-		return result;
-	},
-
-	/**
-	 * Force the element to have focus so it can receive keyboard and paste events.
-	 * calling .focus() on it isn't enough.
-	 * @param el {HTMLElement} Must have a tabindex property. */
-	forceFocus(el) {
-		let input = el.ownerDocument.createElement('input');
-		input.style.height = '0';
-		input.style.width = '0';
-		el.append(input);
-		input.focus();
-		el.focus();
-		input.remove()
-	},
-
-
-	/**
-	 * Is the KeyboardEvent something that will produce text input?
-	 * @param e {KeyboardEvent}
-	 * @return {boolean} */
-	isInput(e) {
-		if (e.ctrlKey || e.altKey || e.metaKey) // we allow shift b/c it's for capital letters.
-			return false;
-
-		return !this.isKey(e, keys.nonEditing) && e.key?.length === 1; // Filter out other keys like 'MediaPlay'
-	},
-
-	/**
-	 * @example Hotkey.is(e, ['ctrl+y', 'ctrl+z']); // returns true if it's one of these events.
-	 * @param e {KeyboardEvent}
-	 * @param types {string|string[]}
-	 * @param ignoreModifierKeys {boolean=false}
-	 * @return {boolean} */
-	isKey(e, types, ignoreModifierKeys) {
-		//#IFDEV
-		if (!types)
-			throw new Error('Missing types argument');
-		//#ENDIF
-		if (!Array.isArray(types))
-			types = [types];
-
-		var special = keys.specialKeys[e.keyCode],
-			character = String.fromCharCode(e.which).toLowerCase(),
-			modif = '', possible = {};
-
-		for (let specialKey of [ "alt", "ctrl", "meta", "shift" ]) {
-			if (e[specialKey + 'Key'] && special !== specialKey)
-				modif += specialKey + '+';
-		}
-		modif = modif.replace('alt+ctrl+meta+shift', 'hyper');
-		if (special) {
-			possible[ modif + special ] = true;
-			if (special === 'return')
-				possible[modif + 'enter'] = true;
-			if (ignoreModifierKeys) {
-				possible[special] = true;
-				if (special === 'return')
-					possible['enter'] = true;
-			}
-		}
-
-		if (character) {
-			possible[modif + character] = true;
-			if (ignoreModifierKeys)
-				possible[character] = true;
-			possible[modif + keys.shiftNums[character]] = true;
-			if (ignoreModifierKeys)
-				possible[ keys.shiftNums[character]] = true;
-
-			// "$" can be triggered as "Shift+4" or "Shift+$" or just "$"
-			if (modif === 'shift+')
-				possible[ keys.shiftNums[character]] = true;
-		}
-		for (var i=0, l=types.length; i<l; i++)
-			if (possible[types[i]])
-				return true;
-
-		return false;
-	},
-
-	/**
-	 * @deprecated for Util.on()
-	 * Add a filtered event listener and return a function to remove that listener.
-	 * Supports {once: true} as an option.
-	 * Then move this outside of Input?
-	 * @param div {HTMLElement}
-	 * @param type {string}
-	 * @param key {null|string|function(Event)}
-	 *     If a string and a KeyboardEvent, only if the event matches this key.
-	 *     If a function, only if the function returns true when called with an event of any type.
-	 * @param callback {function(Event)|Object|boolean}
-	 * @param options {Object|boolean=}  Can include {once: true}
-	 * @return {function} Call this function to unbind. */
-	on(div, type, key=null, callback, options) {
-
-		// We handle "once" ourselves.
-		let once = options?.once;
-		if (once)
-			delete options.once;
-
-		let internalCallback = e => {
-			if (!key || (e instanceof KeyboardEvent && e.key === key || Input.isKey(e, key)) || (typeof key === 'function' && key(e))) {
-				callback(e);
-				if (once)
-					div.removeEventListener(type, internalCallback, options);
-			}
-		};
-		div.addEventListener(type, internalCallback, options);
-
-		return () => div.removeEventListener(type, internalCallback, options);
-	},
-
-	/**
-	 * Restrict each typed letter to the pattern Regex.
-	 * Also see Input.pasteAsPlainText() which is often used along with this function.
-	 * @param {KeyboardEvent|Node} event
-	 * @param {RegExp} allowed
-	 * @example
-	 * <input onkeydown="Input.limitKeys(event, /[A-Za-z_0-9]/)"> */
-	limitKeys(event, allowed) {
-		if (event instanceof Node)
-			event.addEventListener('keydown', e=>Input.limitKeys(e, allowed));
-		else {
-			// Allow ctrl+a, ctrl+c, etc.
-			if (event.ctrlKey)
-				return true;
-
-
-			// Always allow keycodes that don't insert characters
-			var k = event.keyCode;
-
-			// Allow keys that don't add a character:
-			// all keycodes listed here:  https://github.com/wesbos/keycodes/blob/gh-pages/scripts.js
-			if ((k < 48 && ![9, 12, 13, 32].includes(k)) || // all of the lower keycodes except tab, enter, space
-				[91, 92, 93, 95,].includes(k) ||		    // left windows/⌘ key, right windows key, windows menu, sleep
-				(112 <= k && k <= 151) ||					// F1-F32, numlock, scroll-lock, airplane mode
-				[166, 167, 168, 169].includes(k) ||		    // page back, page forward, refresh
-				(172 <= k && k <= 183) ||					// home key, media keys
-				[224, 230, 233, 234, 251, 255].includes(k)  // ⌘ key firefox, gnome compose key, XF86 Forwared, XF86 Back, unlock trackpad, toggle touchpad.
-			)
-				return true;
-
-			//console.log(String.fromCharCode(event.keyCode));
-			// We use event.key because String.fromCharCode(event.keyCode) will return '4' for '$' and other keys entered through modifiers.
-			let key = event.key;
-			if (key === 'Enter') // Why does "Enter" appear as text instead of the literal '\n' ?
-				key = '\n';
-			if (!allowed.test(key)) {
-				event.preventDefault();
-				return false;
-			}
-
-			return true;
-		}
-	},
-
-	/**
-	 * Also see Input.limitKeys() which is often used along with this function.
-	 *
-	 * @param item {ClipboardEvent|Event|Node} If a node, a paste event listener will be assigned to it.
-	 * Otherwise, insert clipboard data from the paste event to the element that has focus.
-	 * @param allowLn
-	 * @param allowed {?RegExp} If set, only allow characters that match this regex.  Must be a global /g regex.
-	 *
-	 * @example
-	 * <div contenteditable onpaste="Input.pasteAsPlainText(event)">
-	 *
-	 * @example
-	 * Input.pasteAsPlainText(document.getElementById('notes')); */
-	pasteAsPlainText(item, allowLn=true, allowed=null) {
-		if (item instanceof Node)
-			item.addEventListener('paste', e=> Input.pasteAsPlainText(e, allowLn));
-
-		else {
-			let event = item;
-			event.preventDefault();
-			let text = (event.originalEvent || event).clipboardData.getData('text/plain');
-			text = Html.encode(text);
-			if (allowed) {
-				let copy = '';
-				text.replaceAll(allowed, match => {
-					copy += match
-				});
-				text = copy;
-			}
-
-			if (allowLn)
-				text = text.replace(/\r?\n/g, '<br>');
-
-			// The target element already has focus, so the command puts the text there.
-			document.execCommand("insertHTML", false, text);
-			return false;
-		}
-	},
-
-	/**
-	 * Select all the text in an element.
-	 * @param el {HTMLElement|HTMLInputElement} */
-	selectAll(el) {
-		if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA')
-			el.select();
-		else {
-			let range = document.createRange();
-			range.selectNodeContents(el);
-			let sel = window.getSelection();
-			sel.removeAllRanges();
-			sel.addRange(range);
-		}
-	}
-};
-
-export default Input;

package/docs/js/util/Util.js

@@ -1,88 +0,0 @@
-
-
- 
- /**
- * @typedef {Array|function(...*)} Callbacks
- * @property {function(function)} push
- * @property {function()} remove
- * @property {function()} pause
- * @property {function()} resume
- * */
-
-
-/**
- * A place for functions that have no other home. */
-var Util = {
-
-	/**
-	 * Create an array-like object that stores a group of callbacks.
-	 * Supports all array functions and properties like push() and .length.
-	 * Can be called directly.
-	 *
-	 * @param functions {function[]}
-	 * @return {Callbacks|function}
-	 *
-	 * @example
-	 * var c = Util.callback();
-	 * var f = () => console.log(3);
-	 * c.push(f);
-	 * c();
-	 * c.remove(f);
-	 * c();
-	 */
-	callback(...functions) {
-		var paused = false;
-
-		// Make it callable.  When we call it, call all callbacks() with the given args.
-		let result = async function(...args) {
-			let result2 = [];
-			if (!paused)
-				for (let i=0; i<result.length; i++)
-					result2.push(result[i](...args));
-			return await Promise.all(result2);
-		};
-		
-		// Make it iterable.
-		result[Symbol.iterator] = function() {
-			let index = 0;
-			return {
-				next: () => index < result.length
-					 ? {value: result[index++], done: false}
-					 : {done: true}
-			};
-		};
-
-		// Use properties from Array
-		for (let prop of Object.getOwnPropertyNames(Array.prototype))
-			if (prop !== 'length' && prop !== 'constructor')
-				result[prop] = Array.prototype[prop];
-
-		result.l = 0; // Internal length
-		Object.defineProperty(result, 'length', {
-			get() { return result.l },
-			set(val) { result.l = val}
-		});
-
-		// Add the remove() function.
-		result.remove = func => {
-			let idx = result.findIndex(item => item === func);
-			if (idx !== -1)
-				result.splice(idx, 1);
-		};
-		result.pause = () => paused = true;
-
-		result.resume = () => paused = false;
-
-		// Add initial functions
-		for (let f of functions)
-			result.push(f);
-
-		return result;
-	},
-	
-
-
-};
-
-
-export default Util;

package/docs/js/util/delve.js

@@ -1,43 +0,0 @@
-/**
- * Follow a path into an object.
- * @param obj {object}
- * @param path {string[]}
- * @param createVal {*}  If set, non-existant paths will be created and value at path will be set to createVal.
- * @return {*} The value, or undefined if it can't be reached. */
-export default function delve(obj, path, createVal = delveDontCreate) {
-	let isCreate = createVal !== delveDontCreate;
-
-	let len = path.length;
-	if (!obj && !isCreate && len)
-		return undefined;
-
-	let i = 0;
-	for (let srcProp of path) {
-
-		// If the path is undefined and we're not to the end yet:
-		if (obj[srcProp] === undefined) {
-
-			// If the next index is an integer or integer string.
-			if (isCreate) {
-				if (i < len - 1) {
-					// If next level path is a number, create as an array
-					let isArray = (path[i + 1] + '').match(/^\d+$/);
-					obj[srcProp] = isArray ? [] : {};
-				}
-			} else
-				return undefined; // can't traverse
-		}
-
-		// If last item in path
-		if (isCreate && i === len - 1)
-			obj[srcProp] = createVal;
-
-		// Traverse deeper along destination object.
-		obj = obj[srcProp];
-		i++;
-	}
-
-	return obj;
-}
-
-let delveDontCreate = {};

package/docs/media/documentation.css

@@ -1,96 +0,0 @@
-@font-face {
-    font-family: "Cabin";
-    font-weight: 700;
-    src: url("cabin-latin-700.woff2") format("woff")
-}
-@font-face {
-    font-family: "Fira Code";
-    font-weight: 400;
-    src: url("FiraCode400.woff2") format("woff")
-}
-html[dark] {
-	/*--card-background: #0b0e12 !important;*/
-	--card-border: #1a1c1e !important;
-}
-html { background: var(--background) !important; font-size: 18px !important }
-body::before { content: ''; position: fixed; inset: 0;
-	opacity: .03; filter: grayscale(75%);
-	background: url('solarite-machine.webp') no-repeat -200px -200px / 140% auto ;  }
-
-.typora-export-show-outline .typora-export-content { margin: 0 !important }
-.typora-export-sidebar { position: relative; width: 200px !important; background: black; color: #a0a4a8; margin: 0 !important; font-size: 16px !important ; }
-
-[dark] .typora-export-sidebar { background: var(--shade2) }
-.typora-export-sidebar .outline-content { display: flex; flex-direction: column;
-	width: 200px !important; padding: 10px 10px 0 0 !important; overflow: visible !important }
-.typora-export-sidebar .outline-content > li { overflow-x: hidden; overflow-y: auto }
-
-
-.typora-export-sidebar .outline-content:before { content: ''; display: block; width: 210px; min-height: 210px;
-	background: url('solarite-machine.webp'); background-size: cover; margin-bottom: 10px; }
-.typora-export-sidebar .outline-expander { width: 0 }
-
-#write { max-width: 860px; margin: 0 !important; padding-left: 20px }
-#write h1 { font: 700 350% Cabin; line-height: 1; margin: 0; padding: 0; color: var(--invert);
-    border-bottom: 0 solid transparent; width: 140%; max-width: calc(100vw - 75px); }
-
-#write h2 { font-family: Cabin, sans-serif; font-size: 220%; line-height: 1; margin: 2em 0 .25em 0 }
-
-#write h3 { margin-top: 1.5em; margin-bottom: .3em; font-size: 140%; line-height: 1.1; font-family: Cabin, sans-serif }
-html:not([dark]) #write h3 { color: #678; }
-
-#write h4 { font-size: 105%; font-weight: bold; margin-top: .75em; margin-bottom: 0 }
-#write h5 { font-size: 100%; font-weight: bold; margin-top: .75em; margin-bottom: 0 }
-#write h6 { font-size: 100%; font-weight: normal; margin-top: .75em; margin-bottom: 0; text-decoration: underline }
-
-
-#write :is(p, h2, h3, h4, h5, h6, ol, ul) { max-width: 800px }
-#write p { text-align: justify }
-#write a, #write a:visited { color: #08c; text-decoration: none}
-#write a:hover { color: #08c; text-decoration: underline }
-#write ul { padding-left: 20px }
-#write code { display: inline-block; background: #e0e8ef; font: 11px 'Fira Code'; border-radius: 4px; padding: 2px 4px }
-[dark] #write code { background: #303336 }
-
-#write play-ground { width: calc(100vw - 260px); max-width: 1200px }
-
-#write code-editor[data-style="1"] .cm-scroller { font: 11px 'Fira Code' !important}
-
-body.typora-export { padding: 0 !important }
-
-:is(td, th):not(:first-of-type) { padding: 6px 8px 6px 0 }
-:is(td, th):not(:first-of-type) { padding-left: 5px }
-code { white-space: nowrap; border: none !important }
-
-.outline-h1 > .outline-item { color: white; font-size: 22px }
-.outline-h2 > .outline-item { color: white }
-
-
-table :is(th, td) {
-	border-color: var(--shade1) !important
-}
-table tr:nth-child(2n), thead {
-	background-color: transparent !important
-}
-
-
-@media screen and (width < 1085px) {
-	.typora-export-sidebar, .typora-export-sidebar .outline-content {
-		display: none
-	}
-	#write play-ground { width: calc(100vw - 60px) }
-}
-@media screen and (width < 768px) {
-	#write { padding: 10px !important }
-	#write play-ground { width: calc(100vw - 36px) }
-}
-
-@media screen and (width < 512px) {
-	body { font-size: 14px }
-	table :is(th, td) { padding: 2px 4px !important }
-	#write { padding: 6px !important }
-	table { font-size: 85% }
-	code { white-space: wrap }
-}
-
-