pi-umbra 0.1.4 → 0.2.0

package/node_modules/hast-util-to-html/lib/index.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Serialize hast as HTML.
+ *
+ * @param {Array<RootContent> | Nodes} tree
+ *   Tree to serialize.
+ * @param {Options | null | undefined} [options]
+ *   Configuration (optional).
+ * @returns {string}
+ *   Serialized HTML.
+ */
+export function toHtml(tree: Array<RootContent> | Nodes, options?: Options | null | undefined): string;
+/**
+ * Serialize all children of `parent`.
+ *
+ * @this {State}
+ *   Info passed around about the current state.
+ * @param {Parents | undefined} parent
+ *   Parent whose children to serialize.
+ * @returns {string}
+ */
+export function all(this: State, parent: Parents | undefined): string;
+export type CharacterReferences = Omit<StringifyEntitiesOptions, "attribute" | "escapeOnly" | "subset">;
+/**
+ * Configuration.
+ */
+export type Options = {
+    /**
+     * Do not encode some characters which cause XSS vulnerabilities in older
+     * browsers (default: `false`).
+     *
+     * > ⚠️ **Danger**: only set this if you completely trust the content.
+     */
+    allowDangerousCharacters?: boolean | null | undefined;
+    /**
+     * Allow `raw` nodes and insert them as raw HTML (default: `false`).
+     *
+     * When `false`, `Raw` nodes are encoded.
+     *
+     * > ⚠️ **Danger**: only set this if you completely trust the content.
+     */
+    allowDangerousHtml?: boolean | null | undefined;
+    /**
+     * Do not encode characters which cause parse errors (even though they work),
+     * to save bytes (default: `false`).
+     *
+     * Not used in the SVG space.
+     *
+     * > 👉 **Note**: intentionally creates parse errors in markup (how parse
+     * > errors are handled is well defined, so this works but isn’t pretty).
+     */
+    allowParseErrors?: boolean | null | undefined;
+    /**
+     * Use “bogus comments” instead of comments to save byes: `<?charlie>`
+     * instead of `<!--charlie-->` (default: `false`).
+     *
+     * > 👉 **Note**: intentionally creates parse errors in markup (how parse
+     * > errors are handled is well defined, so this works but isn’t pretty).
+     */
+    bogusComments?: boolean | null | undefined;
+    /**
+     * Configure how to serialize character references (optional).
+     */
+    characterReferences?: CharacterReferences | null | undefined;
+    /**
+     * Close SVG elements without any content with slash (`/`) on the opening tag
+     * instead of an end tag: `<circle />` instead of `<circle></circle>`
+     * (default: `false`).
+     *
+     * See `tightSelfClosing` to control whether a space is used before the
+     * slash.
+     *
+     * Not used in the HTML space.
+     */
+    closeEmptyElements?: boolean | null | undefined;
+    /**
+     * Close self-closing nodes with an extra slash (`/`): `<img />` instead of
+     * `<img>` (default: `false`).
+     *
+     * See `tightSelfClosing` to control whether a space is used before the
+     * slash.
+     *
+     * Not used in the SVG space.
+     */
+    closeSelfClosing?: boolean | null | undefined;
+    /**
+     * Collapse empty attributes: get `class` instead of `class=""` (default:
+     * `false`).
+     *
+     * Not used in the SVG space.
+     *
+     * > 👉 **Note**: boolean attributes (such as `hidden`) are always collapsed.
+     */
+    collapseEmptyAttributes?: boolean | null | undefined;
+    /**
+     * Omit optional opening and closing tags (default: `false`).
+     *
+     * For example, in `<ol><li>one</li><li>two</li></ol>`, both `</li>` closing
+     * tags can be omitted.
+     * The first because it’s followed by another `li`, the last because it’s
+     * followed by nothing.
+     *
+     * Not used in the SVG space.
+     */
+    omitOptionalTags?: boolean | null | undefined;
+    /**
+     * Leave attributes unquoted if that results in less bytes (default: `false`).
+     *
+     * Not used in the SVG space.
+     */
+    preferUnquoted?: boolean | null | undefined;
+    /**
+     * Use the other quote if that results in less bytes (default: `false`).
+     */
+    quoteSmart?: boolean | null | undefined;
+    /**
+     * Preferred quote to use (default: `'"'`).
+     */
+    quote?: Quote | null | undefined;
+    /**
+     * When an `<svg>` element is found in the HTML space, this package already
+     * automatically switches to and from the SVG space when entering and exiting
+     * it (default: `'html'`).
+     *
+     * > 👉 **Note**: hast is not XML.
+     * > It supports SVG as embedded in HTML.
+     * > It does not support the features available in XML.
+     * > Passing SVG might break but fragments of modern SVG should be fine.
+     * > Use [`xast`][xast] if you need to support SVG as XML.
+     */
+    space?: Space | null | undefined;
+    /**
+     * Join attributes together, without whitespace, if possible: get
+     * `class="a b"title="c d"` instead of `class="a b" title="c d"` to save
+     * bytes (default: `false`).
+     *
+     * Not used in the SVG space.
+     *
+     * > 👉 **Note**: intentionally creates parse errors in markup (how parse
+     * > errors are handled is well defined, so this works but isn’t pretty).
+     */
+    tightAttributes?: boolean | null | undefined;
+    /**
+     * Join known comma-separated attribute values with just a comma (`,`),
+     * instead of padding them on the right as well (`,␠`, where `␠` represents a
+     * space) (default: `false`).
+     */
+    tightCommaSeparatedLists?: boolean | null | undefined;
+    /**
+     * Drop unneeded spaces in doctypes: `<!doctypehtml>` instead of
+     * `<!doctype html>` to save bytes (default: `false`).
+     *
+     * > 👉 **Note**: intentionally creates parse errors in markup (how parse
+     * > errors are handled is well defined, so this works but isn’t pretty).
+     */
+    tightDoctype?: boolean | null | undefined;
+    /**
+     * Do not use an extra space when closing self-closing elements: `<img/>`
+     * instead of `<img />` (default: `false`).
+     *
+     * > 👉 **Note**: only used if `closeSelfClosing: true` or
+     * > `closeEmptyElements: true`.
+     */
+    tightSelfClosing?: boolean | null | undefined;
+    /**
+     * Use a `<!DOCTYPE…` instead of `<!doctype…` (default: `false`).
+     *
+     * Useless except for XHTML.
+     */
+    upperDoctype?: boolean | null | undefined;
+    /**
+     * Tag names of elements to serialize without closing tag (default: `html-void-elements`).
+     *
+     * Not used in the SVG space.
+     *
+     * > 👉 **Note**: It’s highly unlikely that you want to pass this, because
+     * > hast is not for XML, and HTML will not add more void elements.
+     */
+    voids?: ReadonlyArray<string> | null | undefined;
+};
+/**
+ * HTML quotes for attribute values.
+ */
+export type Quote = "\"" | "'";
+export type Settings = Omit<Required<{ [key in keyof Options]: Exclude<Options[key], null | undefined>; }>, "space" | "quote">;
+/**
+ * Namespace.
+ */
+export type Space = "html" | "svg";
+/**
+ * Info passed around about the current state.
+ */
+export type State = {
+    /**
+     * Serialize the children of a parent node.
+     */
+    all: (node: Parents | undefined) => string;
+    /**
+     * Alternative quote.
+     */
+    alternative: Quote;
+    /**
+     * Serialize one node.
+     */
+    one: (node: Nodes, index: number | undefined, parent: Parents | undefined) => string;
+    /**
+     * Preferred quote.
+     */
+    quote: Quote;
+    /**
+     * Current schema.
+     */
+    schema: Schema;
+    /**
+     * User configuration.
+     */
+    settings: Settings;
+};
+import type { RootContent } from 'hast';
+import type { Nodes } from 'hast';
+import type { Parents } from 'hast';
+import type { Options as StringifyEntitiesOptions } from 'stringify-entities';
+import type { Schema } from 'property-information';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/hast-util-to-html/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AAmKA;;;;;;;;;GASG;AACH,6BAPW,KAAK,CAAC,WAAW,CAAC,GAAG,KAAK,YAE1B,OAAO,GAAG,IAAI,GAAG,SAAS,GAExB,MAAM,CA8ClB;AAoBD;;;;;;;;GAQG;AACH,yCAJW,OAAO,GAAG,SAAS,GAEjB,MAAM,CAalB;kCAzPY,IAAI,CAAC,wBAAwB,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,CAAC;;;;;;;;;;;+BAIpE,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;yBAK1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;;;uBAM1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;oBAQ1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;0BAM1B,mBAAmB,GAAG,IAAI,GAAG,SAAS;;;;;;;;;;;yBAEtC,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;;;uBAS1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;;8BAQ1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;;;;uBAO1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;qBAS1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;iBAI1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;YAE1B,KAAK,GAAG,IAAI,GAAG,SAAS;;;;;;;;;;;;YAExB,KAAK,GAAG,IAAI,GAAG,SAAS;;;;;;;;;;;sBAUxB,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;+BAS1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;mBAI1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;uBAM1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;mBAM1B,OAAO,GAAG,IAAI,GAAG,SAAS;;;;;;;;;YAI1B,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS;;;;;oBAQzC,IAAG,GAAG,GAAG;uBAGT,IAAI,CAAC,QAAQ,CAAC,GAAE,GAAG,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,GAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;;;;oBAEpG,MAAM,GAAG,KAAK;;;;;;;;SAKb,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,KAAK,MAAM;;;;iBAErC,KAAK;;;;SAEL,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,KAAK,MAAM;;;;WAE/E,KAAK;;;;YAEL,MAAM;;;;cAEN,QAAQ;;iCAjJwB,MAAM;2BAAN,MAAM;6BAAN,MAAM;yDAEE,oBAAoB;4BADjD,sBAAsB"}

package/node_modules/hast-util-to-html/lib/index.js

@@ -0,0 +1,257 @@
+/**
+ * @import {Nodes, Parents, RootContent} from 'hast'
+ * @import {Schema} from 'property-information'
+ * @import {Options as StringifyEntitiesOptions} from 'stringify-entities'
+ */
+
+/**
+ * @typedef {Omit<StringifyEntitiesOptions, 'attribute' | 'escapeOnly' | 'subset'>} CharacterReferences
+ *
+ * @typedef Options
+ *   Configuration.
+ * @property {boolean | null | undefined} [allowDangerousCharacters=false]
+ *   Do not encode some characters which cause XSS vulnerabilities in older
+ *   browsers (default: `false`).
+ *
+ *   > ⚠️ **Danger**: only set this if you completely trust the content.
+ * @property {boolean | null | undefined} [allowDangerousHtml=false]
+ *   Allow `raw` nodes and insert them as raw HTML (default: `false`).
+ *
+ *   When `false`, `Raw` nodes are encoded.
+ *
+ *   > ⚠️ **Danger**: only set this if you completely trust the content.
+ * @property {boolean | null | undefined} [allowParseErrors=false]
+ *   Do not encode characters which cause parse errors (even though they work),
+ *   to save bytes (default: `false`).
+ *
+ *   Not used in the SVG space.
+ *
+ *   > 👉 **Note**: intentionally creates parse errors in markup (how parse
+ *   > errors are handled is well defined, so this works but isn’t pretty).
+ * @property {boolean | null | undefined} [bogusComments=false]
+ *   Use “bogus comments” instead of comments to save byes: `<?charlie>`
+ *   instead of `<!--charlie-->` (default: `false`).
+ *
+ *   > 👉 **Note**: intentionally creates parse errors in markup (how parse
+ *   > errors are handled is well defined, so this works but isn’t pretty).
+ * @property {CharacterReferences | null | undefined} [characterReferences]
+ *   Configure how to serialize character references (optional).
+ * @property {boolean | null | undefined} [closeEmptyElements=false]
+ *   Close SVG elements without any content with slash (`/`) on the opening tag
+ *   instead of an end tag: `<circle />` instead of `<circle></circle>`
+ *   (default: `false`).
+ *
+ *   See `tightSelfClosing` to control whether a space is used before the
+ *   slash.
+ *
+ *   Not used in the HTML space.
+ * @property {boolean | null | undefined} [closeSelfClosing=false]
+ *   Close self-closing nodes with an extra slash (`/`): `<img />` instead of
+ *   `<img>` (default: `false`).
+ *
+ *   See `tightSelfClosing` to control whether a space is used before the
+ *   slash.
+ *
+ *   Not used in the SVG space.
+ * @property {boolean | null | undefined} [collapseEmptyAttributes=false]
+ *   Collapse empty attributes: get `class` instead of `class=""` (default:
+ *   `false`).
+ *
+ *   Not used in the SVG space.
+ *
+ *   > 👉 **Note**: boolean attributes (such as `hidden`) are always collapsed.
+ * @property {boolean | null | undefined} [omitOptionalTags=false]
+ *   Omit optional opening and closing tags (default: `false`).
+ *
+ *   For example, in `<ol><li>one</li><li>two</li></ol>`, both `</li>` closing
+ *   tags can be omitted.
+ *   The first because it’s followed by another `li`, the last because it’s
+ *   followed by nothing.
+ *
+ *   Not used in the SVG space.
+ * @property {boolean | null | undefined} [preferUnquoted=false]
+ *   Leave attributes unquoted if that results in less bytes (default: `false`).
+ *
+ *   Not used in the SVG space.
+ * @property {boolean | null | undefined} [quoteSmart=false]
+ *   Use the other quote if that results in less bytes (default: `false`).
+ * @property {Quote | null | undefined} [quote='"']
+ *   Preferred quote to use (default: `'"'`).
+ * @property {Space | null | undefined} [space='html']
+ *   When an `<svg>` element is found in the HTML space, this package already
+ *   automatically switches to and from the SVG space when entering and exiting
+ *   it (default: `'html'`).
+ *
+ *   > 👉 **Note**: hast is not XML.
+ *   > It supports SVG as embedded in HTML.
+ *   > It does not support the features available in XML.
+ *   > Passing SVG might break but fragments of modern SVG should be fine.
+ *   > Use [`xast`][xast] if you need to support SVG as XML.
+ * @property {boolean | null | undefined} [tightAttributes=false]
+ *   Join attributes together, without whitespace, if possible: get
+ *   `class="a b"title="c d"` instead of `class="a b" title="c d"` to save
+ *   bytes (default: `false`).
+ *
+ *   Not used in the SVG space.
+ *
+ *   > 👉 **Note**: intentionally creates parse errors in markup (how parse
+ *   > errors are handled is well defined, so this works but isn’t pretty).
+ * @property {boolean | null | undefined} [tightCommaSeparatedLists=false]
+ *   Join known comma-separated attribute values with just a comma (`,`),
+ *   instead of padding them on the right as well (`,␠`, where `␠` represents a
+ *   space) (default: `false`).
+ * @property {boolean | null | undefined} [tightDoctype=false]
+ *   Drop unneeded spaces in doctypes: `<!doctypehtml>` instead of
+ *   `<!doctype html>` to save bytes (default: `false`).
+ *
+ *   > 👉 **Note**: intentionally creates parse errors in markup (how parse
+ *   > errors are handled is well defined, so this works but isn’t pretty).
+ * @property {boolean | null | undefined} [tightSelfClosing=false]
+ *   Do not use an extra space when closing self-closing elements: `<img/>`
+ *   instead of `<img />` (default: `false`).
+ *
+ *   > 👉 **Note**: only used if `closeSelfClosing: true` or
+ *   > `closeEmptyElements: true`.
+ * @property {boolean | null | undefined} [upperDoctype=false]
+ *   Use a `<!DOCTYPE…` instead of `<!doctype…` (default: `false`).
+ *
+ *   Useless except for XHTML.
+ * @property {ReadonlyArray<string> | null | undefined} [voids]
+ *   Tag names of elements to serialize without closing tag (default: `html-void-elements`).
+ *
+ *   Not used in the SVG space.
+ *
+ *   > 👉 **Note**: It’s highly unlikely that you want to pass this, because
+ *   > hast is not for XML, and HTML will not add more void elements.
+ *
+ * @typedef {'"' | "'"} Quote
+ *   HTML quotes for attribute values.
+ *
+ * @typedef {Omit<Required<{[key in keyof Options]: Exclude<Options[key], null | undefined>}>, 'space' | 'quote'>} Settings
+ *
+ * @typedef {'html' | 'svg'} Space
+ *   Namespace.
+ *
+ * @typedef State
+ *   Info passed around about the current state.
+ * @property {(node: Parents | undefined) => string} all
+ *   Serialize the children of a parent node.
+ * @property {Quote} alternative
+ *   Alternative quote.
+ * @property {(node: Nodes, index: number | undefined, parent: Parents | undefined) => string} one
+ *   Serialize one node.
+ * @property {Quote} quote
+ *   Preferred quote.
+ * @property {Schema} schema
+ *   Current schema.
+ * @property {Settings} settings
+ *   User configuration.
+ */
+
+import {htmlVoidElements} from 'html-void-elements'
+import {html, svg} from 'property-information'
+import {handle} from './handle/index.js'
+
+/** @type {Options} */
+const emptyOptions = {}
+
+/** @type {CharacterReferences} */
+const emptyCharacterReferences = {}
+
+/** @type {Array<never>} */
+const emptyChildren = []
+
+/**
+ * Serialize hast as HTML.
+ *
+ * @param {Array<RootContent> | Nodes} tree
+ *   Tree to serialize.
+ * @param {Options | null | undefined} [options]
+ *   Configuration (optional).
+ * @returns {string}
+ *   Serialized HTML.
+ */
+export function toHtml(tree, options) {
+  const options_ = options || emptyOptions
+  const quote = options_.quote || '"'
+  const alternative = quote === '"' ? "'" : '"'
+
+  if (quote !== '"' && quote !== "'") {
+    throw new Error('Invalid quote `' + quote + '`, expected `\'` or `"`')
+  }
+
+  /** @type {State} */
+  const state = {
+    one,
+    all,
+    settings: {
+      omitOptionalTags: options_.omitOptionalTags || false,
+      allowParseErrors: options_.allowParseErrors || false,
+      allowDangerousCharacters: options_.allowDangerousCharacters || false,
+      quoteSmart: options_.quoteSmart || false,
+      preferUnquoted: options_.preferUnquoted || false,
+      tightAttributes: options_.tightAttributes || false,
+      upperDoctype: options_.upperDoctype || false,
+      tightDoctype: options_.tightDoctype || false,
+      bogusComments: options_.bogusComments || false,
+      tightCommaSeparatedLists: options_.tightCommaSeparatedLists || false,
+      tightSelfClosing: options_.tightSelfClosing || false,
+      collapseEmptyAttributes: options_.collapseEmptyAttributes || false,
+      allowDangerousHtml: options_.allowDangerousHtml || false,
+      voids: options_.voids || htmlVoidElements,
+      characterReferences:
+        options_.characterReferences || emptyCharacterReferences,
+      closeSelfClosing: options_.closeSelfClosing || false,
+      closeEmptyElements: options_.closeEmptyElements || false
+    },
+    schema: options_.space === 'svg' ? svg : html,
+    quote,
+    alternative
+  }
+
+  return state.one(
+    Array.isArray(tree) ? {type: 'root', children: tree} : tree,
+    undefined,
+    undefined
+  )
+}
+
+/**
+ * Serialize a node.
+ *
+ * @this {State}
+ *   Info passed around about the current state.
+ * @param {Nodes} node
+ *   Node to handle.
+ * @param {number | undefined} index
+ *   Index of `node` in `parent.
+ * @param {Parents | undefined} parent
+ *   Parent of `node`.
+ * @returns {string}
+ *   Serialized node.
+ */
+function one(node, index, parent) {
+  return handle(node, index, parent, this)
+}
+
+/**
+ * Serialize all children of `parent`.
+ *
+ * @this {State}
+ *   Info passed around about the current state.
+ * @param {Parents | undefined} parent
+ *   Parent whose children to serialize.
+ * @returns {string}
+ */
+export function all(parent) {
+  /** @type {Array<string>} */
+  const results = []
+  const children = (parent && parent.children) || emptyChildren
+  let index = -1
+
+  while (++index < children.length) {
+    results[index] = this.one(children[index], index, parent)
+  }
+
+  return results.join('')
+}

package/node_modules/hast-util-to-html/lib/omission/closing.d.ts

@@ -0,0 +1,2 @@
+export const closing: import("./omission.js").OmitHandle;
+//# sourceMappingURL=closing.d.ts.map

package/node_modules/hast-util-to-html/lib/omission/closing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closing.d.ts","sourceRoot":"","sources":["closing.js"],"names":[],"mappings":"AAQA,yDAoBE"}