@cyfung1031/prism-code-editor 5.2.0-cdn-esm.0

package/dist/extensions/autocomplete/types.d.ts

@@ -0,0 +1,168 @@
+import { BasicExtension, PrismEditor } from '../../index.js';
+export interface AutoComplete extends BasicExtension {
+    /**
+     * Starts a completion query.
+     * @param explicit When a query is started by this extension, `explicit` gets set to
+     * `true` whenever the query was started with Ctrl+Space, and `false` if the query was
+     * started implicitly while typing.
+     */
+    startQuery(explicit?: boolean): void;
+    /**
+     * Inserts a completion option, replacing the text in the document between `start` and
+     * `end` with the `label` (or `insert` if present) property of the completion. If the
+     * completion has tab stops, these are displayed and can be selected by the user.
+     *
+     * This is very useful to insert snippets since this method will preserve current
+     * indentation on new lines and replace tabs with spaces when `options.insertSpaces`
+     * isn't set to `false`.
+     *
+     * @param completion The completion to insert.
+     * @param start Starting position of the text replaced by the completion.
+     * @param end Ending position of the text replaced by the completion. Defaults to
+     * `start`.
+     */
+    insertCompletion(completion: Completion, start: number, end?: number): void;
+}
+export interface Completion {
+    /**
+     * Label of the option. The label is displayed in the option and used to filter and sort
+     * options. By default, this is the text inserted when the option is selected.
+     */
+    label: string;
+    /**
+     * Can be used to adjust how the completion is ranked compared to other options.
+     * A positive number moves it up the list, while a negative one moves it down.
+     */
+    boost?: number;
+    /** Optional, short piece of information displayed after the label. */
+    detail?: string;
+    /**
+     * Name of the icon shown before the label. This name is appended to the class
+     * `pce-ac-icon-`, so i.e. `.pce-ac-icon-variable` can be used to style icons with the
+     * name `variable`.
+     *
+     * The icon element also gets it color set to the CSS variable `--pce-ac-icon-` followed
+     * by the icon's name. Use these CSS variables to set different colors for different
+     * icons.
+     *
+     * `prism-code-editor/autocomplete-icons.css` adds 14 icons from VSCode: `class`,
+     * `constant`, `enum`, `event`, `function`, `interface`, `keyword`, `namespace`,
+     * `parameter`, `property`, `snippet`, `text`, `unit`, and `variable`. You can import
+     * your own icons instead.
+     *
+     * Defaults to `"variable"`
+     */
+    icon?: "class" | "constant" | "enum" | "event" | "function" | "interface" | "keyword" | "namespace" | "parameter" | "property" | "snippet" | "text" | "unit" | "variable" | (string & {});
+    /**
+     * Text to insert when the completion is selected. Tabs are replaced with spaces when
+     * `options.insertSpaces` isn't set to `false`. The current indentation is preserved
+     * when line feeds (\n) are found.
+     *
+     * If omitted, the inserted text defaults to `label`.
+     */
+    insert?: string;
+    /**
+     * Array of ranges. Each even index defines the start of a range. The subsequent index
+     * defines the end of that range. The ranges are relative to the start of the inserted
+     * text. The first range is selected initially.
+     *
+     * If there are multiple ranges, the Tab key can be used to select the next tab stop.
+     * Once the final tab stop is selected or Escape is pressed, the tab stops disappear.
+     *
+     * The ranges must not overlap.
+     *
+     * If the last range only contains one number, the second defaults to the first.
+     */
+    tabStops?: number[];
+    /**
+     * If this option is selected and the user types a character present in this string,
+     * then the option is inserted right before the character is typed.
+     */
+    commitChars?: string;
+    /**
+     * Optional function to render the contents of an additional tooltip documenting the
+     * completion item.
+     * @param item Completion item to render documentation for.
+     * @param context Current completion context.
+     * @param editor Current editor.
+     * @returns List of nodes to show in the tooltip.
+     */
+    renderDocs?(item: Completion, context: CompletionContext, editor: PrismEditor): (Node | string)[];
+}
+export interface CompletionResult {
+    /** The start of the range that's being completed. */
+    from: number;
+    /**
+     * The end of the range that will be replaced when one of the options is selected.
+     * This is not used when sorting or filtering the options. Defaults to `selectionEnd`.
+     */
+    to?: number;
+    /** The completions returned by the source. */
+    options: Completion[];
+}
+export type CompletionSource<T extends object = object> = (context: CompletionContext & T, editor: PrismEditor) => CompletionResult | undefined | null;
+export interface CompletionContext {
+    /** The code before the cursor. */
+    before: string;
+    /** The line before the cursor. */
+    lineBefore: string;
+    /** The cursor's position in the document. */
+    pos: number;
+    /** The language at the cursor's position. */
+    language: string;
+    /** True if the completion was started explicitly with Ctrl+Space. False otherwise. */
+    explicit: boolean;
+}
+/**
+ * Completion definition for a language.
+ *
+ * The context property can be used to add extra properties to the context
+ * passed to the completion sources. This is useful to do certain computations once
+ * instead of once for each source.
+ */
+export type CompletionDefinition<T extends object> = {
+    context?: null;
+    sources: CompletionSource[];
+} | {
+    context(context: CompletionContext, editor: PrismEditor): T;
+    sources: CompletionSource<T>[];
+};
+export type AutoCompleteConfig = {
+    /** Function used to filter and rank options. */
+    filter: CompletionFilter;
+    /**
+     * If `true`, the tooltip will be placed above the cursor when there's space.
+     * Defaults to `false`.
+     */
+    preferAbove?: boolean;
+    /**
+     * Whether the tooltip should close when the `textarea` loses focus. Defaults to `true`.
+     */
+    closeOnBlur?: boolean;
+    /**
+     * If `true`, the tooltip will only be shown when explicitly opened using Ctrl+Space.
+     * Defaults to `false`.
+     */
+    explicitOnly?: boolean;
+};
+/**
+ * Function that matches an option against the query. If the option matches the query,
+ * the function returns an array containing two entries:
+ * 1) The score of the match. A higher score means a better match.
+ * 2) An array of matched ranges. Each even index defines the start of a range. The
+ * subsequent index defines the end of that range.
+ */
+export type CompletionFilter = (query: string, option: string) => [number, number[]] | undefined;
+/**
+ * Object mapping attribute names to a list of values for that attribute. For attributes
+ * without a predifined list of possible values, the value should be `null`.
+ */
+export type AttributeConfig = {
+    [attrName: string]: null | string[];
+};
+/**
+ * Object mapping tag names to completable attributes for that tag.
+ */
+export type TagConfig = {
+    [tagName: string]: AttributeConfig;
+};

package/dist/extensions/autocomplete/utils.d.ts

@@ -0,0 +1,40 @@
+import { PrismEditor } from '../../index.js';
+import { TokenName } from '../../prism/types.js';
+import { Completion, CompletionContext, CompletionSource } from './types.js';
+declare const optionsFromKeys: (obj: object, icon?: string) => Completion[];
+declare const updateMatched: (container: HTMLElement, matched: number[], text: string) => void;
+/**
+ * Completion source that returns a list of options if `path` property of the context
+ * is present and only contains a single string.
+ * @param options Options to complete.
+ */
+declare const completeFromList: (options: Completion[]) => CompletionSource<{
+    path: string[] | null;
+}>;
+/**
+ * Utility that searches the editor's {@link TokenStream} for strings. This utility will
+ * only search parts of the document whose language has the same completion definition
+ * registered.
+ * @param context Current completion context.
+ * @param editor Editor to search in.
+ * @param filter Function used to filter tokens you want to search in. It's called with
+ * the type of the token and its starting position. If the filter returns true, the token
+ * will be searched.
+ * @param pattern Pattern used to search for words. Must have the `g` flag.
+ * @param init Words that should be completed even if they're not found in the document.
+ * @param tokensOnly If `true` only the text of tokens whose `content` is a string will
+ * be searched. If `false`, any string inside the {@link TokenStream} can be searched.
+ * @returns A set with found identifers/words.
+ */
+declare const findWords: (context: CompletionContext, editor: PrismEditor, filter: (type: TokenName, start: number) => boolean, pattern: RegExp, init?: Iterable<string>, tokensOnly?: boolean) => Set<string>;
+declare const attrSnippet: (name: string, quotes: string, icon?: Completion["icon"], boost?: number) => Completion;
+declare const completionsFromRecords: (records: (Record<string, unknown> | undefined)[], icon?: Completion["icon"]) => Completion[];
+/**
+ * @param snippet String of code to highlight.
+ * @param language Language to highlight the snippet with.
+ * @param className Additional classes to add to the `<pre>` element.
+ * @returns `<pre><code>` element with the snippet highlighted using the specified
+ * language.
+ */
+declare const renderSnippet: (snippet: string, language: string, className?: string) => HTMLPreElement;
+export { optionsFromKeys, updateMatched, findWords, completeFromList, attrSnippet, completionsFromRecords, renderSnippet, };

package/dist/extensions/autocomplete/vue/index.d.ts

@@ -0,0 +1,14 @@
+import { CompletionSource, TagConfig } from '../types.js';
+/**
+ * Completion source that adds completion for HTML and SVG tags to Vue. When configured,
+ * it can also provide completions for specific Vue components.
+ * @param components Used to configure autocompletion for Vue components. This is an
+ * object mapping each component's name to the properties available for that component.
+ * To provide completions for events, prefix them with `on`. E.g. `onevent` will result
+ * in completions for `@event` and `v-on:event`. Camel cased props are not converted to
+ * kebab case.
+ * @param nestedSource Completion source that will be used whenever the completion isn't
+ * happening inside a tag. Can be used to provide completions for snippets for example.
+ */
+declare const vueCompletion: (components?: TagConfig, nestedSource?: CompletionSource) => CompletionSource;
+export { vueCompletion };

package/dist/extensions/autocomplete/vue/index.js

@@ -0,0 +1,132 @@
+import { a as completionsFromRecords, r as attrSnippet, s as optionsFromKeys } from "../../../tooltip-CYiVU7WY.js";
+import { j as htmlTags, k as globalHtmlAttributes } from "../../../data-Be9fjVqf.js";
+import { a as globalSvgAttributes, o as svgTags, t as getTagMatch } from "../../../markup-BuUgjal3.js";
+//#region src/extensions/autocomplete/vue/index.ts
+/** @module autocomplete/vue */
+var createCompletion = (label, icon, boost) => ({
+	label,
+	icon,
+	boost
+});
+var tagNames = completionsFromRecords([htmlTags, svgTags], "property");
+var langs = {
+	script: [
+		"js",
+		"ts",
+		"jsx",
+		"tsx"
+	],
+	style: [
+		"css",
+		"scss",
+		"sass",
+		"stylus",
+		"less"
+	]
+};
+var eventModifiers = [
+	".stop",
+	".prevent",
+	".self",
+	".capture",
+	".once",
+	".passive",
+	".left",
+	".right",
+	".middle"
+].map((modifier) => createCompletion(modifier, "enum"));
+var modelModifiers = [
+	".lazy",
+	".number",
+	".trim"
+].map((modifier) => createCompletion(modifier, "enum"));
+var bindModifiers = [
+	".camel",
+	".prop",
+	".attr"
+].map((modifier) => createCompletion(modifier, "enum"));
+var enumerateAttrs = (attrs, result = [], noEvents, boost) => {
+	for (let attr in attrs) if (attr.slice(0, 2) == "on") {
+		if (!noEvents) result.push(attrSnippet("@" + attr.slice(2), "\"\"", "event", boost), attrSnippet("v-on:" + attr.slice(2), "\"\"", "event", boost));
+	} else result.push(createCompletion(attr, "enum", boost), attrSnippet(":" + attr, "\"\"", "enum", boost), attrSnippet("v-bind:" + attr, "\"\"", "enum", boost));
+	return result;
+};
+var vueAttrs = enumerateAttrs({
+	key: null,
+	ref: null
+});
+var globalsNoEvents = enumerateAttrs(globalHtmlAttributes, [], true);
+/**
+* Completion source that adds completion for HTML and SVG tags to Vue. When configured,
+* it can also provide completions for specific Vue components.
+* @param components Used to configure autocompletion for Vue components. This is an
+* object mapping each component's name to the properties available for that component.
+* To provide completions for events, prefix them with `on`. E.g. `onevent` will result
+* in completions for `@event` and `v-on:event`. Camel cased props are not converted to
+* kebab case.
+* @param nestedSource Completion source that will be used whenever the completion isn't
+* happening inside a tag. Can be used to provide completions for snippets for example.
+*/
+var vueCompletion = (components, nestedSource) => (context, editor) => {
+	const tagMatch = getTagMatch(context, editor);
+	if (tagMatch) {
+		let [tag, tagName, lastAttr] = tagMatch;
+		let start = tagMatch.index;
+		let from = start + 1;
+		let options;
+		if (/\s/.test(tag)) {
+			let inAttrValue = /=\s*(?:"[^"]*|'[^']*|[^\s"'=]*)$/.test(tag);
+			let i = 0;
+			from = start + tag.search(/[^\s"'=]*$/);
+			for (;; i++) {
+				let tags = i ? i > 1 ? components : svgTags : htmlTags;
+				let globalAttrs = i ? i > 1 ? null : globalSvgAttributes : globalHtmlAttributes;
+				let tagAttrs = tags?.[tagName];
+				if (tagAttrs || i > 1) {
+					if (inAttrValue) options = (lastAttr == "lang" ? langs[tagName] : globalAttrs?.[lastAttr] || tagAttrs?.[lastAttr])?.map((val) => createCompletion(val, "unit"));
+					else if (lastAttr?.includes(".")) {
+						if (/^@|^v-on:/.test(lastAttr)) options = eventModifiers;
+						else if (lastAttr.slice(0, 6) == "v-bind") options = bindModifiers;
+						else if (lastAttr.slice(0, 7) == "v-model") options = modelModifiers;
+						from = start + tag.lastIndexOf(".");
+					} else {
+						options = [];
+						if (tagAttrs) enumerateAttrs(tagAttrs, options, false, globalAttrs ? 0 : 50);
+						if (globalAttrs) enumerateAttrs(globalAttrs, options);
+						else options.push(...globalsNoEvents);
+						options.push(...vueAttrs);
+					}
+					break;
+				}
+			}
+		} else options = components ? tagNames.concat(optionsFromKeys(components, "property")) : tagNames;
+		if (options) return {
+			from,
+			options
+		};
+	}
+	if (tagMatch != false) return nestedSource?.(context, editor);
+};
+[
+	"bind",
+	"cloak",
+	"html",
+	"memo",
+	"model",
+	"on",
+	"once",
+	"pre",
+	"show",
+	"slot",
+	"text",
+	"else",
+	"else-if",
+	"for",
+	"if"
+].forEach((directive, i) => {
+	vueAttrs.push(createCompletion("v-" + directive, i > 10 ? "keyword" : "function"));
+});
+//#endregion
+export { vueCompletion };
+
+//# sourceMappingURL=index.js.map

package/dist/extensions/autocomplete/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/extensions/autocomplete/vue/index.ts"],"sourcesContent":["/** @module autocomplete/vue */\n\nimport { globalHtmlAttributes, globalSvgAttributes, htmlTags, svgTags } from \"../markup/index.js\"\nimport { getTagMatch } from \"../markup/index.js\"\nimport { AttributeConfig, Completion, CompletionSource, TagConfig } from \"../types.js\"\nimport { attrSnippet, completionsFromRecords, optionsFromKeys } from \"../utils.js\"\n\nconst createCompletion = (\n\tlabel: string,\n\ticon?: Completion[\"icon\"],\n\tboost?: number,\n): Completion => ({\n\tlabel,\n\ticon,\n\tboost,\n})\n\nconst tagNames = completionsFromRecords([htmlTags, svgTags], \"property\")\n\nconst langs = {\n\tscript: [\"js\", \"ts\", \"jsx\", \"tsx\"],\n\tstyle: [\"css\", \"scss\", \"sass\", \"stylus\", \"less\"],\n}\n\nconst eventModifiers = [\n\t\".stop\",\n\t\".prevent\",\n\t\".self\",\n\t\".capture\",\n\t\".once\",\n\t\".passive\",\n\t\".left\",\n\t\".right\",\n\t\".middle\",\n].map(modifier => createCompletion(modifier, \"enum\"))\n\nconst modelModifiers = [\".lazy\", \".number\", \".trim\"].map(modifier =>\n\tcreateCompletion(modifier, \"enum\"),\n)\n\nconst bindModifiers = [\".camel\", \".prop\", \".attr\"].map(modifier =>\n\tcreateCompletion(modifier, \"enum\"),\n)\n\nconst enumerateAttrs = (\n\tattrs: AttributeConfig,\n\tresult: Completion[] = [],\n\tnoEvents?: boolean,\n\tboost?: number,\n) => {\n\tfor (let attr in attrs) {\n\t\tif (attr.slice(0, 2) == \"on\") {\n\t\t\tif (!noEvents) {\n\t\t\t\tresult.push(\n\t\t\t\t\tattrSnippet(\"@\" + attr.slice(2), '\"\"', \"event\", boost),\n\t\t\t\t\tattrSnippet(\"v-on:\" + attr.slice(2), '\"\"', \"event\", boost),\n\t\t\t\t)\n\t\t\t}\n\t\t} else {\n\t\t\tresult.push(\n\t\t\t\tcreateCompletion(attr, \"enum\", boost),\n\t\t\t\tattrSnippet(\":\" + attr, '\"\"', \"enum\", boost),\n\t\t\t\tattrSnippet(\"v-bind:\" + attr, '\"\"', \"enum\", boost),\n\t\t\t)\n\t\t}\n\t}\n\treturn result\n}\n\nconst vueAttrs = enumerateAttrs({\n\tkey: null,\n\tref: null,\n})\n\nconst globalsNoEvents = enumerateAttrs(globalHtmlAttributes, [], true)\n\n/**\n * Completion source that adds completion for HTML and SVG tags to Vue. When configured,\n * it can also provide completions for specific Vue components.\n * @param components Used to configure autocompletion for Vue components. This is an\n * object mapping each component's name to the properties available for that component.\n * To provide completions for events, prefix them with `on`. E.g. `onevent` will result\n * in completions for `@event` and `v-on:event`. Camel cased props are not converted to\n * kebab case.\n * @param nestedSource Completion source that will be used whenever the completion isn't\n * happening inside a tag. Can be used to provide completions for snippets for example.\n */\nconst vueCompletion =\n\t(components?: TagConfig, nestedSource?: CompletionSource): CompletionSource =>\n\t(context, editor) => {\n\t\tconst tagMatch = getTagMatch(context, editor)\n\n\t\tif (tagMatch) {\n\t\t\tlet [tag, tagName, lastAttr] = tagMatch\n\t\t\tlet start = tagMatch.index\n\t\t\tlet from = start + 1\n\t\t\tlet options: Completion[] | undefined\n\n\t\t\tif (/\\s/.test(tag)) {\n\t\t\t\tlet inAttrValue = /=\\s*(?:\"[^\"]*|'[^']*|[^\\s\"'=]*)$/.test(tag)\n\t\t\t\tlet i = 0\n\t\t\t\tfrom = start + tag.search(/[^\\s\"'=]*$/)\n\t\t\t\tfor (; ; i++) {\n\t\t\t\t\tlet tags = i ? (i > 1 ? components : svgTags) : htmlTags\n\t\t\t\t\tlet globalAttrs = i ? (i > 1 ? null : globalSvgAttributes) : globalHtmlAttributes\n\t\t\t\t\tlet tagAttrs = tags?.[tagName]\n\n\t\t\t\t\tif (tagAttrs || i > 1) {\n\t\t\t\t\t\tif (inAttrValue) {\n\t\t\t\t\t\t\toptions = (\n\t\t\t\t\t\t\t\tlastAttr == \"lang\"\n\t\t\t\t\t\t\t\t\t? langs[tagName as keyof typeof langs]\n\t\t\t\t\t\t\t\t\t: globalAttrs?.[lastAttr] || tagAttrs?.[lastAttr]\n\t\t\t\t\t\t\t)?.map(val => createCompletion(val, \"unit\"))\n\t\t\t\t\t\t} else if (lastAttr?.includes(\".\")) {\n\t\t\t\t\t\t\tif (/^@|^v-on:/.test(lastAttr)) options = eventModifiers\n\t\t\t\t\t\t\telse if (lastAttr.slice(0, 6) == \"v-bind\") options = bindModifiers\n\t\t\t\t\t\t\telse if (lastAttr.slice(0, 7) == \"v-model\") options = modelModifiers\n\t\t\t\t\t\t\tfrom = start + tag.lastIndexOf(\".\")\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\toptions = []\n\t\t\t\t\t\t\tif (tagAttrs) enumerateAttrs(tagAttrs, options, false, globalAttrs ? 0 : 50)\n\t\t\t\t\t\t\tif (globalAttrs) enumerateAttrs(globalAttrs, options)\n\t\t\t\t\t\t\telse options.push(...globalsNoEvents)\n\t\t\t\t\t\t\toptions.push(...vueAttrs)\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\toptions = components ? tagNames.concat(optionsFromKeys(components, \"property\")) : tagNames\n\t\t\t}\n\n\t\t\tif (options) {\n\t\t\t\treturn {\n\t\t\t\t\tfrom,\n\t\t\t\t\toptions,\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (tagMatch != false) return nestedSource?.(context, editor)\n\t}\n\n;[\n\t\"bind\",\n\t\"cloak\",\n\t\"html\",\n\t\"memo\",\n\t\"model\",\n\t\"on\",\n\t\"once\",\n\t\"pre\",\n\t\"show\",\n\t\"slot\",\n\t\"text\",\n\t\"else\",\n\t\"else-if\",\n\t\"for\",\n\t\"if\",\n].forEach((directive, i) => {\n\tvueAttrs.push(createCompletion(\"v-\" + directive, i > 10 ? \"keyword\" : \"function\"))\n})\n\nexport { vueCompletion }\n"],"mappings":"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"}

package/dist/extensions/commands/commands.d.ts

@@ -0,0 +1,95 @@
+import { PrismEditor } from '../../types.js';
+import { EditorHotkey } from './types.js';
+declare let ignoreTab: boolean;
+/**
+ * Sets whether editors should ignore tab or use it for indentation. Users can toggle
+ * this using `Ctrl` + `M` / `Ctrl` + `Shift` + `M` (Mac) when the {@link defaultKeymap}
+ * or {@link defaultCommands} extension is used.
+ */
+declare const setIgnoreTab: (newState: boolean) => boolean;
+declare const whitespaceEnd: (str: string) => number;
+declare const scroll: (editor: PrismEditor) => boolean;
+/**
+ * Command that indents or outdents all user-selected lines in the editor unless the
+ * editor is `readOnly`.
+ * @param editor Editor to execute the command on.
+ * @param less By default lines are indented. By passing `true`, lines are outdented
+ * instead.
+ */
+declare const indentSelectedLines: (editor: PrismEditor, less?: boolean) => boolean;
+/**
+ * Command that inserts spaces if `insertSpaces` isn't `false` or a tab character
+ * otherwise at the specified position unless the editor is `readOnly`.
+ * @param editor Editor to execute the command on.
+ * @param pos Position to insert the tab.
+ */
+declare const insertTab: (editor: PrismEditor, pos: number) => boolean;
+/**
+ * Command that inserts a new line replacing the current selection unless the editor is
+ * `readOnly`. It uses the `autoIndent` behavior of the current language to determine
+ * whether to preserve the indentation or increase it.
+ * @param editor Editor to execute the command on.
+ * @param eol If `true`, the new line is inserted at the end of the line instead of at
+ * the cursor's position.
+ */
+declare const insertLineAndIndent: (editor: PrismEditor, eol?: boolean) => boolean | undefined;
+/**
+ * Command that moves all selected lines unless the editor is `readOnly`.
+ * @param editor Editor to execute the command on.
+ * @param up Whether to move the lines up. Defaults to `false`.
+ */
+declare const moveSelectedLines: (editor: PrismEditor, up?: boolean) => boolean;
+/**
+ * Command that copies all selected lines unless the editor is `readOnly`.
+ * @param editor Editor to execute the command on.
+ * @param up Whether or not the selection should remain on the top copy. Defaults to
+ * `false`.
+ */
+declare const copySelectedLines: (editor: PrismEditor, up?: boolean) => boolean;
+/**
+ * Command that scrolls the editor by one line.
+ * @param editor Editor to execute the command on.
+ * @param up Whether to scroll up. Defaults to `false`.
+ */
+declare const scrollByOneLine: (editor: PrismEditor, up?: boolean) => boolean;
+/**
+ * Command that deletes all selected lines unless the editor is `readOnly`.
+ * @param editor Editor to execute the command on.
+ */
+declare const deleteSelectedLines: (editor: PrismEditor) => boolean;
+/**
+ * Command that toggles the comment around the current selection unless the editor is
+ * `readOnly`. Comment syntax is determined using the current {@link Language}. It will
+ * use the `getComments()` method if present and the `comments` property otherwise.
+ * @param editor Editor to execute the command on.
+ * @param isBlock Whether or not to toggle the comment using block syntax.
+ */
+declare const toggleComment: (editor: PrismEditor, isBlock?: boolean) => boolean;
+/**
+ * Default keymapping that includes the following commands:
+ *
+ * - `Alt` + `ArrowUp`: Move line up
+ * - `Alt` + `ArrowDown`: Move line down
+ * - `Ctrl` + `ArrowUp`: Scroll one line up (Windows/Linux)
+ * - `Ctrl` + `ArrowDown`: Scroll one line down (Windows/Linux)
+ * - `Ctrl` + `PageUp`: Scroll one line up (Mac)
+ * - `Ctrl` + `PageDown`: Scroll one line down (Mac)
+ * - `Shift` + `Alt` + `ArrowUp`: Copy line up
+ * - `Shift` + `Alt` + `ArrowDown`: Copy line down
+ * - `Enter`: Insert line and indent
+ * - `Shift` + `Enter`: Insert line and indent
+ * - `Mod` + `Enter`: Insert blank line
+ * - `Mod` + `]`: Indent line
+ * - `Mod` + `[`: Outdent line
+ * - `Tab`: Indent line (Tab capture enabled)
+ * - `Shift` + `Tab`: Outdent line (Tab capture enabled)
+ * - `Shift` + `Mod` + `K`: Delete line
+ * - `Mod` + `/`: Toggle comment
+ * - `Shift` + `Alt` + `A`: Toggle block comment
+ * - `Ctrl` + `M`: Toggle tab capturing (Windows/Linux)
+ * - `Ctrl` + `Shift` + `M`: Toggle tab capturing (Mac)
+ *
+ * Here, `Mod` refers to `Cmd` on Mac and `Ctrl` otherwise.
+ */
+declare const defaultKeymap: Record<string, EditorHotkey>;
+export { whitespaceEnd, scroll, indentSelectedLines, insertTab, insertLineAndIndent, moveSelectedLines, copySelectedLines, scrollByOneLine, deleteSelectedLines, toggleComment, setIgnoreTab, defaultKeymap, ignoreTab, };

package/dist/extensions/commands/deprecated.d.ts

@@ -0,0 +1,38 @@
+import { BasicExtension } from '../../index.js';
+/**
+ * Extension that will add automatic indentation and closing of brackets, quotes, and
+ * tags along with the commands presented later.
+ *
+ * ## Commands
+ *
+ * Here, `Mod` refers to `Cmd` on Mac and `Ctrl` otherwise.
+ *
+ * - `Alt` + `ArrowUp`: Move line up
+ * - `Alt` + `ArrowDown`: Move line down
+ * - `Ctrl` + `ArrowUp`: Scroll one line up (Windows/Linux only)
+ * - `Ctrl` + `ArrowDown`: Scroll one line down (Windows/Linux only)
+ * - `Shift` + `Alt` + `ArrowUp`: Copy line up
+ * - `Shift` + `Alt` + `ArrowDown`: Copy line down
+ * - `Mod` + `Enter`: Insert blank line
+ * - `Mod` + `]`: Indent line
+ * - `Mod` + `[`: Outdent line
+ * - `Tab`: Indent line (Tab capture enabled)
+ * - `Shift` + `Tab`: Outdent line (Tab capture enabled)
+ * - `Shift` + `Mod` + `K`: Delete line
+ * - `Mod` + `/`: Toggle comment
+ * - `Shift` + `Alt` + `A`: Toggle block comment
+ * - `Ctrl` + `M`: Toggle tab capturing (Windows/Linux)
+ * - `Ctrl` + `Shift` + `M`: Toggle tab capturing (Mac)
+ *
+ * @param selfClosePairs Pairs of self-closing brackets and quotes.
+ * Must be an array of strings with 2 characters each.
+ * Defaults to `['""', "''", '``', '()', '[]', '{}']`.
+ * @param selfCloseRegex Regex controlling whether or not a bracket/quote should
+ * automatically close based on the character before and after the cursor.
+ * Defaults to ``/([^$\w'"`]["'`]|.[[({])[.,:;\])}>\s]|.[[({]`/s``.
+ *
+ * @deprecated Consider using {@link editorCommands} instead. This will be removed in next
+ * major release.
+ */
+declare const defaultCommands: (selfClosePairs?: string[], selfCloseRegex?: RegExp) => BasicExtension;
+export { defaultCommands };

package/dist/extensions/commands/format.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Utility that formats a hotkey to display in a user interface. Modifier keys use symbols
+ * on Mac and labels otherwise.
+ *
+ * @param hotkey Hotkey to format for display.
+ * @param separator String to join the segments together with. Defaults to `" "` on Mac
+ * and `"+"` otherwise.
+ * @returns Formatted key for display.
+ *
+ * @example
+ * // On Mac
+ * formatHotkey("mod+s") // "⌘ S"
+ * formatHotkey("12+escape") // "⇧ ⌘ Esc"
+ * formatHotkey("arrowup") // "↑"
+ *
+ * // On Windows/Linux
+ * formatHotkey("mod+s") // "Ctrl+S"
+ * formatHotkey("12+escape") // "Shift+Win+Esc"
+ * formatHotkey("arrowup") // "↑"
+ */
+declare const formatHotkey: (hotkey: string, separator?: string) => string;
+/**
+ * Array of keyboard shortcuts and descriptions for {@link defaultKeymap}. Useful for
+ * documenting key bindings to users. It consists of tuples containing two string each
+ * where the first string is the key binding and the second is the description.
+ *
+ * @example
+ * for (const [key, description] of defaultKeymapLabels) {
+ *   console.log(formatHotkey(key), description)
+ * }
+ */
+declare const defaultKeymapLabels: [string, string][];
+/**
+ * Array of keyboard shortcuts and descriptions for the {@link autoComplete} extension.
+ * Useful for documenting key bindings to users. It consists of tuples containing two
+ * string each where the first string is the key binding and the second is the description.
+ *
+ * @example
+ * for (const [key, description] of autoCompleteShortcutLabels) {
+ *   console.log(formatHotkey(key), description)
+ * }
+ */
+declare const autoCompleteShortcutLabels: [string, string][];
+/**
+ * Array of keyboard shortcuts and descriptions for the {@link searchWidget} extension.
+ * Useful for documenting key bindings to users. It consists of tuples containing two
+ * string each where the first string is the key binding and the second is the description.
+ *
+ * @example
+ * for (const [key, description] of searchShortcutLabels) {
+ *   console.log(formatHotkey(key), description)
+ * }
+ */
+declare const searchShortcutLabels: [string, string][];
+export { formatHotkey, defaultKeymapLabels, autoCompleteShortcutLabels, searchShortcutLabels };

package/dist/extensions/commands/index.d.ts

@@ -0,0 +1,37 @@
+import { BasicExtension } from '../../index.js';
+import { EditHistory, EditorHotkey } from './types.js';
+/**
+ * Extension that will add automatic closing of brackets, quotes, and tags along
+ * with the specified commands.
+ *
+ * @param hotkeyMap Commands that will be added to the editor.
+ * @param selfClosePairs Pairs of self-closing brackets and quotes.
+ * Must be an array of strings with 2 characters each.
+ * Defaults to `['""', "''", '``', '()', '[]', '{}']`.
+ * @param selfCloseRegex Regex controlling whether or not a bracket/quote should
+ * automatically close based on the character before and after the cursor.
+ * Defaults to ``/([^$\w'"`]["'`]|.[[({])[.,:;\])}>\s]|.[[({]`/s``.
+ */
+declare const editorCommands: (hotkeyMap: Record<string, EditorHotkey>, selfClosePairs?: string[], selfCloseRegex?: RegExp) => BasicExtension;
+/**
+ * History extension that overrides the undo/redo behavior of the browser.
+ *
+ * Without this extension, the browser's native undo/redo is used, which can be sufficient
+ * in some cases.
+ *
+ * Once added to an editor, this extension can be accessed from `editor.extensions.history`.
+ *
+ * If you want to create a new editor with different extensions while keeping the undo/redo
+ * history of an old editor, you can! Just add the old editor's history extension instance
+ * to the new editor. Keep in mind that this will fully break the undo/redo behavior of the
+ * old editor.
+ *
+ * @param historyLimit The maximum size of the history stack. Defaults to 999.
+ */
+declare const editHistory: (historyLimit?: number) => EditHistory;
+export { editorCommands, editHistory };
+export { normalizeKey, getKeysFromEvent, addEditorHotkey, addHotkey, addEditorHotkeySequence, addHotkeySequence, runHotkeys, isModifierKey, } from './utils.js';
+export { indentSelectedLines, insertTab, insertLineAndIndent, moveSelectedLines, copySelectedLines, scrollByOneLine, deleteSelectedLines, toggleComment, setIgnoreTab, defaultKeymap, ignoreTab, } from './commands.js';
+export * from './deprecated.js';
+export * from './types.js';
+export * from './format.js';

package/dist/extensions/commands/index.js

@@ -0,0 +1,3 @@
+import { a as getKeysFromEvent, c as normalizeKey, i as addHotkeySequence, l as runHotkeys, n as addEditorHotkeySequence, o as isModifierKey, r as addHotkey, t as addEditorHotkey } from "../../utils-DSQ-ulqQ.js";
+import { _ as setIgnoreTab, a as formatHotkey, c as copySelectedLines, d as ignoreTab, f as indentSelectedLines, g as scrollByOneLine, h as moveSelectedLines, i as defaultKeymapLabels, l as defaultKeymap, m as insertTab, n as editorCommands, o as searchShortcutLabels, p as insertLineAndIndent, r as autoCompleteShortcutLabels, s as defaultCommands, t as editHistory, u as deleteSelectedLines, v as toggleComment } from "../../commands-HRCav5fj.js";
+export { addEditorHotkey, addEditorHotkeySequence, addHotkey, addHotkeySequence, autoCompleteShortcutLabels, copySelectedLines, defaultCommands, defaultKeymap, defaultKeymapLabels, deleteSelectedLines, editHistory, editorCommands, formatHotkey, getKeysFromEvent, ignoreTab, indentSelectedLines, insertLineAndIndent, insertTab, isModifierKey, moveSelectedLines, normalizeKey, runHotkeys, scrollByOneLine, searchShortcutLabels, setIgnoreTab, toggleComment };

package/dist/extensions/commands/types.d.ts

@@ -0,0 +1,53 @@
+import { BasicExtension, PrismEditor } from '../../types.js';
+/**
+ * Hotkey where the data parameter is an editor.
+ */
+export type EditorHotkey<T extends {} = {}> = Hotkey<PrismEditor<T>>;
+/**
+ * Hotkeys are functions that are called when a specific key is pressed. When given data
+ * and a keyboard event, it first checks if the side-effect should be performed with the
+ * current state and event. If yes, `true` should be returned to signal the event was
+ * handled.
+ */
+export type Hotkey<T> = (data: T, e: KeyboardEvent, key: string) => void | boolean;
+/** Object mapping keys to buckets of hotkeys. */
+export type HotkeyMap<T> = Partial<Record<string, (Set<Hotkey<T>> | undefined)[]>>;
+export type HotkeySequenceOptions = {
+    /** Maximum number of milliseconds allowed between steps. @default 2000 */
+    timeout?: number;
+    /**
+     * Precedence of the handler that starts the sequence.
+     * @default 2
+     */
+    precedence?: number;
+    /**
+     * Whether or not to call `preventDefault()` when the sequence is advanced. This does
+     * not apply to the final step where the return value of the command dictates whether
+     * `preventDefault()` is called.
+     * @default true
+     */
+    preventDefault?: boolean;
+};
+export interface EditHistory extends BasicExtension {
+    /** Clears the history stack. */
+    clear(): void;
+    /**
+     * Sets the active entry relative to the current entry.
+     *
+     * @param offset The position you want to move to relative to the current entry.
+     *
+     * `EditHistory.go(-1)` would be equivalent to an undo while `EditHistory.go(1)` would
+     * be equivalent to a redo.
+     *
+     * If there's no entry at the specified offset, the call does nothing.
+     */
+    go(offset: number): void;
+    /**
+     * Returns whether or not there exists a history entry at the specified offset relative
+     * to the current entry.
+     *
+     * This method can be used to determine whether a call to {@link EditHistory.go} with the
+     * same offset will succeed or do nothing.
+     */
+    has(offset: number): boolean;
+}