taskchef 8.6.2 → 8.7.1

package/node_modules/mdast-util-from-markdown/lib/types.d.ts

@@ -0,0 +1,295 @@
+import type {Nodes, Parent, PhrasingContent, Root} from 'mdast'
+import type {ParseOptions, TokenizeContext, Token} from 'micromark-util-types'
+
+/**
+ * Compiler context.
+ */
+export interface CompileContext {
+  /**
+   * Configuration.
+   */
+  config: Config
+  /**
+   * Info passed around;
+   * key/value store.
+   */
+  data: CompileData
+  /**
+   * Stack of nodes.
+   */
+  stack: Array<Fragment | Nodes>
+  /**
+   * Stack of tokens.
+   */
+  tokenStack: Array<TokenTuple>
+
+  /**
+   * Capture some of the output data.
+   *
+   * @param this
+   *   Context.
+   * @returns
+   *   Nothing.
+   */
+  buffer(this: CompileContext): undefined
+
+  /**
+   * Enter a node.
+   *
+   * @param this
+   *   Context.
+   * @param node
+   *   Node.
+   * @param token
+   *   Token.
+   * @param onError
+   *   Error handler.
+   * @returns
+   *   Nothing.
+   */
+  enter(
+    this: CompileContext,
+    node: Nodes,
+    token: Token,
+    onError?: OnEnterError | null | undefined
+  ): undefined
+
+  /**
+   * Exit a node.
+   *
+   * @param this
+   *   Context.
+   * @param token
+   *   Token.
+   * @param onError
+   *   Error handler.
+   * @returns
+   *   Nothing.
+   */
+  exit(
+    this: CompileContext,
+    token: Token,
+    onError?: OnExitError | null | undefined
+  ): undefined
+
+  /**
+   * Stop capturing and access the output data.
+   *
+   * @param this
+   *   Context.
+   * @returns
+   *   Nothing.
+   */
+  resume(this: CompileContext): string
+
+  /**
+   * Get the source text that spans a token (or location).
+   *
+   * @param token
+   *   Start/end in stream.
+   * @param expandTabs
+   *   Whether to expand tabs.
+   * @returns
+   *   Serialized chunks.
+   */
+  sliceSerialize(
+    token: Pick<Token, 'end' | 'start'>,
+    expandTabs?: boolean | undefined
+  ): string
+}
+
+/**
+ * Interface of tracked data.
+ *
+ * When working on extensions that use more data, extend the corresponding
+ * interface to register their types:
+ *
+ * ```ts
+ * declare module 'mdast-util-from-markdown' {
+ *   interface CompileData {
+ *     // Register a new field.
+ *     mathFlowInside?: boolean | undefined
+ *   }
+ * }
+ * ```
+ */
+export interface CompileData {
+  /**
+   * Whether we’re inside a hard break.
+   */
+  atHardBreak?: boolean | undefined
+
+  /**
+   * Current character reference type.
+   */
+  characterReferenceType?:
+    | 'characterReferenceMarkerHexadecimal'
+    | 'characterReferenceMarkerNumeric'
+    | undefined
+
+  /**
+   * Whether a first list item value (`1` in `1. a`) is expected.
+   */
+  expectingFirstListItemValue?: boolean | undefined
+
+  /**
+   * Whether we’re in flow code.
+   */
+  flowCodeInside?: boolean | undefined
+
+  /**
+   * Whether we’re in a reference.
+   */
+  inReference?: boolean | undefined
+
+  /**
+   * Whether we’re expecting a line ending from a setext heading, which can be slurped.
+   */
+  setextHeadingSlurpLineEnding?: boolean | undefined
+
+  /**
+   * Current reference.
+   */
+  referenceType?: 'collapsed' | 'full' | undefined
+}
+
+/**
+ * Configuration.
+ *
+ * We have our defaults, but extensions will add more.
+ */
+export interface Config {
+  /**
+   * Token types where line endings are used.
+   */
+  canContainEols: Array<string>
+  /**
+   * Opening handles.
+   */
+  enter: Handles
+  /**
+   * Closing handles.
+   */
+  exit: Handles
+  /**
+   * Tree transforms.
+   */
+  transforms: Array<Transform>
+}
+
+/**
+ * Change how markdown tokens from micromark are turned into mdast.
+ */
+export interface Extension {
+  /**
+   * Token types where line endings are used.
+   */
+  canContainEols?: Array<string> | null | undefined
+  /**
+   * Opening handles.
+   */
+  enter?: Handles | null | undefined
+  /**
+   * Closing handles.
+   */
+  exit?: Handles | null | undefined
+  /**
+   * Tree transforms.
+   */
+  transforms?: Array<Transform> | null | undefined
+}
+
+/**
+ * Internal fragment.
+ */
+export interface Fragment extends Parent {
+  /**
+   * Node type.
+   */
+  type: 'fragment'
+  /**
+   * Children.
+   */
+  children: Array<PhrasingContent>
+}
+
+/**
+ * Token types mapping to handles
+ */
+export type Handles = Record<string, Handle>
+
+/**
+ * Handle a token.
+ *
+ * @param this
+ *   Context.
+ * @param token
+ *   Current token.
+ * @returns
+ *   Nothing.
+ */
+export type Handle = (this: CompileContext, token: Token) => undefined | void
+
+/**
+ * Handle the case where the `right` token is open, but it is closed (by the
+ * `left` token) or because we reached the end of the document.
+ *
+ * @param this
+ *   Context.
+ * @param left
+ *   Left token.
+ * @param right
+ *   Right token.
+ * @returns
+ *   Nothing.
+ */
+export type OnEnterError = (
+  this: Omit<CompileContext, 'sliceSerialize'>,
+  left: Token | undefined,
+  right: Token
+) => undefined
+
+/**
+ * Handle the case where the `right` token is open but it is closed by
+ * exiting the `left` token.
+ *
+ * @param this
+ *   Context.
+ * @param left
+ *   Left token.
+ * @param right
+ *   Right token.
+ * @returns
+ *   Nothing.
+ */
+export type OnExitError = (
+  this: Omit<CompileContext, 'sliceSerialize'>,
+  left: Token,
+  right: Token
+) => undefined
+
+/**
+ * Configuration.
+ */
+export interface Options extends ParseOptions {
+  /**
+   * Extensions for this utility to change how tokens are turned into a tree.
+   */
+  mdastExtensions?: Array<Extension | Array<Extension>> | null | undefined
+}
+
+/**
+ * Open token on the stack,
+ * with an optional error handler for when that token isn’t closed properly.
+ */
+export type TokenTuple = [token: Token, onError: OnEnterError | undefined]
+
+/**
+ * Extra transform, to change the AST afterwards.
+ *
+ * @param tree
+ *   Tree to transform.
+ * @returns
+ *   New tree or nothing (in which case the current tree is used).
+ */
+export type Transform = (tree: Root) => Root | null | undefined | void

package/node_modules/mdast-util-from-markdown/lib/types.js

@@ -0,0 +1,2 @@
+// Note: types exposed from `types.d.ts`.
+export {};

package/node_modules/mdast-util-from-markdown/license

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) Titus Wormer <tituswormer@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/mdast-util-from-markdown/package.json

@@ -0,0 +1,139 @@
+{
+  "author": "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",
+  "bugs": "https://github.com/syntax-tree/mdast-util-from-markdown/issues",
+  "contributors": [
+    "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)"
+  ],
+  "dependencies": {
+    "@types/mdast": "^4.0.0",
+    "@types/unist": "^3.0.0",
+    "decode-named-character-reference": "^1.0.0",
+    "devlop": "^1.0.0",
+    "mdast-util-to-string": "^4.0.0",
+    "micromark": "^4.0.0",
+    "micromark-util-decode-numeric-character-reference": "^2.0.0",
+    "micromark-util-decode-string": "^2.0.0",
+    "micromark-util-normalize-identifier": "^2.0.0",
+    "micromark-util-symbol": "^2.0.0",
+    "micromark-util-types": "^2.0.0",
+    "unist-util-stringify-position": "^4.0.0"
+  },
+  "description": "mdast utility to parse markdown",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "c8": "^10.0.0",
+    "commonmark.json": "^0.31.0",
+    "esbuild": "^0.24.0",
+    "gzip-size-cli": "^5.0.0",
+    "hast-util-from-html": "^2.0.0",
+    "hast-util-to-html": "^9.0.0",
+    "mdast-util-to-hast": "^13.0.0",
+    "micromark-build": "^2.0.0",
+    "prettier": "^3.0.0",
+    "remark-cli": "^12.0.0",
+    "remark-preset-wooorm": "^10.0.0",
+    "terser": "^5.0.0",
+    "type-coverage": "^2.0.0",
+    "typescript": "^5.0.0",
+    "xo": "^0.59.0"
+  },
+  "exports": {
+    "development": "./dev/index.js",
+    "default": "./index.js"
+  },
+  "files": [
+    "dev/",
+    "lib/",
+    "index.d.ts",
+    "index.js"
+  ],
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/unified"
+  },
+  "keywords": [
+    "ast",
+    "markdown",
+    "markup",
+    "mdast-util",
+    "mdast",
+    "parse",
+    "syntax",
+    "tree",
+    "unist",
+    "utility",
+    "util"
+  ],
+  "license": "MIT",
+  "name": "mdast-util-from-markdown",
+  "prettier": {
+    "bracketSpacing": false,
+    "semi": false,
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "none",
+    "useTabs": false
+  },
+  "remarkConfig": {
+    "plugins": [
+      "remark-preset-wooorm"
+    ]
+  },
+  "repository": "syntax-tree/mdast-util-from-markdown",
+  "scripts": {
+    "build": "tsc --build --clean && tsc --build && type-coverage && micromark-build && esbuild . --bundle --minify | terser | gzip-size --raw",
+    "format": "remark --frail --quiet --output -- . && prettier --log-level warn --write -- . && xo --fix",
+    "test-api-dev": "node --conditions development test/index.js",
+    "test-api-prod": "node --conditions production test/index.js",
+    "test-api": "npm run test-api-dev && npm run test-api-prod",
+    "test-coverage": "c8 --100 --reporter lcov -- npm run test-api",
+    "test": "npm run build && npm run format && npm run test-coverage"
+  },
+  "sideEffects": false,
+  "typeCoverage": {
+    "atLeast": 100,
+    "strict": true
+  },
+  "type": "module",
+  "version": "2.0.2",
+  "xo": {
+    "overrides": [
+      {
+        "files": [
+          "**/*.d.ts"
+        ],
+        "rules": {
+          "@typescript-eslint/array-type": [
+            "error",
+            {
+              "default": "generic"
+            }
+          ],
+          "@typescript-eslint/ban-types": [
+            "error",
+            {
+              "extendDefaults": true
+            }
+          ],
+          "@typescript-eslint/consistent-type-definitions": [
+            "error",
+            "interface"
+          ]
+        }
+      },
+      {
+        "files": "test/**/*.js",
+        "rules": {
+          "no-await-in-loop": "off"
+        }
+      }
+    ],
+    "prettier": true,
+    "rules": {
+      "complexity": "off",
+      "max-depth": "off",
+      "unicorn/prefer-at": "off",
+      "unicorn/prefer-string-replace-all": "off"
+    }
+  }
+}