@mininglamp-oss/octo-runtime 0.0.0-stage → 1.0.0

package/node_modules/micromark/stream.js

@@ -0,0 +1,256 @@
+/**
+ * @import {Encoding, Value} from 'micromark-util-types'
+ */
+
+/**
+ * @typedef {import('micromark-util-types').Options} Options
+ */
+
+/**
+ * @callback Callback
+ *   Function called when write was successful.
+ * @returns {undefined}
+ *   Nothing.
+ *
+ * @typedef PipeOptions
+ *   Configuration for piping.
+ * @property {boolean | null | undefined} [end]
+ *   Whether to end the destination stream when the source stream ends.
+ *
+ * @typedef {Omit<NodeJS.ReadableStream & NodeJS.WritableStream, 'isPaused' | 'pause' | 'read' | 'resume' | 'setEncoding' | 'unpipe' | 'unshift' | 'wrap'>} MinimalDuplex
+ *   Duplex stream.
+ */
+
+import { EventEmitter } from 'node:events';
+import { compile } from './lib/compile.js';
+import { parse } from './lib/parse.js';
+import { postprocess } from './lib/postprocess.js';
+import { preprocess } from './lib/preprocess.js';
+
+/**
+ * Create a duplex (readable and writable) stream.
+ *
+ * Some of the work to parse markdown can be done streaming, but in the
+ * end buffering is required.
+ *
+ * micromark does not handle errors for you, so you must handle errors on whatever
+ * streams you pipe into it.
+ * As markdown does not know errors, `micromark` itself does not emit errors.
+ *
+ * @param {Options | null | undefined} [options]
+ *   Configuration (optional).
+ * @returns {MinimalDuplex}
+ *   Duplex stream.
+ */
+export function stream(options) {
+  const prep = preprocess();
+  const tokenize = parse(options).document().write;
+  const comp = compile(options);
+  /** @type {boolean} */
+  let ended;
+  const emitter = /** @type {MinimalDuplex} */new EventEmitter();
+  // @ts-expect-error: fine.
+  emitter.end = end;
+  emitter.pipe = pipe;
+  emitter.readable = true;
+  emitter.writable = true;
+  // @ts-expect-error: fine.
+  emitter.write = write;
+  return emitter;
+
+  /**
+   * Write a chunk into memory.
+   *
+   * @overload
+   * @param {Value | null | undefined} [chunk]
+   *   Slice of markdown to parse (`string` or `Uint8Array`).
+   * @param {Encoding | null | undefined} [encoding]
+   *   Character encoding to understand `chunk` as when it’s a `Uint8Array`
+   *   (`string`, default: `'utf8'`).
+   * @param {Callback | null | undefined} [callback]
+   *   Function called when write was successful.
+   * @returns {boolean}
+   *   Whether write was successful.
+   *
+   * @overload
+   * @param {Value | null | undefined} [chunk]
+   *   Slice of markdown to parse (`string` or `Uint8Array`).
+   * @param {Callback | null | undefined} [callback]
+   *   Function called when write was successful.
+   * @returns {boolean}
+   *   Whether write was successful.
+   *
+   * @param {Value | null | undefined} [chunk]
+   *   Slice of markdown to parse (`string` or `Uint8Array`).
+   * @param {Callback | Encoding | null | undefined} [encoding]
+   *   Character encoding to understand `chunk` as when it’s a `Uint8Array`
+   *   (`string`, default: `'utf8'`).
+   * @param {Callback | null | undefined} [callback]
+   *   Function called when write was successful.
+   * @returns {boolean}
+   *   Whether write was successful.
+   */
+  function write(chunk, encoding, callback) {
+    if (typeof encoding === 'function') {
+      callback = encoding;
+      encoding = undefined;
+    }
+    if (ended) {
+      throw new Error('Did not expect `write` after `end`');
+    }
+    tokenize(prep(chunk || '', encoding));
+    if (callback) {
+      callback();
+    }
+
+    // Signal successful write.
+    return true;
+  }
+
+  /**
+   * End the writing.
+   *
+   * Passes all arguments as a final `write`.
+   *
+   * @overload
+   * @param {Value | null | undefined} [chunk]
+   *   Slice of markdown to parse (`string` or `Uint8Array`).
+   * @param {Encoding | null | undefined} [encoding]
+   *   Character encoding to understand `chunk` as when it’s a `Uint8Array`
+   *   (`string`, default: `'utf8'`).
+   * @param {Callback | null | undefined} [callback]
+   *   Function called when write was successful.
+   * @returns {boolean}
+   *   Whether write was successful.
+   *
+   * @overload
+   * @param {Value | null | undefined} [chunk]
+   *   Slice of markdown to parse (`string` or `Uint8Array`).
+   * @param {Callback | null | undefined} [callback]
+   *   Function called when write was successful.
+   * @returns {boolean}
+   *   Whether write was successful.
+   *
+   * @overload
+   * @param {Callback | null | undefined} [callback]
+   *   Function called when write was successful.
+   * @returns {boolean}
+   *   Whether write was successful.
+   *
+   * @param {Callback | Value | null | undefined} [chunk]
+   *   Slice of markdown to parse (`string` or `Uint8Array`).
+   * @param {Callback | Encoding | null | undefined} [encoding]
+   *   Character encoding to understand `chunk` as when it’s a `Uint8Array`
+   *   (`string`, default: `'utf8'`).
+   * @param {Callback | null | undefined} [callback]
+   *   Function called when write was successful.
+   * @returns {boolean}
+   *   Whether write was successful.
+   */
+  function end(chunk, encoding, callback) {
+    if (typeof chunk === 'function') {
+      encoding = chunk;
+      chunk = undefined;
+    }
+    if (typeof encoding === 'function') {
+      callback = encoding;
+      encoding = undefined;
+    }
+    write(chunk, encoding, callback);
+    emitter.emit('data', comp(postprocess(tokenize(prep('', encoding, true)))));
+    emitter.emit('end');
+    ended = true;
+    return true;
+  }
+
+  /**
+   * Pipe the processor into a writable stream.
+   *
+   * Basically `Stream#pipe`, but inlined and simplified to keep the bundled
+   * size down.
+   * See: <https://github.com/nodejs/node/blob/43a5170/lib/internal/streams/legacy.js#L13>.
+   *
+   * @template {NodeJS.WritableStream} Stream
+   *   Writable stream.
+   * @param {Stream} destination
+   *   Stream to pipe into.
+   * @param {PipeOptions | null | undefined} [options]
+   *   Configuration.
+   * @returns {Stream}
+   *   Destination stream.
+   */
+  function pipe(destination, options) {
+    emitter.on('data', ondata);
+    emitter.on('error', onerror);
+    emitter.on('end', cleanup);
+    emitter.on('close', cleanup);
+
+    // If the `end` option is not supplied, `destination.end()` will be
+    // called when the `end` or `close` events are received.
+    // @ts-expect-error `_isStdio` is available on `std{err,out}`
+    if (!destination._isStdio && (!options || options.end !== false)) {
+      emitter.on('end', onend);
+    }
+    destination.on('error', onerror);
+    destination.on('close', cleanup);
+    destination.emit('pipe', emitter);
+    return destination;
+
+    /**
+     * End destination stream.
+     *
+     * @returns {undefined}
+     *   Nothing.
+     */
+    function onend() {
+      if (destination.end) {
+        destination.end();
+      }
+    }
+
+    /**
+     * Handle data.
+     *
+     * @param {string} chunk
+     *   Data.
+     * @returns {undefined}
+     *   Nothing.
+     */
+    function ondata(chunk) {
+      if (destination.writable) {
+        destination.write(chunk);
+      }
+    }
+
+    /**
+     * Clean listeners.
+     *
+     * @returns {undefined}
+     *   Nothing.
+     */
+    function cleanup() {
+      emitter.removeListener('data', ondata);
+      emitter.removeListener('end', onend);
+      emitter.removeListener('error', onerror);
+      emitter.removeListener('end', cleanup);
+      emitter.removeListener('close', cleanup);
+      destination.removeListener('error', onerror);
+      destination.removeListener('close', cleanup);
+    }
+
+    /**
+     * Close dangling pipes and handle unheard errors.
+     *
+     * @param {Error | null | undefined} [error]
+     *   Error, if any.
+     * @returns {undefined}
+     *   Nothing.
+     */
+    function onerror(error) {
+      cleanup();
+      if (!emitter.listenerCount('error')) {
+        throw error; // Unhandled stream error in pipe.
+      }
+    }
+  }
+}

package/node_modules/micromark-core-commonmark/dev/index.d.ts

@@ -0,0 +1,23 @@
+export { attention } from "./lib/attention.js";
+export { autolink } from "./lib/autolink.js";
+export { blankLine } from "./lib/blank-line.js";
+export { blockQuote } from "./lib/block-quote.js";
+export { characterEscape } from "./lib/character-escape.js";
+export { characterReference } from "./lib/character-reference.js";
+export { codeFenced } from "./lib/code-fenced.js";
+export { codeIndented } from "./lib/code-indented.js";
+export { codeText } from "./lib/code-text.js";
+export { content } from "./lib/content.js";
+export { definition } from "./lib/definition.js";
+export { hardBreakEscape } from "./lib/hard-break-escape.js";
+export { headingAtx } from "./lib/heading-atx.js";
+export { htmlFlow } from "./lib/html-flow.js";
+export { htmlText } from "./lib/html-text.js";
+export { labelEnd } from "./lib/label-end.js";
+export { labelStartImage } from "./lib/label-start-image.js";
+export { labelStartLink } from "./lib/label-start-link.js";
+export { lineEnding } from "./lib/line-ending.js";
+export { list } from "./lib/list.js";
+export { setextUnderline } from "./lib/setext-underline.js";
+export { thematicBreak } from "./lib/thematic-break.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/micromark-core-commonmark/dev/index.d.ts.map

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

package/node_modules/micromark-core-commonmark/dev/index.js

@@ -0,0 +1,22 @@
+export {attention} from './lib/attention.js'
+export {autolink} from './lib/autolink.js'
+export {blankLine} from './lib/blank-line.js'
+export {blockQuote} from './lib/block-quote.js'
+export {characterEscape} from './lib/character-escape.js'
+export {characterReference} from './lib/character-reference.js'
+export {codeFenced} from './lib/code-fenced.js'
+export {codeIndented} from './lib/code-indented.js'
+export {codeText} from './lib/code-text.js'
+export {content} from './lib/content.js'
+export {definition} from './lib/definition.js'
+export {hardBreakEscape} from './lib/hard-break-escape.js'
+export {headingAtx} from './lib/heading-atx.js'
+export {htmlFlow} from './lib/html-flow.js'
+export {htmlText} from './lib/html-text.js'
+export {labelEnd} from './lib/label-end.js'
+export {labelStartImage} from './lib/label-start-image.js'
+export {labelStartLink} from './lib/label-start-link.js'
+export {lineEnding} from './lib/line-ending.js'
+export {list} from './lib/list.js'
+export {setextUnderline} from './lib/setext-underline.js'
+export {thematicBreak} from './lib/thematic-break.js'

package/node_modules/micromark-core-commonmark/dev/lib/attention.d.ts

@@ -0,0 +1,4 @@
+/** @type {Construct} */
+export const attention: Construct;
+import type { Construct } from 'micromark-util-types';
+//# sourceMappingURL=attention.d.ts.map

package/node_modules/micromark-core-commonmark/dev/lib/attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["attention.js"],"names":[],"mappings":"AAoBA,wBAAwB;AACxB,wBADW,SAAS,CAKnB;+BAdS,sBAAsB"}

package/node_modules/micromark-core-commonmark/dev/lib/attention.js

@@ -0,0 +1,294 @@
+/**
+ * @import {
+ *   Code,
+ *   Construct,
+ *   Event,
+ *   Point,
+ *   Resolver,
+ *   State,
+ *   TokenizeContext,
+ *   Tokenizer,
+ *   Token
+ * } from 'micromark-util-types'
+ */
+
+import {ok as assert} from 'devlop'
+import {push, splice} from 'micromark-util-chunked'
+import {classifyCharacter} from 'micromark-util-classify-character'
+import {resolveAll} from 'micromark-util-resolve-all'
+import {codes, constants, types} from 'micromark-util-symbol'
+
+/** @type {Construct} */
+export const attention = {
+  name: 'attention',
+  resolveAll: resolveAllAttention,
+  tokenize: tokenizeAttention
+}
+
+/**
+ * Take all events and resolve attention to emphasis or strong.
+ *
+ * @type {Resolver}
+ */
+// eslint-disable-next-line complexity
+function resolveAllAttention(events, context) {
+  let index = -1
+  /** @type {Array<Event>} */
+  let nextEvents
+
+  // Walk through all events.
+  //
+  // Note: performance of this is fine on an mb of normal markdown, but it’s
+  // a bottleneck for malicious stuff.
+  while (++index < events.length) {
+    // Find a token that can close.
+    if (
+      events[index][0] === 'enter' &&
+      events[index][1].type === 'attentionSequence' &&
+      events[index][1]._close
+    ) {
+      let open = index
+
+      // Now walk back to find an opener.
+      while (open--) {
+        // Find a token that can open the closer.
+        if (
+          events[open][0] === 'exit' &&
+          events[open][1].type === 'attentionSequence' &&
+          events[open][1]._open &&
+          // If the markers are the same:
+          context.sliceSerialize(events[open][1]).charCodeAt(0) ===
+            context.sliceSerialize(events[index][1]).charCodeAt(0)
+        ) {
+          // If the opening can close or the closing can open,
+          // and the close size *is not* a multiple of three,
+          // but the sum of the opening and closing size *is* multiple of three,
+          // then don’t match.
+          if (
+            (events[open][1]._close || events[index][1]._open) &&
+            (events[index][1].end.offset - events[index][1].start.offset) % 3 &&
+            !(
+              (events[open][1].end.offset -
+                events[open][1].start.offset +
+                events[index][1].end.offset -
+                events[index][1].start.offset) %
+              3
+            )
+          ) {
+            continue
+          }
+
+          // Number of markers to use from the sequence.
+          const use =
+            events[open][1].end.offset - events[open][1].start.offset > 1 &&
+            events[index][1].end.offset - events[index][1].start.offset > 1
+              ? 2
+              : 1
+
+          const start = {...events[open][1].end}
+          const end = {...events[index][1].start}
+          movePoint(start, -use)
+          movePoint(end, use)
+
+          const openingSequence = {
+            type: use > 1 ? types.strongSequence : types.emphasisSequence,
+            start,
+            end: {...events[open][1].end}
+          }
+          const closingSequence = {
+            type: use > 1 ? types.strongSequence : types.emphasisSequence,
+            start: {...events[index][1].start},
+            end
+          }
+          const text = {
+            type: use > 1 ? types.strongText : types.emphasisText,
+            start: {...events[open][1].end},
+            end: {...events[index][1].start}
+          }
+          const group = {
+            type: use > 1 ? types.strong : types.emphasis,
+            start: {...openingSequence.start},
+            end: {...closingSequence.end}
+          }
+
+          events[open][1].end = {...openingSequence.start}
+          events[index][1].start = {...closingSequence.end}
+
+          nextEvents = []
+
+          // If there are more markers in the opening, add them before.
+          if (events[open][1].end.offset - events[open][1].start.offset) {
+            nextEvents = push(nextEvents, [
+              ['enter', events[open][1], context],
+              ['exit', events[open][1], context]
+            ])
+          }
+
+          // Opening.
+          nextEvents = push(nextEvents, [
+            ['enter', group, context],
+            ['enter', openingSequence, context],
+            ['exit', openingSequence, context],
+            ['enter', text, context]
+          ])
+
+          // Always populated by defaults.
+          assert(
+            context.parser.constructs.insideSpan.null,
+            'expected `insideSpan` to be populated'
+          )
+
+          // Between.
+          nextEvents = push(
+            nextEvents,
+            resolveAll(
+              context.parser.constructs.insideSpan.null,
+              events.slice(open + 1, index),
+              context
+            )
+          )
+
+          // Closing.
+          nextEvents = push(nextEvents, [
+            ['exit', text, context],
+            ['enter', closingSequence, context],
+            ['exit', closingSequence, context],
+            ['exit', group, context]
+          ])
+
+          /** @type {number} */
+          let offset = 0
+
+          // If there are more markers in the closing, add them after.
+          if (events[index][1].end.offset - events[index][1].start.offset) {
+            offset = 2
+            nextEvents = push(nextEvents, [
+              ['enter', events[index][1], context],
+              ['exit', events[index][1], context]
+            ])
+          }
+
+          splice(events, open - 1, index - open + 3, nextEvents)
+
+          index = open + nextEvents.length - offset - 2
+          break
+        }
+      }
+    }
+  }
+
+  // Remove remaining sequences.
+  index = -1
+
+  while (++index < events.length) {
+    if (events[index][1].type === 'attentionSequence') {
+      events[index][1].type = 'data'
+    }
+  }
+
+  return events
+}
+
+/**
+ * @this {TokenizeContext}
+ *   Context.
+ * @type {Tokenizer}
+ */
+function tokenizeAttention(effects, ok) {
+  const attentionMarkers = this.parser.constructs.attentionMarkers.null
+  const previous = this.previous
+  const before = classifyCharacter(previous)
+
+  /** @type {NonNullable<Code>} */
+  let marker
+
+  return start
+
+  /**
+   * Before a sequence.
+   *
+   * ```markdown
+   * > | **
+   *     ^
+   * ```
+   *
+   * @type {State}
+   */
+  function start(code) {
+    assert(
+      code === codes.asterisk || code === codes.underscore,
+      'expected asterisk or underscore'
+    )
+    marker = code
+    effects.enter('attentionSequence')
+    return inside(code)
+  }
+
+  /**
+   * In a sequence.
+   *
+   * ```markdown
+   * > | **
+   *     ^^
+   * ```
+   *
+   * @type {State}
+   */
+  function inside(code) {
+    if (code === marker) {
+      effects.consume(code)
+      return inside
+    }
+
+    const token = effects.exit('attentionSequence')
+
+    // To do: next major: move this to resolver, just like `markdown-rs`.
+    const after = classifyCharacter(code)
+
+    // Always populated by defaults.
+    assert(attentionMarkers, 'expected `attentionMarkers` to be populated')
+
+    // Note: `*` and `_` are in `attentionMarkers` through core.
+    // They are excluded here as the loosening is meant for markers registered
+    // by *other* constructs (such as GFM strikethrough’s `~`).
+    const open =
+      !after ||
+      (after === constants.characterGroupPunctuation && before) ||
+      (attentionMarkers.includes(code) &&
+        code !== codes.asterisk &&
+        code !== codes.underscore)
+    const close =
+      !before ||
+      (before === constants.characterGroupPunctuation && after) ||
+      (attentionMarkers.includes(previous) &&
+        previous !== codes.asterisk &&
+        previous !== codes.underscore)
+
+    token._open = Boolean(
+      marker === codes.asterisk ? open : open && (before || !close)
+    )
+    token._close = Boolean(
+      marker === codes.asterisk ? close : close && (after || !open)
+    )
+    return ok(code)
+  }
+}
+
+/**
+ * Move a point a bit.
+ *
+ * Note: `move` only works inside lines! It’s not possible to move past other
+ * chunks (replacement characters, tabs, or line endings).
+ *
+ * @param {Point} point
+ *   Point.
+ * @param {number} offset
+ *   Amount to move.
+ * @returns {undefined}
+ *   Nothing.
+ */
+function movePoint(point, offset) {
+  point.column += offset
+  point.offset += offset
+  point._bufferIndex += offset
+}

package/node_modules/micromark-core-commonmark/dev/lib/autolink.d.ts

@@ -0,0 +1,4 @@
+/** @type {Construct} */
+export const autolink: Construct;
+import type { Construct } from 'micromark-util-types';
+//# sourceMappingURL=autolink.d.ts.map

package/node_modules/micromark-core-commonmark/dev/lib/autolink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autolink.d.ts","sourceRoot":"","sources":["autolink.js"],"names":[],"mappings":"AAkBA,wBAAwB;AACxB,uBADW,SAAS,CACkD;+BAb5D,sBAAsB"}