pi-umbra 0.1.4 → 0.2.0

package/node_modules/regex-utilities/src/index.js

@@ -0,0 +1,170 @@
+// Constant properties for tracking regex syntax context
+export const Context = Object.freeze({
+  DEFAULT: 'DEFAULT',
+  CHAR_CLASS: 'CHAR_CLASS',
+});
+
+/**
+Replaces all unescaped instances of a regex pattern in the given context, using a replacement
+string or callback.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {string | (match: RegExpExecArray, details: {
+  context: 'DEFAULT' | 'CHAR_CLASS';
+  negated: boolean;
+}) => string} replacement
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+@returns {string} Updated expression
+@example
+const str = '.\\.\\\\.[[\\.].].';
+replaceUnescaped(str, '\\.', '@');
+// → '@\\.\\\\@[[\\.]@]@'
+replaceUnescaped(str, '\\.', '@', Context.DEFAULT);
+// → '@\\.\\\\@[[\\.].]@'
+replaceUnescaped(str, '\\.', '@', Context.CHAR_CLASS);
+// → '.\\.\\\\.[[\\.]@].'
+*/
+export function replaceUnescaped(expression, needle, replacement, context) {
+  const re = new RegExp(String.raw`${needle}|(?<$skip>\[\^?|\\?.)`, 'gsu');
+  const negated = [false];
+  let numCharClassesOpen = 0;
+  let result = '';
+  for (const match of expression.matchAll(re)) {
+    const {0: m, groups: {$skip}} = match;
+    if (!$skip && (!context || (context === Context.DEFAULT) === !numCharClassesOpen)) {
+      if (replacement instanceof Function) {
+        result += replacement(match, {
+          context: numCharClassesOpen ? Context.CHAR_CLASS : Context.DEFAULT,
+          negated: negated[negated.length - 1],
+        });
+      } else {
+        result += replacement;
+      }
+      continue;
+    }
+    if (m[0] === '[') {
+      numCharClassesOpen++;
+      negated.push(m[1] === '^');
+    } else if (m === ']' && numCharClassesOpen) {
+      numCharClassesOpen--;
+      negated.pop();
+    }
+    result += m;
+  }
+  return result;
+}
+
+/**
+Runs a callback for each unescaped instance of a regex pattern in the given context.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {(match: RegExpExecArray, details: {
+  context: 'DEFAULT' | 'CHAR_CLASS';
+  negated: boolean;
+}) => void} callback
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+*/
+export function forEachUnescaped(expression, needle, callback, context) {
+  // Do this the easy way
+  replaceUnescaped(expression, needle, callback, context);
+}
+
+/**
+Returns a match object for the first unescaped instance of a regex pattern in the given context, or
+`null`.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {number} [pos] Offset to start the search
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+@returns {RegExpExecArray | null}
+*/
+export function execUnescaped(expression, needle, pos = 0, context) {
+  // Quick partial test; avoid the loop if not needed
+  if (!(new RegExp(needle, 'su').test(expression))) {
+    return null;
+  }
+  const re = new RegExp(`${needle}|(?<$skip>\\\\?.)`, 'gsu');
+  re.lastIndex = pos;
+  let numCharClassesOpen = 0;
+  let match;
+  while (match = re.exec(expression)) {
+    const {0: m, groups: {$skip}} = match;
+    if (!$skip && (!context || (context === Context.DEFAULT) === !numCharClassesOpen)) {
+      return match;
+    }
+    if (m === '[') {
+      numCharClassesOpen++;
+    } else if (m === ']' && numCharClassesOpen) {
+      numCharClassesOpen--;
+    }
+    // Avoid an infinite loop on zero-length matches
+    if (re.lastIndex == match.index) {
+      re.lastIndex++;
+    }
+  }
+  return null;
+}
+
+/**
+Checks whether an unescaped instance of a regex pattern appears in the given context.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+@returns {boolean} Whether the pattern was found
+*/
+export function hasUnescaped(expression, needle, context) {
+  // Do this the easy way
+  return !!execUnescaped(expression, needle, 0, context);
+}
+
+/**
+Extracts the full contents of a group (subpattern) from the given expression, accounting for
+escaped characters, nested groups, and character classes. The group is identified by the position
+where its contents start (the string index just after the group's opening delimiter). Returns the
+rest of the string if the group is unclosed.
+
+Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {number} contentsStartPos
+@returns {string}
+*/
+export function getGroupContents(expression, contentsStartPos) {
+  const token = /\\?./gsu;
+  token.lastIndex = contentsStartPos;
+  let contentsEndPos = expression.length;
+  let numCharClassesOpen = 0;
+  // Starting search within an open group, after the group's opening
+  let numGroupsOpen = 1;
+  let match;
+  while (match = token.exec(expression)) {
+    const [m] = match;
+    if (m === '[') {
+      numCharClassesOpen++;
+    } else if (!numCharClassesOpen) {
+      if (m === '(') {
+        numGroupsOpen++;
+      } else if (m === ')') {
+        numGroupsOpen--;
+        if (!numGroupsOpen) {
+          contentsEndPos = match.index;
+          break;
+        }
+      }
+    } else if (m === ']') {
+      numCharClassesOpen--;
+    }
+  }
+  return expression.slice(contentsStartPos, contentsEndPos);
+}

package/node_modules/regex-utilities/types/index.d.ts

@@ -0,0 +1,84 @@
+/**
+Replaces all unescaped instances of a regex pattern in the given context, using a replacement
+string or callback.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {string | (match: RegExpExecArray, details: {
+  context: 'DEFAULT' | 'CHAR_CLASS';
+  negated: boolean;
+}) => string} replacement
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+@returns {string} Updated expression
+@example
+const str = '.\\.\\\\.[[\\.].].';
+replaceUnescaped(str, '\\.', '@');
+// → '@\\.\\\\@[[\\.]@]@'
+replaceUnescaped(str, '\\.', '@', Context.DEFAULT);
+// → '@\\.\\\\@[[\\.].]@'
+replaceUnescaped(str, '\\.', '@', Context.CHAR_CLASS);
+// → '.\\.\\\\.[[\\.]@].'
+*/
+export function replaceUnescaped(expression: string, needle: string, replacement: string | ((match: RegExpExecArray, details: {
+    context: "DEFAULT" | "CHAR_CLASS";
+    negated: boolean;
+}) => string), context?: "DEFAULT" | "CHAR_CLASS"): string;
+/**
+Runs a callback for each unescaped instance of a regex pattern in the given context.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {(match: RegExpExecArray, details: {
+  context: 'DEFAULT' | 'CHAR_CLASS';
+  negated: boolean;
+}) => void} callback
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+*/
+export function forEachUnescaped(expression: string, needle: string, callback: (match: RegExpExecArray, details: {
+    context: "DEFAULT" | "CHAR_CLASS";
+    negated: boolean;
+}) => void, context?: "DEFAULT" | "CHAR_CLASS"): void;
+/**
+Returns a match object for the first unescaped instance of a regex pattern in the given context, or
+`null`.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {number} [pos] Offset to start the search
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+@returns {RegExpExecArray | null}
+*/
+export function execUnescaped(expression: string, needle: string, pos?: number, context?: "DEFAULT" | "CHAR_CLASS"): RegExpExecArray | null;
+/**
+Checks whether an unescaped instance of a regex pattern appears in the given context.
+
+Doesn't skip over complete multicharacter tokens (only `\` plus its folowing char) so must be used
+with knowledge of what's safe to do given regex syntax. Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {string} needle Search as a regex pattern, with flags `su` applied
+@param {'DEFAULT' | 'CHAR_CLASS'} [context] All contexts if not specified
+@returns {boolean} Whether the pattern was found
+*/
+export function hasUnescaped(expression: string, needle: string, context?: "DEFAULT" | "CHAR_CLASS"): boolean;
+/**
+Extracts the full contents of a group (subpattern) from the given expression, accounting for
+escaped characters, nested groups, and character classes. The group is identified by the position
+where its contents start (the string index just after the group's opening delimiter). Returns the
+rest of the string if the group is unclosed.
+
+Assumes UnicodeSets-mode syntax.
+@param {string} expression Search target
+@param {number} contentsStartPos
+@returns {string}
+*/
+export function getGroupContents(expression: string, contentsStartPos: number): string;
+export const Context: Readonly<{
+    DEFAULT: "DEFAULT";
+    CHAR_CLASS: "CHAR_CLASS";
+}>;

package/node_modules/shiki/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2021 Pine Wu
+Copyright (c) 2023 Anthony Fu <https://github.com/antfu>
+
+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/shiki/README.md

@@ -0,0 +1,15 @@
+<img src="https://raw.githubusercontent.com/shikijs/shiki/main/docs/public/logo.svg" width="150" alt="Shiki Logo" />
+
+# Shiki 式
+
+[![NPM version](https://img.shields.io/npm/v/shiki?color=32A9C3&labelColor=1B3C4A&label=npm)](https://www.npmjs.com/package/shiki)
+[![NPM downloads](https://img.shields.io/npm/dm/shiki?color=32A9C3&labelColor=1B3C4A&label=downloads)](https://www.npmjs.com/package/shiki)
+[![Codecov](https://img.shields.io/codecov/c/github/shikijs/shiki?token=B85J0E2I7I&style=flat&labelColor=1B3C4A&color=32A9C3&precision=1)](https://app.codecov.io/gh/shikijs/shiki)
+
+A beautiful syntax highlighter based on TextMate grammars, accurate and powerful.
+
+[📚 **Documentation**](https://shiki.style)
+
+## License
+
+[MIT](./LICENSE)

package/node_modules/shiki/dist/bundle-full.d.mts

@@ -0,0 +1,21 @@
+import { a as bundledLanguagesInfo, i as bundledLanguagesBase, n as bundledLanguages, r as bundledLanguagesAlias, t as BundledLanguage } from "./langs-bundle-full-B4n9xYHw.mjs";
+import { n as bundledThemes, r as bundledThemesInfo, t as BundledTheme } from "./themes-BKdFAJ1v.mjs";
+import "./core-CaxrMD1A.mjs";
+import { HighlighterGeneric } from "@shikijs/types";
+export * from "@shikijs/core";
+//#region src/bundle-full.d.ts
+type Highlighter = HighlighterGeneric<BundledLanguage, BundledTheme>;
+/**
+ * Initiate a highlighter instance and load the specified languages and themes.
+ * Later it can be used synchronously to highlight code.
+ *
+ * Importing this function will bundle all languages and themes.
+ * @see https://shiki.style/guide/bundles#shiki-bundle-full
+ *
+ * For granular control over the bundle, check:
+ * @see https://shiki.style/guide/bundles#fine-grained-bundle
+ */
+declare const createHighlighter: import("@shikijs/types").CreateHighlighterFactory<BundledLanguage, BundledTheme>;
+declare const codeToHtml: (code: string, options: import("@shikijs/types").CodeToHastOptions<BundledLanguage, BundledTheme>) => Promise<string>, codeToHast: (code: string, options: import("@shikijs/types").CodeToHastOptions<BundledLanguage, BundledTheme>) => Promise<import("hast").Root>, codeToTokens: (code: string, options: import("@shikijs/types").CodeToTokensOptions<BundledLanguage, BundledTheme>) => Promise<import("@shikijs/types").TokensResult>, codeToTokensBase: (code: string, options: import("@shikijs/types").RequireKeys<import("@shikijs/types").CodeToTokensBaseOptions<BundledLanguage, BundledTheme>, "theme" | "lang">) => Promise<import("@shikijs/types").ThemedToken[][]>, codeToTokensWithThemes: (code: string, options: import("@shikijs/types").RequireKeys<import("@shikijs/types").CodeToTokensWithThemesOptions<BundledLanguage, BundledTheme>, "lang" | "themes">) => Promise<import("@shikijs/types").ThemedTokenWithVariants[][]>, getSingletonHighlighter: (options?: Partial<import("@shikijs/types").BundledHighlighterOptions<BundledLanguage, BundledTheme>> | undefined) => Promise<HighlighterGeneric<BundledLanguage, BundledTheme>>, getLastGrammarState: ((element: import("@shikijs/types").ThemedToken[][] | import("hast").Root) => import("@shikijs/types").GrammarState) | ((code: string, options: import("@shikijs/types").CodeToTokensBaseOptions<BundledLanguage, BundledTheme>) => Promise<import("@shikijs/types").GrammarState>);
+//#endregion
+export { BundledLanguage, BundledTheme, Highlighter, bundledLanguages, bundledLanguagesAlias, bundledLanguagesBase, bundledLanguagesInfo, bundledThemes, bundledThemesInfo, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createHighlighter, getLastGrammarState, getSingletonHighlighter };

package/node_modules/shiki/dist/bundle-full.mjs

@@ -0,0 +1,25 @@
+import "./rolldown-runtime-BBjsoOtd.mjs";
+import { t as engine_oniguruma_exports } from "./engine-oniguruma.mjs";
+import { i as bundledLanguagesInfo, n as bundledLanguagesAlias, r as bundledLanguagesBase, t as bundledLanguages } from "./langs-bundle-full-xQVO1Cek.mjs";
+import { bundledThemes, bundledThemesInfo } from "./themes.mjs";
+import { createBundledHighlighter, createSingletonShorthands, guessEmbeddedLanguages } from "@shikijs/core";
+export * from "@shikijs/core";
+//#region src/bundle-full.ts
+/**
+* Initiate a highlighter instance and load the specified languages and themes.
+* Later it can be used synchronously to highlight code.
+*
+* Importing this function will bundle all languages and themes.
+* @see https://shiki.style/guide/bundles#shiki-bundle-full
+*
+* For granular control over the bundle, check:
+* @see https://shiki.style/guide/bundles#fine-grained-bundle
+*/
+const createHighlighter = /* @__PURE__ */ createBundledHighlighter({
+	langs: bundledLanguages,
+	themes: bundledThemes,
+	engine: () => (0, engine_oniguruma_exports.createOnigurumaEngine)(import("shiki/wasm"))
+});
+const { codeToHtml, codeToHast, codeToTokens, codeToTokensBase, codeToTokensWithThemes, getSingletonHighlighter, getLastGrammarState } = /* @__PURE__ */ createSingletonShorthands(createHighlighter, { guessEmbeddedLanguages });
+//#endregion
+export { bundledLanguages, bundledLanguagesAlias, bundledLanguagesBase, bundledLanguagesInfo, bundledThemes, bundledThemesInfo, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createHighlighter, getLastGrammarState, getSingletonHighlighter };

package/node_modules/shiki/dist/bundle-web.d.mts

@@ -0,0 +1,31 @@
+import { n as bundledThemes, r as bundledThemesInfo, t as BundledTheme } from "./themes-BKdFAJ1v.mjs";
+import "./core-CaxrMD1A.mjs";
+import { BundledLanguageInfo, DynamicImportLanguageRegistration, HighlighterGeneric } from "@shikijs/types";
+export * from "@shikijs/core";
+//#region src/langs-bundle-web.d.ts
+declare const bundledLanguagesInfo: BundledLanguageInfo[];
+declare const bundledLanguagesBase: {
+  [k: string]: DynamicImportLanguageRegistration;
+};
+declare const bundledLanguagesAlias: {
+  [k: string]: DynamicImportLanguageRegistration;
+};
+type BundledLanguage = 'angular-html' | 'angular-ts' | 'astro' | 'bash' | 'blade' | 'c' | 'c++' | 'cjs' | 'coffee' | 'coffeescript' | 'cpp' | 'css' | 'csv' | 'cts' | 'glsl' | 'gql' | 'graphql' | 'haml' | 'handlebars' | 'hbs' | 'html' | 'html-derivative' | 'http' | 'hurl' | 'imba' | 'jade' | 'java' | 'javascript' | 'jinja' | 'jison' | 'jl' | 'js' | 'json' | 'json5' | 'jsonc' | 'jsonl' | 'jsx' | 'julia' | 'less' | 'lit' | 'markdown' | 'marko' | 'md' | 'mdc' | 'mdx' | 'mjs' | 'mts' | 'php' | 'postcss' | 'pug' | 'py' | 'python' | 'r' | 'regex' | 'regexp' | 'sass' | 'scss' | 'sh' | 'shell' | 'shellscript' | 'smithy' | 'sql' | 'styl' | 'stylus' | 'svelte' | 'ts' | 'ts-tags' | 'tsx' | 'typescript' | 'vue' | 'vue-html' | 'vue-vine' | 'wasm' | 'wgsl' | 'wit' | 'xml' | 'yaml' | 'yml' | 'zsh';
+declare const bundledLanguages: Record<BundledLanguage, DynamicImportLanguageRegistration>;
+//#endregion
+//#region src/bundle-web.d.ts
+type Highlighter = HighlighterGeneric<BundledLanguage, BundledTheme>;
+/**
+ * Initiate a highlighter instance and load the specified languages and themes.
+ * Later it can be used synchronously to highlight code.
+ *
+ * Importing this function will bundle all languages and themes.
+ * @see https://shiki.style/guide/bundles#shiki-bundle-web
+ *
+ * For granular control over the bundle, check:
+ * @see https://shiki.style/guide/bundles#fine-grained-bundle
+ */
+declare const createHighlighter: import("@shikijs/types").CreateHighlighterFactory<BundledLanguage, BundledTheme>;
+declare const codeToHtml: (code: string, options: import("@shikijs/types").CodeToHastOptions<BundledLanguage, BundledTheme>) => Promise<string>, codeToHast: (code: string, options: import("@shikijs/types").CodeToHastOptions<BundledLanguage, BundledTheme>) => Promise<import("hast").Root>, codeToTokensBase: (code: string, options: import("@shikijs/types").RequireKeys<import("@shikijs/types").CodeToTokensBaseOptions<BundledLanguage, BundledTheme>, "theme" | "lang">) => Promise<import("@shikijs/types").ThemedToken[][]>, codeToTokens: (code: string, options: import("@shikijs/types").CodeToTokensOptions<BundledLanguage, BundledTheme>) => Promise<import("@shikijs/types").TokensResult>, codeToTokensWithThemes: (code: string, options: import("@shikijs/types").RequireKeys<import("@shikijs/types").CodeToTokensWithThemesOptions<BundledLanguage, BundledTheme>, "lang" | "themes">) => Promise<import("@shikijs/types").ThemedTokenWithVariants[][]>, getSingletonHighlighter: (options?: Partial<import("@shikijs/types").BundledHighlighterOptions<BundledLanguage, BundledTheme>> | undefined) => Promise<HighlighterGeneric<BundledLanguage, BundledTheme>>, getLastGrammarState: ((element: import("@shikijs/types").ThemedToken[][] | import("hast").Root) => import("@shikijs/types").GrammarState) | ((code: string, options: import("@shikijs/types").CodeToTokensBaseOptions<BundledLanguage, BundledTheme>) => Promise<import("@shikijs/types").GrammarState>);
+//#endregion
+export { BundledLanguage, BundledTheme, Highlighter, bundledLanguages, bundledLanguagesAlias, bundledLanguagesBase, bundledLanguagesInfo, bundledThemes, bundledThemesInfo, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createHighlighter, getLastGrammarState, getSingletonHighlighter };