3f:null 40:["$","title",null,{"children":"utilities | Riley | Observable"}] 46:T7ba,{ await visibility(); const maxEach = 64; const wrap = document.createElement("div"); const bits = new Map(Object.entries({ red: html``, green: html``, blue: html`` })); const bitStore = new Map([...bits].map(([name, bit]) => [name, new Array(maxEach).fill().map(() => bit.cloneNode(Infinity))])); invalidation.then(() => { for (let [k, v] of bitStore) { for (let e of v) { e.parentNode && e.remove(); } v.length = 0; } bitStore.clear(); }); const form = Inputs.form(Object.fromEntries([...bits.keys()].map(name => [name, Inputs.range([1, maxEach], { label: `${name} count`, value: Math.floor(Math.random() * (maxEach - 1)) + 1, step: 1 })]))); const output = document.createElement("output"); output.style.display = "flex"; output.style.flexWrap = "wrap"; output.style.justifyContent = "space-between"; output.style.wordBreak = "break-all"; addHeading: { let heading = document.createElement("strong"); let name = document.createElement("code"); name.append(proportionalZip.name); heading.append("interactive demonstration of ", name); wrap.append(heading); } wrap.append(form, output); autoListener({ target: form, type: "input", passive: true, function: () => output.replaceChildren(...proportionalZip(... [...bitStore].map(([name, bits]) => bits.slice(0, form.value[name])) // [...bits].map(([name, bit]) => new Array(form.value[name]).fill().map(() => bit.cloneNode(Infinity))) )), invalidation }); form.dispatchEvent(new Event("input")); return wrap; }47:T6f2,## takeTag This function transforms other functions to be able to easily accept arguments from tagged template literals. If ${d11n.var`raw`} is truthy, then the strings passed into the function are the unescaped raw strings like in String.raw. When the transformed function is called regularly, all of the arguments are passed directly to the function provided as fun; when called as a tagged template literal, the arguments alternate between strings and the arguments among the strings. When the function is called as a tagged template literal, the first and last arguments are always strings, even if they are empty. The two convenience functions array and concat are properties of the main function. They are simply pre-configured results of the main function, so they can take in parameters as a tagged template or as a variable number of arguments. The raw property of each of these convenience functions is just the version of the corresponding function that reads input like String.raw. A property of the main function, detect is a convenience function that takes the same input as the other convenience functions; it returns whether the contents are from a tagged template (true) or not (false).48:T71a,takeTag = { function takeTag() { let raw, concat, fun; resolveOptions: { let opts; is.func(arguments[0]) ? ([fun, opts] = arguments) : ([opts, fun] = arguments); fun ??= (...contents) => contents; if (is.object(opts) && !is.boolean(opts)) { ({ raw = false, concat = false } = opts); } else { raw = Boolean(opts); concat = false; } } return Object.defineProperty(function (...contents) { if (takeTag.detect(...contents)) { let args = contents; let strings = raw ? contents[0].raw : contents[0]; let length = strings.length + args.length - 1; let out = []; for (let i = 0; i < length; i++) { out.push((i % 2) ? args[Math.floor(i/2) + 1] : strings[Math.floor(i/2)]); } contents = out; } else { contents = contents; } return concat ? fun(contents = contents.join("")) : fun(...contents); }, "name", { value: fun.name, enumerable: true }); } Object.defineProperties(takeTag, { detect: { value: (arr) => ( Array.isArray(arr) && Object.hasOwn(arr, "raw") && Array.isArray(arr) && arr.length == arr.raw.length ), enumerable: true }, array: { value: Object.defineProperty(takeTag({}, (...contents) => contents), "raw", { value: takeTag({raw: true}, (...contents) => contents), enumerable: true }), enumerable: true }, concat: { value: Object.defineProperty(takeTag({concat: true}, contents => contents), "raw", { value: takeTag({concat: true, raw: true}, contents => contents), enumerable: true }), enumerable: true } }); return takeTag; }49:T2031,

is

This object contains several attached functions for checking the types of input arguments. Primitives are treated the same as their object counterparts. The numeric functions accept an optional ${d11n.var("numOpts")} value as their second argument, allowing the checks and restrictions to be customised. Expand the following paragraph for a description of the properties that ${d11n.var("numOpts")} may have.

${d11n.var("numOpts")}

Any of these options may be used together, but all restrictions must pass for the function to return truthy.

${d11n.var("NaN")}: whether to allow ${d11n.prefab.NaN.code}
${d11n.var("infinity")}: whether to allow ${d11n.prefab["-Infinity"].code} and ${d11n.prefab.Infinity.code}
${d11n.var("int")}: whether to require (truthy) or exclude (falsy) an integers; If this is ${d11n.prefab.null.code} or ${d11n.prefab.undefined.code}, then there is no effect.
${d11n.var("min")}: minimum allowed value (inclusive)
${d11n.var("max")}: maximum allowed value (inclusive)
${d11n.var("greater")}: minimum allowed value (exclusive)
${d11n.var("less")}: maximum allowed value (exclusive)

functions

${d11n.var("is.a", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.a.name)}(${d11n.rich.params.span`instance, type`}): This checks whether ${d11n.var("instance")} is an instance of ${d11n.var("type")}. If ${d11n.var("type")} is strictly equal to the array class, then ${d11n.rich.built_in.span`Array`}.isArray is used. Otherwise, ${d11n.rich.keyword.code`instanceof`} is used. The parameter ${d11n.var("safe")} controls whether or not an error can be thrown. Leaving safe mode on ensures that errors return falsy values from the function.
${d11n.var("is.in", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.in.name)}(${d11n.rich.params.span`parent, property`}): This checks whether ${d11n.var("parent")} has the property ${d11n.var("property")} (string, symbol, or index) in itself or its prototype chain. If ${d11n.var("parent")} is not an object, then the function always returns falsy. Other than that case, this function is simply a wrapper for ${d11n.rich.keyword.code`in`}.
${d11n.var("is.in.box", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.in.box.name)}(${d11n.rich.params.span`parent, property`}): This is identical to its parent function, ${d11n.var("is.in")}, except that ${d11n.var("parent")} is first wrapped in an object if it is a primitive. This enables, for example, checking for ${d11n.rich.built_in.span`Symbol`}.iterator on a primitive string.
${d11n.var("is.own", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.own.name)}(${d11n.rich.params.span`parent, property`}): This checks whether ${d11n.var("parent")} has the property ${d11n.var("property")} (string, symbol, or index) in itself. If ${d11n.var("parent")} is not an object, then the function always returns falsy. Other than that case, this function is simply a wrapper for ${d11n.rich.built_in.span`Object`}.hasOwn.
${d11n.var("is.object", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.object.name)}(${d11n.rich.params.span`o`}): This checks whether ${d11n.var("o")} is an object, excluding ${d11n.prefab.null.code}.
${d11n.var("is.string", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.string.name)}(${d11n.rich.params.span`s`}): This checks whether ${d11n.var("s")} is a string, accepting the primitive or object forms.
${d11n.var("is.boolean", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.boolean.name)}(${d11n.rich.params.span`b`}): This checks whether ${d11n.var("b")} is a boolean, accepting the primitive or object forms.
${d11n.var("is.number", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.number.name)}(${d11n.rich.params.span`n, ?numOpts`}): This checks whether ${d11n.var("n")} is a number, accepting the primitive or object forms. By default, ${d11n.prefab.NaN.code} and both infinities are excluded. Various checks can be configured in ${d11n.var("numOpts")}.
${d11n.var("is.bigInt", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.bigInt.name)}(${d11n.rich.params.span`i, ?numOpts`}): This checks whether ${d11n.var("i")} is a big integer, accepting the primitive or object forms. Additional checks can be configured in ${d11n.var("numOpts")}.
${d11n.var("is.integer", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.integer.name)}(${d11n.rich.params.span`i, ?numOpts`}): This checks whether ${d11n.var("i")} is an integer. If ${d11n.var("i")} is a number as defined by ${d11n.var("is.number")}, then the primitive is passed into ${d11n.rich.built_in.span`Number`}.isInteger. Parameter ${d11n.var("i")} may also be a big integer as defined by ${d11n.var("is.bigInt")}. Whether ${d11n.var("is.number")} or ${d11n.var("is.bigInt")} is called, ${d11n.var("numOpts")} is passed in, allowing the checks and bounds to be customised.
${d11n.var("is.num", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.num.name)}(${d11n.rich.params.span`n, ?numOpts`}): This checks whether ${d11n.var("n")} is numeric. This is simply the combination of ${d11n.var("is.number")} and ${d11n.var("is.bigInt")}. For both ${d11n.var("is.number")} and ${d11n.var("is.bigInt")}, the parameter ${d11n.var("numOpts")} is passed in, allowing the checks and bounds to be customised.
${d11n.var("is.function", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.function.name)}(${d11n.rich.params.span`f`}): This checks whether ${d11n.var("f")} is a function, accepting the primitive or object forms.
${d11n.var("is.multi", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(is.multi.name)}(${d11n.rich.params.span`m`}): This checks whether ${d11n.var("m")} is a non-string iterable object. To be iterable, ${d11n.var("m")} must have a ${d11n.rich.built_in.span`Symbol`}.iterator property in itself or its prototype chain. The value of the property and the return value of the iterator function are not checked, as they are required by the specification. I have yet to encounter a case where the property is defined, but the object does not truly iterate.

4a:T112e,is = { const hasOwn = Object.hasOwn ? Object.hasOwn.bind(Object) : (prop => (parent, property) => prop.call(parent, property))(Object.prototype.hasOwnProperty); const is = { // Is `instance` an instance of `type`? a: function isInstanceOf(instance, type, safe = true) { if (!safe) { return type === Array ? Array.isArray(instance) : instance instanceof type; } try { return type === Array ? Array.isArray(instance) : instance instanceof type; } catch {} }, // Does `parent` have all of the properties `properties`, either in itself or its prototype chain? in: Object.defineProperty(function isIn(parent, ...properties) { if (!is.object(parent)) { return; } if (properties.length == 1) { return properties.shift() in parent; } for (let p of properties) { if (!(p in parent)) { return; } } return true; }, "box", { enumerable: true, value: function isInAutobox(parent, ...properties) { is.object(parent) || (parent = Object(parent)); if (properties.length == 1) { return properties.shift() in parent; } for (let p of properties) { if (!(p in parent)) { return; } } return true; } }), // Does `parent` have all of the properties `properties` itself? own: Object.defineProperty(function isOwn(parent, ...properties) { if (!is.object(parent)) { return; } if (properties.length == 1) { return hasOwn(parent, properties.shift()); } for (let p of properties) { if (!hasOwn(parent, p)) { return; } } return true; }, "box", { enumerable: true, value: function isOwnAutobox(parent, ...properties) { is.object(parent) || (parent = Object(parent)); if (properties.length == 1) { return hasOwn(parent, properties.shift()); } for (let p of properties) { if (!hasOwn(parent, p)) { return; } } return true; } }), // Is this an object? object: function isObject(o) { return o !== null && typeof o == "object"; }, // Is this a string? string: function isString(s) { return typeof s == "string" || s instanceof String; }, // Is this a boolean? boolean: function isBoolean(b) { return typeof b == "boolean" || b instanceof Boolean; }, // Is this a number? By default, NaN and the infinities are excluded. number: function isNumber(n, {"NaN": allowNaN, "infinity": allowInf, min = -Infinity, max = Infinity, less, greater, int, "Infinity": allowINF} = {}) { if (typeof n == "number" || n instanceof Number) { n = n.valueOf(); // debugger; return (allowNaN || !Number.isNaN(n)) && console.log("a") && ((allowInf ?? allowINF) || Number.isFinite(n)) && (int == undefined || (int ? Number.isInteger(n) : !Number.isInteger(n))) && ((min === -Infinity) || min <= n) && ((max === Infinity) || max >= n) && ((less == undefined) || less > n) && ((greater == undefined) || greater < n); } }, // Is this a big integer? bigInt: function isBigInt(i, {min = -Infinity, max = Infinity, less, greater, int} = {}) { if (int != undefined && !int) { return; } if (typeof i == "bigint" || i instanceof BigInt) { i = i.valueOf(); return ((min === -Infinity) || min <= i) && ((max === Infinity) || max >= i) && ((less == undefined) || less > i) && ((greater == undefined) || greater < i); } }, // Is this an integer? integer: function isInteger(i, options) { return is.number(i, {NaN: true, infinity: true}) ? (is.number(i, options) && Number.isInteger(i.valueOf())) : is.bigInt(i, options); }, // Is this a number or big integer? num: function isNumeric(n, options) { return is.number(n, options) || is.bigInt(n, options); }, // Is this a function? function: function isFunction(f) { return typeof f == "function" || f instanceof Function; }, // Is this a non-string iterable? multi: function isMultiple(m) { return !is.string(m) && is.in(m, Symbol.iterator); } }; // backwards compatibility Object.defineProperty(is, "func", { value: is.function, enumerable: false }); return Object.freeze(is); }4b:T127f,

to

This object contains attached functions for converting the types of input arguments. This relies heavily on ${d11n.var("is", true)}.

functions

${d11n.var("to.multi", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(to.multi.name)}(${d11n.rich.params.span`m, ?map`}): If ${d11n.var("m")} is multiple, according to ${d11n.var("is.multi")}, then ${d11n.var("m")} is returned as is. Otherwise, a one-element array with ${d11n.var("m")} is returned. If ${d11n.var("map")} is a function, then an array is always returned, with ${d11n.var("map")} called for each element just as in ${d11n.rich.built_in.span`Array`}.prototype.map.
${d11n.var("to.multi.array", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(to.multi.array.name)}(${d11n.rich.params.span`m, ?map`}): This function is identical to its parent function, except that an array is always returned.
${d11n.var("to.entries", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(to.entries.name)}(${d11n.rich.params.span`m`}): If ${d11n.var("m")} is an object, then several attempts are made to enable iteration over it to produce key-value pairs. The goal is to return an iterable that produces two-element iterables. If ${d11n.var("m")} is not an object, then a ${d11n.rich.built_in.code`TypeError`} is thrown. Special cases are built in for instances of ${d11n.rich.built_in.code`Array`}, ${d11n.rich.built_in.code`Map`}, ${d11n.rich.built_in.code`HTMLCollection`}, ${d11n.rich.built_in.code`NamedNodeMap`}, ${d11n.rich.built_in.code`CSSStyleDeclaration`}, ${d11n.rich.built_in.code`KeyboardLayoutMap`}, ${d11n.rich.built_in.code`MIDIInputMap`}, ${d11n.rich.built_in.code`MIDIOutputMap`}, ${d11n.rich.built_in.code`StylePropertyMapReadOnly`}, and ${d11n.rich.built_in.code`MediaKeyStatusMap`}. Of those classes, the experimental ones are enabled conditionally, only if the browser supports them. If none of the special cases apply, then the object is iterated over to make an array. If all of the elements in the array are two-element iterables, then the array is returned as-is. Otherwise, a key-value array is constructed, with each element’s index as the key and the element as the value. As a last resort, the object’s own enumerable properties are iterated over, including symbols.
${d11n.var("to.entries.array", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(to.entries.array.name)}(${d11n.rich.params.span`m`}): This function is identical to its parent function, except that an array is always returned.
${d11n.var("to.entries.map", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(to.entries.map.name)}(${d11n.rich.params.span`m`}): This function is identical to its parent function, except that a map is always returned.
${d11n.var("to.entries.object", true, true)} = ${d11n.prefab.function.span} ${d11n.rich.name.span(to.entries.object.name)}(${d11n.rich.params.span`m`}): This function is identical to its parent function, except that a plain object is always returned, with its properties as the key-value pairs of the input object.

4c:T106f,to = { let to; // These are object types that don’t naturally iterate to produce key-value pairs. The provided functions return iterables that produce key-value pairs as reasonably as possible. const mapLike = new Map([ [Map, map => map.entries()], [HTMLCollection, function* iterateCollection(map) { const named = new Map(Object.entries(Object.getOwnPropertyDescriptors(map)).flatMap(([k, d]) => { let value = map[k]; let derivedKey = value.hasAttribute("id") ? value.getAttribute("id") : (value instanceof HTMLElement && "name" in value) ? value.name : undefined; return (derivedKey == k) ? [[value, k]] : []; })); let index = 0; for (let elm of map) { if (named.has(elm)) { yield [named.get(elm), elm]; } else { yield [index, elm]; } index++; } }], [NamedNodeMap, function* iterateAttrMap(attrs) { const names = new Set([...attrs].map(attr => attr.localName)); if (names.size < attrs.length) { names.clear(); for (let attr of attrs) { yield [attr.name, attr]; } } else { names.clear(); for (let attr of attrs) { yield [attr.localName, attr]; } } }], [CSSStyleDeclaration, function* iterateStyleDec(style) { for (let i = 0; i < style.length; i++) { let prop = style.item(i); let priority = style.getPropertyPriority(prop); yield [prop, `${style.getPropertyValue(prop)}${priority ? `!${priority}` : ""}`]; } }] ]); typeof globalThis.KeyboardLayoutMap == "undefined" || mapLike.set(globalThis.KeyboardLayoutMap, map => map.entries); { let getEntries = map => map.entries(); typeof globalThis.MIDIInputMap == "undefined" || mapLike.set(globalThis.MIDIInputMap, getEntries); typeof globalThis.MIDIOutputMap == "undefined" || mapLike.set(globalThis.MIDIOutputMap, getEntries); typeof globalThis.StylePropertyMapReadOnly == "undefined" || mapLike.set(globalThis.StylePropertyMapReadOnly, getEntries); typeof globalThis.MediaKeyStatusMap == "undefined" || mapLike.set(globalThis.MediaKeyStatusMap, getEntries); } invalidation.then(() => mapLike.clear()); const getKeys = (typeof globalThis.Reflect == "undefined" || !globalThis.Reflect.ownKeys) ? (o => globalThis.Reflect.ownKeys(o)) : (function* getKeys(o) { yield* Object.getOwnPropertyNames(o); yield* Object.getOwnPropertySymbols(o); }); function* getObjectEntries(o) { for (let key of getKeys(o)) { yield [key, o[key]]; } } return to = Object.freeze({ // Return `m`, if is.multi returns true; otherwise return a one-element array of `m`. If `map` is supplied, map the elements as in Array.prototype.map. multi: Object.defineProperty(function toMultiple(m, map) { m = is.multi(m) ? m : [m]; return map ? (Array.isArray(m) ? m : [...m]).map(map) : m; }, "array", { value: function toArray(a, map) { a = to.multi(a, map); return Array.isArray(a) || [...a]; }, enumerable: true }), // Return key-value pairs (with special cases for maps & map-like objects). If an object is not supplied, then a TypeError is thrown. entries: Object.defineProperties(function toEntries(m) { if (!is.object(m)) { throw new TypeError("not an object"); } for (let [type, iterator] of mapLike) { if (m instanceof type) { return iterator(m); } } if (is.multi(m)) { m = [...m]; return m.every(pair => ((Array.isArray(pair) ? pair : [...pair]).length == 2)) ? m : m.map((v, i) => [i, v]); } return getObjectEntries(m); }, { array: { value: function toEntryArray(m) { m = to.entries(m); return Array.isArray(m) ? m : [...m]; }, enumerable: true }, map: { value: function toEntryMap(m) { m = to.entries(m); return m instanceof Map ? m : new Map([...m]); }, enumerable: true }, object: { value: function toEntryObject(m) { return Object.fromEntries(to.entries.array(m)); }, enumerable: true } }) }); }4d:T557,function autoListener(options) { if (!options) { throw new TypeError("no options"); } let eventTarget = options.target; delete options.target; if (!eventTarget) { throw new TypeError("no event target provided"); } (Symbol.iterator in eventTarget && !(eventTarget instanceof EventTarget)) || (eventTarget = [eventTarget]); let callback = options.function; delete options.function; if (!callback) { throw new TypeError("no function provided"); } (Symbol.iterator in callback && (typeof callback != "function") && !(callback instanceof Function)) || (callback = [callback]); let type = options.type; delete options.type; if (!type) { throw new TypeError("no event type provided"); } (!(typeof type == "string" || type instanceof String) && Symbol.iterator in type) || (type = [type]); let invalid = options.invalidation; delete options.invalidation; invalid && (Symbol.iterator in invalid) && (invalid = Promise.any(invalid)); Object.freeze(options); for (let tar of eventTarget) { for (let cal of callback) { for (let typ of type) { tar.addEventListener(typ, cal, options); } } } return invalid?.then(() => { for (let tar of eventTarget) { for (let cal of callback) { for (let typ of type) { tar.removeEventListener(typ, cal, options); } } } }); }4e:T40d,walkDownNode = { const every = function* walkDownNode(n) { yield n; for (let c of n.childNodes) { yield* walkDownNode(c); } }; const some = function* walkDownNode(node, predicate, depth = 0) { let result = predicate(node, depth); if (result === null || ((typeof result == "number" || result instanceof Number) && Number.isNaN(result))) { // skip this } else { if (result) { yield node; } for (let child of node.childNodes) { yield* walkDownNode(child, predicate, depth + 1); } } }; return function walkDownNode(node, predicate) { if (predicate != undefined) { if (typeof predicate == "number" || predicate instanceof Number) { let maxDepth = predicate; predicate = (_, depth) => (depth <= maxDepth) ? true : null; } if (typeof predicate == "function" || predicate instanceof Function) { return some(node, predicate); } throw new TypeError("predicate not a function"); } return every(node); } }4f:T106f,

debug multitool

This object has a few tricks up its sleeves! All of these properties provide different ways to pause execution to inspect values. Remember that, in browsers, the developer tools must be open for the ${d11n.prefab.debugger.code} statement to have an effect. Any property of this object may be deleted, if you decide that you do not want it.

properties

${d11n.var("debug.ger", false, true)}

Assign a value to this property to invoke ${d11n.prefab.debugger.code} with that value. When reading this value, ${d11n.prefab.debugger.code} will be invoked, and you’ll get a value of undefined.

${d11n.var("debug.input", true, true)} = ${d11n.prefab.function.span}(function, before = ${d11n.prefab.true.span}, callback)

Pass in any function as the first argument, and you’ll get back a replacement function to take its place. It will pass all the arguments to the target function, and ${d11n.prefab.debugger.code} will be invoked before or after running the target function, depending on ${d11n.var("before")}. If provided, ${d11n.var("callback")} will be called immediately after the target function, receiving an argument with two properties:

${d11n.var("input")}: array of arguments passed into the target function
${d11n.var("output")}: value returned from the target function

Finally, the output is returned from the replacement function.

${d11n.var("debug.property", true, true)} = ${d11n.prefab.function.span}(object, property, get = ${d11n.prefab.true.span}, set = ${d11n.prefab.true.span})

Pass in object as the first argument and the name or symbol of the property that you want to intercept as the second argument. A getter and setter is injected in place of the property, and the parent object is returned. To intercept property assignment, pass in ${d11n.var("set")} as ${d11n.prefab.true.code}, and ${d11n.prefab.debugger.code} will be invoked for each assignment. To intercept reading the property, set ${d11n.var("get")} to ${d11n.prefab.true.code}. Assuming that the property can be reconfigured and that the property isn’t already backed by a getter & setter, the property will continue to function as normal.

${d11n.var("debug.assert", true, true)} = ${d11n.prefab.function.span}(condition, error = {message: "debug", cause: ${d11n.prefab.undefined.span}, type: Error})

This is similar to console.assert. If ${d11n.var("condition")} is truthy, nothing happens, and the function returns ${d11n.prefab.true.code}. If it is falsy, then ${d11n.prefab.debugger.code} is invoked. A new error is thrown immediately after, unless either ${d11n.var("options")} or ${d11n.var("error.type")} is ${d11n.prefab.null.code}. The error’s constructor (whose class is defined by ${d11n.var("error.type")}) is simply passed in ${d11n.var("error.message")}, and the cause of the error is set to ${d11n.var("error.cause")}. As a shorthand, a string may be passed as ${d11n.var("options")} to use as the message for the thrown Error.

${d11n.var("debug.enabled", false, true)}

This is the only part that does not throw errors or invoke ${d11n.prefab.debugger.code}. This value determines whether or not any of the other code in this object can invoke ${d11n.prefab.debugger.code}. Deleting this property does not prevent invoking ${d11n.prefab.debugger.code}; it only prevents you from toggling the setting.

50:T8af,debug = { let enabled = true; return Object.defineProperties(Object.create(null), { ger: { get: () => { if (enabled) { debugger; } }, set: value => { if (enabled) { debugger; } }, enumerable: true }, input: { value: (fun, before = true, callback) => Object.defineProperty(function(...args) { if (before && enabled) { debugger; } let output = fun(...args); callback?.({input: args, output}); if (!before && enabled) { debugger; } return output; }, "name", { value: "debug", enumerable: true }), enumerable: true, configurable: true }, property: { value: function debugProperty(object, property, get = true, set = true) { let value = object[property]; return Object.defineProperty(object, property, { get: get ? (() => { if (enabled) { debugger; } return value; }) : (() => value), set: set ? (newValue => { if (enabled) { debugger; } value = newValue; }) : (v => value = v) }); }, enumerable: true, configurable: true }, assert: { value: function assert(condition, options = {message: "debug", cause: undefined, type: Error}) { if (condition) { return true; } if (enabled) { debugger; } if (options === null || options.type === null) { return false; } let message, cause, type; if (typeof options == "string" || options instanceof String) { message = options; type = Error; } else { ({message, cause, type} = options); if (type === null) { return false; } type ??= Error; } let error; if (type === Error) { error = new Error(message); } else { error = (new Proxy(type, { apply (target, thisArg, args) { return new target(...args); } }))(message); } error.cause = cause; throw error; }, enumerable: true, configurable: true }, enabled: { get: () => enabled, set: e => enabled = !!e, enumerable: true }, [Symbol.toStringTag]: { get: () => "debug" } }); }51:Tfdc,d11n = { const d11n = { var: Object.defineProperties(function variableName(name, unwrap = false, special = false) { if (name.includes(".")) { let out = document.createElement("code"); let cutoff = name.indexOf("."); { let root = document.createElement("span"); root.classList.add("hljs-variable"); root.append(name.slice(0, cutoff)); out.append(root); } if (special) { for (let part of name.split(".").slice(1)) { let partElm = document.createElement("span"); partElm.classList.add("hljs-name"); partElm.append(part); out.append(".", partElm); } } else { out.append(name.slice(cutoff)); } return unwrap ? [...out.childNodes].reduce((frag, child) => { frag.append(child); return frag; }, new DocumentFragment()) : out; } else { let out = document.createElement(unwrap ? "span" : "code"); out.classList.add("hljs-variable"); out.append(name); return out; } }, { name: { value: "variable name", enumerable: true }, [Symbol.toStringTag]: { value: "variable name" } }), prefab: Object.defineProperty(Object.fromEntries(Object.entries({ function: {class: "hljs-keyword"}, "function*": {class: "hljs-keyword"}, debugger: {class: "hljs-keyword"}, return: {class: "hljs-keyword"}, yield: {class: "hljs-keyword"}, "yield*": {class: "hljs-keyword"}, await: {class: "hljs-keyword"}, undefined: {class: "hljs-literal"}, null: {class: "hljs-literal"}, NaN: {class: "hljs-literal"}, Infinity: {class: "hljs-literal"}, "-Infinity": {class: "hljs-literal", text: "−Infinity"}, true: {class: ["hljs-boolean", "observablehq--boolean"]}, false: {class: ["hljs-boolean", "observablehq--boolean"]} }).map(([key, config]) => [key, ["span", "code"].reduce((obj, tag) => { let e = document.createElement(tag); e.classList.add(...to.multi(config.class)); e.append(config.text ?? key); return Object.defineProperty(obj, tag, { get: () => e.cloneNode(Infinity), enumerable: true }); }, Object.create(null))])), Symbol.toStringTag, { value: "prefabricated elements" }), rich: Object.defineProperty(Object.fromEntries([...Object.entries({ "observablehq--": ["bigint", "boolean", "date", "empty", "error", "forbidden", "function", "import", "index", "key", "keyword", "null", "number", "prototype-key", "regexp", "string", "symbol", "undefined", "unknown"], "hljs-": ["addition", "built_in", "bullet", "comment", "deletion", "doctag", "keyword", "link", "literal", "meta", "name", "number", "params", "regexp", "section", "selector-class", "selector-id", "selector-tag", "string", "strong", "symbol", "tag", "template-tag", "template-variable", "type", "variable"] }) .flatMap(([library, names]) => names.map(name => ({library, name}))) .sort(({name: a}, {name: b}) => a == b ? 0 : a < b ? -1 : +1) .reduce((map, {library, name}) => { let className = `${library}${name}`; map.has(name) ? map.get(name).push(className) : map.set(name, [className]); return map; }, new Map()) .entries()] .map(([name, classNames]) => [name, Object.defineProperty(Object.fromEntries(["code", "span"].map(tag => { let e = document.createElement(tag); e.classList.add(...classNames); return [tag, Object.defineProperty((...children) => { let clone = e.cloneNode(Infinity); clone.append(...takeTag.array.raw(...children)); return clone; }, "name", { value: name.replaceAll(/[-_]+/g, " "), enumerable: true })]; })), Symbol.toStringTag, { value: name.replaceAll(/[-_]+/g, " ") })])), Symbol.toStringTag, { value: "rich elements" }) }; return Object.freeze(Object.defineProperty(d11n, Symbol.toStringTag, { value: "documentation" })); }52:[] 44:{"id":"e40ce4adcf04a314","slug":"utilities","title":"utilities","thumbnail":"81bb16a7ff55d45d94266758b8365ee237d393867b74be11d647cd5074c4c848","access_level":"public","create_time":"$D2022-06-01T01:38:46.165Z","update_time":"$D2025-01-28T21:47:37.612Z","view_time":null,"first_public_time":"$D2022-06-01T16:07:59.583Z","has_unpublished_edits":null,"fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"d2b7afa3a61febdf","login":"rmw4269","name":"Riley","avatar_url":"https://avatars-next.observableusercontent.com/839ad38e4ca0e32eaad7be29b5bc0c3a7f4304d5f91dd0f3642acf08015b6530","tier":"starter_2024","bio":"I enjoy spreadsheets and JavaScript way too much.","following":false},"version":1385,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"817e538440b46e8a","login":"rmw4269","name":"Riley","avatar_url":"https://avatars-next.observableusercontent.com/839ad38e4ca0e32eaad7be29b5bc0c3a7f4304d5f91dd0f3642acf08015b6530","tier":null,"bio":"I enjoy spreadsheets and JavaScript way too much.\n\ntrust://Riley.science!","following":false}],"members":[{"type":"individual","id":"817e538440b46e8a","login":"rmw4269","name":"Riley","avatar_url":"https://avatars-next.observableusercontent.com/839ad38e4ca0e32eaad7be29b5bc0c3a7f4304d5f91dd0f3642acf08015b6530","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":1,"collection":null,"type":"notebook","body":{"titling":"auto","title":"utilities","cells":[{"id":0,"value":"# utilities\nThese are a bunch of functions & thingies that I plan to reuse in my notebooks. If there’s a piece of code here that I have not yet documented, then I may change it at any time, potentially breaking dependents. If I have documented it and have not warned otherwise, then any future changes made to it should be backwards compatible.\n\n${ToC({invalidation})}","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":10,"value":"## array","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":229,"value":"### proportionalZip\nThis function takes in any number of iterables and returns an array of their elements interleaved. If the iterables all have the same number of elements, then the result is a simple round-robin interleaving of the elements. If there are different numbers of elements, then the positions of the elements are spread proportionally to be evenly distributed in the result. This is not to say that the pattern of selection is repeated; ","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":379,"value":"$46","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":184,"value":"proportionalZip([...\"ABCDEFGHIJKLMNOPQRSTUVWXYZ\"], [0, 1, 2, 3, 4, 5, 6, 7, 8, 9])","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":7,"value":"proportionalZip = ((unique = Symbol()) => {\n return function proportionalZip(...arrays) {\n if (arrays[0] === false) {\n arrays.shift();\n arrays = arrays.map(a => Array.isArray(a) ? a : [...a]);\n } else {\n arrays = arrays.map(a => [...a]);\n }\n\n let longest = Math.max(...arrays.map(a => a.length));\n let out = [];\n \n for (let i = 0; i < longest; i++) {\n for (let arr of arrays) {\n let local = Math.floor(i * arr.length / longest);\n if (arr[local] !== unique) {\n out.push(arr[local]);\n arr[local] = unique;\n }\n }\n }\n return out;\n }\n})()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":782,"value":"### join","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":786,"value":"{\n await visibility();\n let go = true;\n invalidation.then(() => go = false);\n while (go) {\n yield* Generators.map(join(\"ABCDEFG\", \" \"), e => Promises.tick(500, e));\n await Promises.delay(4000);\n await Promises.tick(1000);\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":798,"value":"join.array(\"ABCDEFG\", \"-\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1161,"value":"{\n let f = outToArray.define(function test(a, b, c) { return b; });\n console.dir(f);\n return f;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1148,"value":"outToArray = {\n function isFn(f) { return typeof f == \"function\" || f instanceof Function; }\n function outToArray(...args) {\n return [...this(...args)];\n }\n const symbol = this?.symbol || Symbol(outToArray.name);\n Object.defineProperties(outToArray, {\n symbol: { value: true }\n });\n return Object.freeze({\n function: outToArray,\n descriptor: Object.freeze({\n value: outToArray,\n enumerable: true\n }),\n define: function define(func, property = \"array\", name) {\n if (!isFn(func)) { throw new TypeError(\"no function provided\"); }\n if (property === symbol) { throw new TypeError(\"illegal property symbol\"); }\n return Object.defineProperty(func, property, {\n value: Object.defineProperties(outToArray.bind(func), {\n name: name ? {value: name} : { get: () => func.name },\n length: { get: () => func.length },\n [symbol]: { value: func }\n }),\n enumerable: true\n });\n },\n symbol\n });\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":784,"value":"join = {\n const significantThis = t => typeof t == \"string\" || (typeof t == \"object\" && t != null && Symbol.iterator in t);\n function* join(items, ...delimiters) {\n let iter = items[Symbol.iterator]();\n let item = iter.next();\n yield item.value;\n if (!item.done) {\n item = undefined;\n for (let e of iter) {\n yield* delimiters;\n yield e;\n }\n }\n }\n Object.defineProperties(join, {\n array: outToArray.descriptor,\n this: {\n value: Object.defineProperty(function joinThis(...delimiters) {\n return join(this, ...delimiters);\n }, \"array\", outToArray.descriptor),\n enumerable: true\n }\n });\n return join;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1194,"value":"## object enumeration\n\nThese are tools for iterating over keys and values of objects, similar to Object.keys and Object.entries. These functions are designed to work with and without Reflect. They all return some form of iterable, not necessarily an array. The main benefit with these custom functions is that all entries are enumerated, including those with symbol keys.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":424,"value":"$47","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":581,"value":"takeTag({concat: true}, s => s)`a${0}b${1}c${2}`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":576,"value":"takeTag.concat`a${0}b${1}c${2}`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":222,"value":"takeTag()`a${0}b${1}c${2}`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":211,"value":"takeTag()`a${0}b${1}c${2}d`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":213,"value":"takeTag()(\"a\", 0, \"b\", 1, \"c\", 2, \"d\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":208,"value":"$48","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1002,"value":"is.number(12)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":432,"value":"$49","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":253,"value":"$4a","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":970,"value":"$4b","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":299,"value":"$4c","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":24,"value":"## HTML","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":12,"value":"$4d","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"function changeTagName(element, tag) {\n let out = document.createElement(tag);\n for (let a of element.attributes) {\n if (a.namespaceURI) {\n element.attributes.removeNamedItemNS(a.namespaceURI, a.localName);\n out.attributes.setNamedItemNS(a);\n } else {\n element.attributes.removeNamedItem(a.name);\n out.attributes.setNamedItem(a);\n }\n }\n for (let [k, d] of Object.entries(Object.getOwnPropertyDescriptors(element))) {\n Object.hasOwn(element, k) || Object.defineProperty(element, k, d);\n }\n out.replaceChildren(...element.childNodes);\n element.parentElement && element.replaceWith(out);\n return out;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":20,"value":"import {inspect} from \"@rmw4269/inspect\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":711,"value":"deepestElement = Object.create(null, {\n first: {\n value: function firstDeepestElement(n) {\n return n.children.length ? firstDeepestElement(n.firstElementChild) : n;\n },\n enumerable: true\n },\n last: {\n value: function lastDeepestElement(n) {\n return n.children.length ? lastDeepestElement(n.lastElementChild) : n;\n },\n enumerable: true\n }\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":701,"value":"## node manipulation","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":704,"value":"deepestNode = Object.create(null, {\n first: {\n value: function firstDeepestNode(n) {\n return n.childNodes.length ? firstDeepestNode(n.firstChild) : n;\n },\n enumerable: true\n },\n last: {\n value: function lastDeepestNode(n) {\n return n.childNodes.length ? lastDeepestNode(n.lastChild) : n;\n },\n enumerable: true\n }\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":716,"value":"function nodeDeepLength(n) {\n if (n instanceof CharacterData) {\n return n instanceof Text ? n.length : 0;\n }\n let len = 0;\n for (let c of n.childNodes) {\n len += nodeDeepLength(c);\n }\n return len;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":773,"value":"{\n await visibility();\n let last;\n let current;\n let go = true;\n invalidation.then(() => go = false);\n while (go) {\n current = nodeDeepLength(document);\n if (current != last) {\n yield last = current;\n }\n await Promises.tick(1000);\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":721,"value":"$4e","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":732,"value":"{\n const elm = document.createElement(\"p\");\n for (let [p, v] of Object.entries({\n \"max-width\": \"var(--cell-width, 100vw)\",\n \"max-height\": \"1em\",\n \"line-height\": \"1em\",\n overflow: \"hidden\",\n \"text-overflow\": \"fade\",\n \"text-overflow\": \"ellipsis\"\n })) { elm.style.setProperty(p, v); }\n elm.ariaLive = \"off\";\n return Generators.map(walkDownNode(document.body, n => n instanceof Text && n.length && n.textContent.trim()), async t => {\n if (elm.parentNode) {\n await Promises.tick(1000);\n }\n elm.innerText = t.textContent;\n return elm;\n });\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":723,"value":"[...walkDownNode(document)].length","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":816,"value":"viewof truncateNodeTestView = Inputs.range([0, nodeDeepLength(d11nRichTest)], {\n label: \"maximum length\",\n value: nodeDeepLength(d11nRichTest),\n step: 1\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":824,"value":"truncateNodeTestElm = debug.ger, truncateNode(d11nRichTest.cloneNode(Infinity), truncateNodeTestView)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":839,"value":"nodeDeepLength(truncateNodeTestElm)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":719,"value":"// not currently working\nfunction truncateNode(node, length) {\n if (node instanceof Text) {\n if (node.length > length) {\n node.textContent = node.substringData(0, length);\n }\n } else if (nodeDeepLength(node) > length) {\n let deleting = false;\n for (let child of node.childNodes) {\n if (deleting) {\n child.remove();\n continue;\n } else {\n let childLen = nodeDeepLength(child);\n if (childLen > length) {\n truncateNode(child, length);\n deleting = true;\n } else {\n length -= childLen;\n }\n }\n }\n }\n return node;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":40,"value":"## debug","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":44,"value":"function tryIt(fun) {\n if (is.multi(fun)) {\n return [...fun].map(f => tryIt(f));\n }\n try {\n return {\n status: \"fulfilled\",\n value: arguments.length > 1 ? fun.call([...arguments].slice(1)) : fun()\n };\n } catch (e) {\n return {\n status: \"rejected\",\n reason: e\n };\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":167,"value":"tryIt(() => 3)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":71,"value":"$4f","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":849,"value":"","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":51,"value":"$50","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":65,"value":"#### examples","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":67,"value":"{ return debug.ger = Math.random(); } // Open the developer view, and re-run this cell.","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":284,"value":"## screen dimensions","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":440,"value":"{\n let {\n width,\n height,\n orientation: {\n angle,\n type\n },\n pixelDepth\n } = currentScreen;\n return Object.defineProperty({\n width, height,\n orientation: Object.defineProperty({\n angle,\n type\n }, Symbol.toStringTag, { value: ScreenOrientation.prototype[Symbol.toStringTag] }),\n \"pixel depth\": pixelDepth\n }, Symbol.toStringTag, { value: Screen.prototype[Symbol.toStringTag] })\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":286,"value":"currentScreen = Generators.observe(notify => {\n let listener = [\"change\", (({target}) => notify(target)), { passive: true }];\n screen.addEventListener(...listener);\n invalidation.then(() => screen.removeEventListener(...listener));\n notify(screen);\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1176,"value":"## Web requests","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":1362,"value":"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1239,"value":"htl.html`

${code}: ${code.description}

`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1178,"value":"import {codes as HTTP_codes} from \"@rmw4269/http-codes\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":289,"value":"## documentation generation\n${doNot.Use}\n\nThis is a little library for generating documentation for code. It has ${Object.keys(d11n).length} parts: ${Object.entries(d11n).flatMap(([prop, {[Symbol.toStringTag]: name}], index, {length}) => [(index == 0 ? \"\" : index == length - 1 ? \", and \" : \", \"), name, \" (\", d11n.var(prop), \")\"])}.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":293,"value":"$51","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":547,"value":"d11nRichTest = {\n let wrap = document.createElement(\"div\");\n {\n let header = document.createElement(\"strong\");\n header.append(\"test of \", d11n.var(\"d11n.rich\"));\n header.style.display = \"block\";\n wrap.append(header);\n }\n wrap.append(...Object.values(d11n.rich).flatMap(o => Object.values(o)).flatMap(f => [\" \", f`${f.name}`]).slice(1));\n return wrap;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":649,"value":"d11n.rich.symbol.code`test`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":594,"value":"## secrets\nThis is a cute lil‘ function for formatting secrets. This prevents the actual secret from being visible on the screen, instead returning a static element with the secret as a [view](/@observablehq/introduction-to-views).\n\n${d11n.prefab.function.span} secretView(cell, secret, key, terminate)\n${d11n.prefab.function.span} secretView(cell, secret, terminate)\n\nPass in the name of the cell as ${d11n.var(\"cell\")} and the actual secret as ${d11n.var(\"secret\")}. If you would like to indicate the string key for the secret, pass it in as ${d11n.var(\"key\")}. If ${d11n.var(\"terminate\")} is a promise, then, upon fulfillment, the internal storage of the secret will be cleared.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":600,"value":"viewof secretTest = secretView(\"secretTest\", Secret(\"utilities – secretTest\"), \"utilities – secretTest\", invalidation)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":613,"value":"viewof secretTestBrief = secretView(\"secretTest\", Secret(\"utilities – secretTest\"), invalidation)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":598,"value":"function secretView(cell, secret, key, terminate) {\n const [out, cellName, cellValue] = [\n \"inspect\",\n \"cellname\",\n (void (!terminate && key instanceof Promise && ([terminate, key] = [key])) ?? key) ? \"symbol\" : \"unknown\"\n ].map(cls => {\n let e = document.createElement(\"span\");\n e.classList.add(`observablehq--${cls}`);\n return e;\n });\n\n out.append(cellName, cellValue);\n cellName.append(`${cell || \"secret\"} = `);\n if (key) {\n let strElm = document.createElement(\"span\");\n strElm.classList.add(\"observablehq--string\");\n strElm.append(`\"${key}\"`);\n cellValue.append(\"Secret(\", strElm, \")\");\n } else {\n cellValue.append(\"\");\n }\n \n (terminate instanceof Promise ? Promise.any([invalidation, terminate]) : invalidation).then(() => secret = undefined);\n return Object.defineProperty(out, \"value\", { get: () => secret });\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1104,"value":"function* shuffleRepeat(a, invalidation) {\n let go = true;\n invalidation?.then?.(() => go = false);\n a = [...a];\n const length = a.length;\n while (go) {\n for (let i = 0; go && (i < length); i++) {\n let j = Math.floor(i + Math.random() * (length - i));\n let item = a[j];\n a.copyWithin(i + 1, i, j);\n yield a[i] = item;\n }\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":678,"value":"onlineNow = Generators.observe(notify => {\n let f = () => notify(navigator.onLine);\n let config = { passive: true };\n window.addEventListener(\"online\", f, config);\n window.addEventListener(\"offline\", f, config);\n invalidation.then(() => {\n window.removeEventListener(\"online\", f, config);\n window.removeEventListener(\"offline\", f, config);\n f = config = undefined;\n });\n notify(navigator.onLine);\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":681,"value":"online = {\n const online = () => navigator.onLine ? Promise.resolve() : new Promise(resolve => {\n if (navigator.onLine) { return resolve(); }\n window.addEventListener(\"online\", () => resolve(), { once: true, passive: true });\n });\n const offline = () => !navigator.onLine ? Promise.resolve() : new Promise(resolve => {\n if (!navigator.onLine) { return resolve(); }\n window.addEventListener(\"offline\", () => resolve(), { once: true, passive: true });\n });\n return Object.create(null, {\n true: {\n get: online,\n enumerable: true\n },\n false: {\n get: offline,\n enumerable: true\n },\n [Symbol.toStringTag]: { value: \"await online\" }\n });\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":279,"value":"## appendix","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":250,"value":"function makeElm(tag = \"div\", { attr, child, prop }) {\n if (is.multi(tag)) {\n return (Array.isArray(tag) ? tag : [...tag]).map(e => makeElm);\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":321,"value":"to.entries.map(html``.elements)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":312,"value":"to.entries({\n a: 0, b: 1, c: 2, d: 3\n})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":446,"value":"function deRestructure(...expressions) {\n if (!expressions?.length) { throw new TypeError(\"at least one expression needed\"); }\n return new Function(...expressions, expressions.length == 1\n ? String.raw`return ( ${expressions[0]} );`\n : String.raw`return [${expressions.map(e => `( ${e} )`).join(\", \")}];`);\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":201,"value":"import { cellWidth } from \"@rmw4269/css-cell-width\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":204,"value":"cellWidth","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":396,"value":"","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":669,"value":"doNot = {\n const e = html`This is still in development. Do not use it in production code.`;\n return Object.defineProperties({}, {\n Use: {\n get: (() => e.cloneNode(Infinity)),\n enumerable: true\n },\n [Symbol.toStringTag]: {\n value: \"doNotUse\"\n }\n })\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":269,"value":"import {ToC} from \"@rmw4269/contents\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":602,"value":"// This is just to fake the look & syntax of the Secrets feature, since it is disabled in public notebooks.\nSecret = s => s == \"utilities – secretTest\" ? \"Minimum wage should be at least the universal basic income.\" : undefined","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W52","stdlib":"1"}} 45:"$44:body"