@cratis/components 4.22.1 → 4.23.1

package/dist/esm/MarkdownEditor/toggleCodeBlock.d.ts

@@ -0,0 +1,11 @@
+import type { MarkdownTextEdit } from './MarkdownTextEdit.js';
+/**
+ * Fences the lines the selection touches in a code block, or takes the fences off when those lines
+ * already open and close one.
+ * @param value The markdown being edited.
+ * @param start Where the selection starts.
+ * @param end Where the selection ends.
+ * @returns The edited markdown and the selection after it.
+ */
+export declare const toggleCodeBlock: (value: string, start: number, end: number) => MarkdownTextEdit;
+//# sourceMappingURL=toggleCodeBlock.d.ts.map

package/dist/esm/MarkdownEditor/toggleCodeBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleCodeBlock.d.ts","sourceRoot":"","sources":["../../../MarkdownEditor/toggleCodeBlock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AAK3D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,UAAW,MAAM,SAAS,MAAM,OAAO,MAAM,KAAG,gBAyB3E,CAAC"}

package/dist/esm/MarkdownEditor/toggleCodeBlock.js

@@ -0,0 +1,30 @@
+import { lineBlockAround } from './lineBlockAround.js';
+
+const fence = '```';
+const toggleCodeBlock = (value, start, end) => {
+    const block = lineBlockAround(value, start, end);
+    const before = value.slice(0, block.start);
+    const after = value.slice(block.end);
+    const lines = block.lines;
+    const fenced = lines.length >= 2 && lines[0].startsWith(fence) && lines[lines.length - 1].trim() === fence;
+    if (fenced) {
+        const inner = lines.slice(1, -1).join('\n');
+        return {
+            value: `${before}${inner}${after}`,
+            selectionStart: block.start,
+            selectionEnd: block.start + inner.length,
+        };
+    }
+    const inner = lines.join('\n');
+    const opening = `${fence}\n`;
+    const contentStart = block.start + opening.length;
+    const caretOffset = start === end ? start - block.start : 0;
+    return {
+        value: `${before}${opening}${inner}\n${fence}${after}`,
+        selectionStart: contentStart + caretOffset,
+        selectionEnd: start === end ? contentStart + caretOffset : contentStart + inner.length,
+    };
+};
+
+export { toggleCodeBlock };
+//# sourceMappingURL=toggleCodeBlock.js.map

package/dist/esm/MarkdownEditor/toggleCodeBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleCodeBlock.js","sources":["../../../MarkdownEditor/toggleCodeBlock.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport type { MarkdownTextEdit } from './MarkdownTextEdit';\nimport { lineBlockAround } from './lineBlockAround';\n\nconst fence = '```';\n\n/**\n * Fences the lines the selection touches in a code block, or takes the fences off when those lines\n * already open and close one.\n * @param value The markdown being edited.\n * @param start Where the selection starts.\n * @param end Where the selection ends.\n * @returns The edited markdown and the selection after it.\n */\nexport const toggleCodeBlock = (value: string, start: number, end: number): MarkdownTextEdit => {\n    const block = lineBlockAround(value, start, end);\n    const before = value.slice(0, block.start);\n    const after = value.slice(block.end);\n    const lines = block.lines;\n    const fenced = lines.length >= 2 && lines[0].startsWith(fence) && lines[lines.length - 1].trim() === fence;\n\n    if (fenced) {\n        const inner = lines.slice(1, -1).join('\\n');\n        return {\n            value: `${before}${inner}${after}`,\n            selectionStart: block.start,\n            selectionEnd: block.start + inner.length,\n        };\n    }\n\n    const inner = lines.join('\\n');\n    const opening = `${fence}\\n`;\n    const contentStart = block.start + opening.length;\n    const caretOffset = start === end ? start - block.start : 0;\n    return {\n        value: `${before}${opening}${inner}\\n${fence}${after}`,\n        selectionStart: contentStart + caretOffset,\n        selectionEnd: start === end ? contentStart + caretOffset : contentStart + inner.length,\n    };\n};\n"],"names":[],"mappings":";;AAMA,MAAM,KAAK,GAAG,KAAK;AAUZ,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW,KAAsB;IAC3F,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC;AAChD,IAAA,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;AACpC,IAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK;AACzB,IAAA,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK;IAE1G,IAAI,MAAM,EAAE;AACR,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3C,OAAO;AACH,YAAA,KAAK,EAAE,CAAA,EAAG,MAAM,GAAG,KAAK,CAAA,EAAG,KAAK,CAAA,CAAE;YAClC,cAAc,EAAE,KAAK,CAAC,KAAK;AAC3B,YAAA,YAAY,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM;SAC3C;IACL;IAEA,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;AAC9B,IAAA,MAAM,OAAO,GAAG,CAAA,EAAG,KAAK,IAAI;IAC5B,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM;AACjD,IAAA,MAAM,WAAW,GAAG,KAAK,KAAK,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC;IAC3D,OAAO;QACH,KAAK,EAAE,CAAA,EAAG,MAAM,CAAA,EAAG,OAAO,CAAA,EAAG,KAAK,CAAA,EAAA,EAAK,KAAK,CAAA,EAAG,KAAK,CAAA,CAAE;QACtD,cAAc,EAAE,YAAY,GAAG,WAAW;AAC1C,QAAA,YAAY,EAAE,KAAK,KAAK,GAAG,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,KAAK,CAAC,MAAM;KACzF;AACL;;"}

package/dist/esm/MarkdownEditor/toggleInlineMarker.d.ts

@@ -0,0 +1,13 @@
+import type { MarkdownTextEdit } from './MarkdownTextEdit.js';
+/**
+ * Wraps the selection in an inline marker such as `**` or a backtick, or takes the marker off when
+ * the selection already carries it - either just outside the selection or as its first and last
+ * characters. The selection stays on the same text, so a second format can be applied straight after.
+ * @param value The markdown being edited.
+ * @param start Where the selection starts.
+ * @param end Where the selection ends.
+ * @param marker The marker to toggle.
+ * @returns The edited markdown and the selection after it.
+ */
+export declare const toggleInlineMarker: (value: string, start: number, end: number, marker: string) => MarkdownTextEdit;
+//# sourceMappingURL=toggleInlineMarker.d.ts.map

package/dist/esm/MarkdownEditor/toggleInlineMarker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleInlineMarker.d.ts","sourceRoot":"","sources":["../../../MarkdownEditor/toggleInlineMarker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,UAAW,MAAM,SAAS,MAAM,OAAO,MAAM,UAAU,MAAM,KAAG,gBA8B9F,CAAC"}

package/dist/esm/MarkdownEditor/toggleInlineMarker.js

@@ -0,0 +1,29 @@
+const toggleInlineMarker = (value, start, end, marker) => {
+    const length = marker.length;
+    const selected = value.slice(start, end);
+    const markedOutside = value.slice(start - length, start) === marker && value.slice(end, end + length) === marker;
+    if (markedOutside) {
+        return {
+            value: `${value.slice(0, start - length)}${selected}${value.slice(end + length)}`,
+            selectionStart: start - length,
+            selectionEnd: end - length,
+        };
+    }
+    const markedInside = selected.length >= length * 2 && selected.startsWith(marker) && selected.endsWith(marker);
+    if (markedInside) {
+        const inner = selected.slice(length, selected.length - length);
+        return {
+            value: `${value.slice(0, start)}${inner}${value.slice(end)}`,
+            selectionStart: start,
+            selectionEnd: start + inner.length,
+        };
+    }
+    return {
+        value: `${value.slice(0, start)}${marker}${selected}${marker}${value.slice(end)}`,
+        selectionStart: start + length,
+        selectionEnd: end + length,
+    };
+};
+
+export { toggleInlineMarker };
+//# sourceMappingURL=toggleInlineMarker.js.map

package/dist/esm/MarkdownEditor/toggleInlineMarker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleInlineMarker.js","sources":["../../../MarkdownEditor/toggleInlineMarker.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport type { MarkdownTextEdit } from './MarkdownTextEdit';\n\n/**\n * Wraps the selection in an inline marker such as `**` or a backtick, or takes the marker off when\n * the selection already carries it - either just outside the selection or as its first and last\n * characters. The selection stays on the same text, so a second format can be applied straight after.\n * @param value The markdown being edited.\n * @param start Where the selection starts.\n * @param end Where the selection ends.\n * @param marker The marker to toggle.\n * @returns The edited markdown and the selection after it.\n */\nexport const toggleInlineMarker = (value: string, start: number, end: number, marker: string): MarkdownTextEdit => {\n    const length = marker.length;\n    const selected = value.slice(start, end);\n\n    const markedOutside =\n        value.slice(start - length, start) === marker && value.slice(end, end + length) === marker;\n    if (markedOutside) {\n        return {\n            value: `${value.slice(0, start - length)}${selected}${value.slice(end + length)}`,\n            selectionStart: start - length,\n            selectionEnd: end - length,\n        };\n    }\n\n    const markedInside =\n        selected.length >= length * 2 && selected.startsWith(marker) && selected.endsWith(marker);\n    if (markedInside) {\n        const inner = selected.slice(length, selected.length - length);\n        return {\n            value: `${value.slice(0, start)}${inner}${value.slice(end)}`,\n            selectionStart: start,\n            selectionEnd: start + inner.length,\n        };\n    }\n\n    return {\n        value: `${value.slice(0, start)}${marker}${selected}${marker}${value.slice(end)}`,\n        selectionStart: start + length,\n        selectionEnd: end + length,\n    };\n};\n"],"names":[],"mappings":"AAeO,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW,EAAE,MAAc,KAAsB;AAC9G,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM;IAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;IAExC,MAAM,aAAa,GACf,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,KAAK,MAAM;IAC9F,IAAI,aAAa,EAAE;QACf,OAAO;YACH,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,CAAA,EAAG,QAAQ,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,CAAA,CAAE;YACjF,cAAc,EAAE,KAAK,GAAG,MAAM;YAC9B,YAAY,EAAE,GAAG,GAAG,MAAM;SAC7B;IACL;IAEA,MAAM,YAAY,GACd,QAAQ,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC7F,IAAI,YAAY,EAAE;AACd,QAAA,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9D,OAAO;AACH,YAAA,KAAK,EAAE,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA,EAAG,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA,CAAE;AAC5D,YAAA,cAAc,EAAE,KAAK;AACrB,YAAA,YAAY,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM;SACrC;IACL;IAEA,OAAO;QACH,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,EAAG,QAAQ,CAAA,EAAG,MAAM,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA,CAAE;QACjF,cAAc,EAAE,KAAK,GAAG,MAAM;QAC9B,YAAY,EAAE,GAAG,GAAG,MAAM;KAC7B;AACL;;"}

package/dist/esm/MarkdownEditor/toggleLinePrefix.d.ts

@@ -0,0 +1,14 @@
+import type { MarkdownTextEdit } from './MarkdownTextEdit.js';
+/**
+ * Puts a prefix such as `> ` or `- ` in front of every line the selection touches, or takes it off
+ * when every one of those lines already has it. A caret keeps its place in the text; a selection grows
+ * to cover the edited lines.
+ * @param value The markdown being edited.
+ * @param start Where the selection starts.
+ * @param end Where the selection ends.
+ * @param prefixFor Gives the prefix for the line at a position within the touched lines.
+ * @param existing Recognizes a line that already carries the prefix, and matches the prefix itself.
+ * @returns The edited markdown and the selection after it.
+ */
+export declare const toggleLinePrefix: (value: string, start: number, end: number, prefixFor: (lineIndex: number) => string, existing: RegExp) => MarkdownTextEdit;
+//# sourceMappingURL=toggleLinePrefix.d.ts.map

package/dist/esm/MarkdownEditor/toggleLinePrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleLinePrefix.d.ts","sourceRoot":"","sources":["../../../MarkdownEditor/toggleLinePrefix.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AAG3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,UAClB,MAAM,SACN,MAAM,OACR,MAAM,aACA,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,YAC9B,MAAM,KACjB,gBAoBF,CAAC"}

package/dist/esm/MarkdownEditor/toggleLinePrefix.js

@@ -0,0 +1,24 @@
+import { lineBlockAround } from './lineBlockAround.js';
+
+const toggleLinePrefix = (value, start, end, prefixFor, existing) => {
+    const block = lineBlockAround(value, start, end);
+    const everyLinePrefixed = block.lines.every(line => existing.test(line));
+    const edited = everyLinePrefixed
+        ? block.lines.map(line => line.replace(existing, ''))
+        : block.lines.map((line, lineIndex) => `${prefixFor(lineIndex)}${line}`);
+    const editedBlock = edited.join('\n');
+    const result = `${value.slice(0, block.start)}${editedBlock}${value.slice(block.end)}`;
+    if (start === end) {
+        const shift = edited[0].length - block.lines[0].length;
+        const caret = Math.max(block.start, start + shift);
+        return { value: result, selectionStart: caret, selectionEnd: caret };
+    }
+    return {
+        value: result,
+        selectionStart: block.start,
+        selectionEnd: block.start + editedBlock.length,
+    };
+};
+
+export { toggleLinePrefix };
+//# sourceMappingURL=toggleLinePrefix.js.map

package/dist/esm/MarkdownEditor/toggleLinePrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleLinePrefix.js","sources":["../../../MarkdownEditor/toggleLinePrefix.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport type { MarkdownTextEdit } from './MarkdownTextEdit';\nimport { lineBlockAround } from './lineBlockAround';\n\n/**\n * Puts a prefix such as `> ` or `- ` in front of every line the selection touches, or takes it off\n * when every one of those lines already has it. A caret keeps its place in the text; a selection grows\n * to cover the edited lines.\n * @param value The markdown being edited.\n * @param start Where the selection starts.\n * @param end Where the selection ends.\n * @param prefixFor Gives the prefix for the line at a position within the touched lines.\n * @param existing Recognizes a line that already carries the prefix, and matches the prefix itself.\n * @returns The edited markdown and the selection after it.\n */\nexport const toggleLinePrefix = (\n    value: string,\n    start: number,\n    end: number,\n    prefixFor: (lineIndex: number) => string,\n    existing: RegExp,\n): MarkdownTextEdit => {\n    const block = lineBlockAround(value, start, end);\n    const everyLinePrefixed = block.lines.every(line => existing.test(line));\n    const edited = everyLinePrefixed\n        ? block.lines.map(line => line.replace(existing, ''))\n        : block.lines.map((line, lineIndex) => `${prefixFor(lineIndex)}${line}`);\n    const editedBlock = edited.join('\\n');\n    const result = `${value.slice(0, block.start)}${editedBlock}${value.slice(block.end)}`;\n\n    if (start === end) {\n        const shift = edited[0].length - block.lines[0].length;\n        const caret = Math.max(block.start, start + shift);\n        return { value: result, selectionStart: caret, selectionEnd: caret };\n    }\n\n    return {\n        value: result,\n        selectionStart: block.start,\n        selectionEnd: block.start + editedBlock.length,\n    };\n};\n"],"names":[],"mappings":";;AAiBO,MAAM,gBAAgB,GAAG,CAC5B,KAAa,EACb,KAAa,EACb,GAAW,EACX,SAAwC,EACxC,QAAgB,KACE;IAClB,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC;AAChD,IAAA,MAAM,iBAAiB,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG;AACX,UAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;UAClD,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,CAAA,EAAG,SAAS,CAAC,SAAS,CAAC,CAAA,EAAG,IAAI,CAAA,CAAE,CAAC;IAC5E,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA,EAAG,WAAW,CAAA,EAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA,CAAE;AAEtF,IAAA,IAAI,KAAK,KAAK,GAAG,EAAE;AACf,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;AACtD,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;AAClD,QAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE;IACxE;IAEA,OAAO;AACH,QAAA,KAAK,EAAE,MAAM;QACb,cAAc,EAAE,KAAK,CAAC,KAAK;AAC3B,QAAA,YAAY,EAAE,KAAK,CAAC,KAAK,GAAG,WAAW,CAAC,MAAM;KACjD;AACL;;"}

package/dist/esm/MarkdownEditor/uploadPlaceholderFor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The placeholder that stands where a file is going while it uploads.
+ *
+ * The text lands at the caret the moment a file is pasted or dropped, so the editor shows it took the
+ * file, keeps the position while several upload at once, and leaves something to point at when one
+ * fails.
+ * @param fileName The name of the file being uploaded.
+ * @returns The placeholder text.
+ */
+export declare const uploadPlaceholderFor: (fileName: string) => string;
+//# sourceMappingURL=uploadPlaceholderFor.d.ts.map

package/dist/esm/MarkdownEditor/uploadPlaceholderFor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadPlaceholderFor.d.ts","sourceRoot":"","sources":["../../../MarkdownEditor/uploadPlaceholderFor.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,aAAc,MAAM,KAAG,MAAuC,CAAC"}

package/dist/esm/MarkdownEditor/uploadPlaceholderFor.js

@@ -0,0 +1,4 @@
+const uploadPlaceholderFor = (fileName) => `![Uploading ${fileName}…]()`;
+
+export { uploadPlaceholderFor };
+//# sourceMappingURL=uploadPlaceholderFor.js.map

package/dist/esm/MarkdownEditor/uploadPlaceholderFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadPlaceholderFor.js","sources":["../../../MarkdownEditor/uploadPlaceholderFor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * The placeholder that stands where a file is going while it uploads.\n *\n * The text lands at the caret the moment a file is pasted or dropped, so the editor shows it took the\n * file, keeps the position while several upload at once, and leaves something to point at when one\n * fails.\n * @param fileName The name of the file being uploaded.\n * @returns The placeholder text.\n */\nexport const uploadPlaceholderFor = (fileName: string): string => `![Uploading ${fileName}…]()`;\n"],"names":[],"mappings":"AAYO,MAAM,oBAAoB,GAAG,CAAC,QAAgB,KAAa,CAAA,YAAA,EAAe,QAAQ,CAAA,IAAA;;"}

package/dist/esm/MarkdownEditor/useMarkdownCompletion.d.ts

@@ -0,0 +1,44 @@
+import { type KeyboardEvent } from 'react';
+import type { MarkdownCompletion } from './MarkdownCompletion.js';
+import type { MarkdownCompletionMatch } from './MarkdownCompletionMatch.js';
+import type { MarkdownSuggestion } from './MarkdownSuggestion.js';
+import type { MarkdownTextEdit } from './MarkdownTextEdit.js';
+/**
+ * The state of the completion being typed at the caret, as {@link useMarkdownCompletion} reports it.
+ */
+export interface MarkdownCompletionState {
+    /** The completion being typed, when there is one and it has not been dismissed. */
+    match?: MarkdownCompletionMatch;
+    /** The suggestions on offer. Empty while none are known. */
+    suggestions: readonly MarkdownSuggestion[];
+    /** Whether the suggestion list is open. */
+    isOpen: boolean;
+    /** The index of the highlighted suggestion, which Enter or Tab picks. */
+    activeIndex: number;
+    /** Highlights a suggestion, as the pointer moving onto it does. */
+    highlight: (index: number) => void;
+    /**
+     * Works out the markdown after picking a suggestion, and closes the list.
+     * @param suggestion The picked suggestion.
+     * @returns The edit to apply, or undefined when nothing is being completed.
+     */
+    choose: (suggestion: MarkdownSuggestion) => MarkdownTextEdit | undefined;
+    /**
+     * Handles the keys the open list owns: the arrows move the highlight, Enter and Tab pick, Escape
+     * dismisses the list until the person starts another completion.
+     * @param event The key event from the writing area.
+     * @returns The edit to apply when a suggestion was picked.
+     */
+    handleKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => MarkdownTextEdit | undefined;
+}
+/**
+ * Tracks the completion being typed at the caret, asks it for suggestions once typing pauses, and
+ * drops answers that arrive for a query the person has already typed past.
+ * @param value The markdown being edited.
+ * @param selectionStart Where the selection starts.
+ * @param selectionEnd Where the selection ends. Completion only runs on a plain caret.
+ * @param completions The configured completions.
+ * @returns The {@link MarkdownCompletionState}.
+ */
+export declare const useMarkdownCompletion: (value: string, selectionStart: number, selectionEnd: number, completions: readonly MarkdownCompletion[]) => MarkdownCompletionState;
+//# sourceMappingURL=useMarkdownCompletion.d.ts.map

package/dist/esm/MarkdownEditor/useMarkdownCompletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdownCompletion.d.ts","sourceRoot":"","sources":["../../../MarkdownEditor/useMarkdownCompletion.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AAW3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,mFAAmF;IACnF,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAEhC,4DAA4D;IAC5D,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAE3C,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAEhB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IAEpB,mEAAmE;IACnE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC;;;;OAIG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,kBAAkB,KAAK,gBAAgB,GAAG,SAAS,CAAC;IAEzE;;;;;OAKG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,mBAAmB,CAAC,KAAK,gBAAgB,GAAG,SAAS,CAAC;CAC9F;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,UACvB,MAAM,kBACG,MAAM,gBACR,MAAM,eACP,SAAS,kBAAkB,EAAE,KAC3C,uBA+FF,CAAC"}

package/dist/esm/MarkdownEditor/useMarkdownCompletion.js

@@ -0,0 +1,92 @@
+import { useState, useRef, useEffect } from 'react';
+import { findCompletionMatch } from './findCompletionMatch.js';
+import { replaceRange } from './replaceRange.js';
+
+const defaultDebounce = 150;
+const sessionOf = (match) => `${match.completionIndex}:${match.start}`;
+const useMarkdownCompletion = (value, selectionStart, selectionEnd, completions) => {
+    const [answer, setAnswer] = useState();
+    const [activeIndex, setActiveIndex] = useState(0);
+    const [dismissedSession, setDismissedSession] = useState();
+    const found = completions.length > 0 && selectionStart === selectionEnd
+        ? findCompletionMatch(value, selectionStart, completions)
+        : undefined;
+    const session = found ? sessionOf(found) : undefined;
+    const match = found && session !== dismissedSession ? found : undefined;
+    const request = match ? `${sessionOf(match)}:${match.query}` : undefined;
+    const matchRef = useRef(match);
+    matchRef.current = match;
+    useEffect(() => {
+        const current = matchRef.current;
+        if (!current)
+            return;
+        const controller = new AbortController();
+        const requestSession = sessionOf(current);
+        const timeout = window.setTimeout(() => {
+            Promise.resolve()
+                .then(() => current.completion.suggest(current.query, { signal: controller.signal }))
+                .then(suggestions => {
+                if (!controller.signal.aborted)
+                    setAnswer({ session: requestSession, suggestions });
+            }, () => {
+                if (!controller.signal.aborted)
+                    setAnswer({ session: requestSession, suggestions: [] });
+            });
+        }, current.completion.debounce ?? defaultDebounce);
+        return () => {
+            window.clearTimeout(timeout);
+            controller.abort();
+        };
+    }, [request]);
+    useEffect(() => {
+        if (session === undefined)
+            setDismissedSession(undefined);
+    }, [session]);
+    const suggestions = match && answer?.session === sessionOf(match) ? answer.suggestions : [];
+    const isOpen = suggestions.length > 0;
+    const highlighted = Math.min(activeIndex, Math.max(suggestions.length - 1, 0));
+    useEffect(() => setActiveIndex(0), [answer]);
+    const choose = (suggestion) => {
+        if (!match)
+            return undefined;
+        setAnswer(undefined);
+        return replaceRange(value, match.start, match.end, suggestion.insertText);
+    };
+    const handleKeyDown = (event) => {
+        if (!isOpen || !match)
+            return undefined;
+        switch (event.key) {
+            case 'ArrowDown':
+                event.preventDefault();
+                setActiveIndex((highlighted + 1) % suggestions.length);
+                return undefined;
+            case 'ArrowUp':
+                event.preventDefault();
+                setActiveIndex((highlighted - 1 + suggestions.length) % suggestions.length);
+                return undefined;
+            case 'Enter':
+            case 'Tab':
+                event.preventDefault();
+                return choose(suggestions[highlighted]);
+            case 'Escape':
+                event.preventDefault();
+                event.stopPropagation();
+                setDismissedSession(sessionOf(match));
+                return undefined;
+            default:
+                return undefined;
+        }
+    };
+    return {
+        match,
+        suggestions,
+        isOpen,
+        activeIndex: highlighted,
+        highlight: setActiveIndex,
+        choose,
+        handleKeyDown,
+    };
+};
+
+export { useMarkdownCompletion };
+//# sourceMappingURL=useMarkdownCompletion.js.map

package/dist/esm/MarkdownEditor/useMarkdownCompletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdownCompletion.js","sources":["../../../MarkdownEditor/useMarkdownCompletion.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useEffect, useRef, useState, type KeyboardEvent } from 'react';\nimport type { MarkdownCompletion } from './MarkdownCompletion';\nimport type { MarkdownCompletionMatch } from './MarkdownCompletionMatch';\nimport type { MarkdownSuggestion } from './MarkdownSuggestion';\nimport type { MarkdownTextEdit } from './MarkdownTextEdit';\nimport { findCompletionMatch } from './findCompletionMatch';\nimport { replaceRange } from './replaceRange';\n\nconst defaultDebounce = 150;\n\ninterface Answer {\n    session: string;\n    suggestions: readonly MarkdownSuggestion[];\n}\n\n/**\n * The state of the completion being typed at the caret, as {@link useMarkdownCompletion} reports it.\n */\nexport interface MarkdownCompletionState {\n    /** The completion being typed, when there is one and it has not been dismissed. */\n    match?: MarkdownCompletionMatch;\n\n    /** The suggestions on offer. Empty while none are known. */\n    suggestions: readonly MarkdownSuggestion[];\n\n    /** Whether the suggestion list is open. */\n    isOpen: boolean;\n\n    /** The index of the highlighted suggestion, which Enter or Tab picks. */\n    activeIndex: number;\n\n    /** Highlights a suggestion, as the pointer moving onto it does. */\n    highlight: (index: number) => void;\n\n    /**\n     * Works out the markdown after picking a suggestion, and closes the list.\n     * @param suggestion The picked suggestion.\n     * @returns The edit to apply, or undefined when nothing is being completed.\n     */\n    choose: (suggestion: MarkdownSuggestion) => MarkdownTextEdit | undefined;\n\n    /**\n     * Handles the keys the open list owns: the arrows move the highlight, Enter and Tab pick, Escape\n     * dismisses the list until the person starts another completion.\n     * @param event The key event from the writing area.\n     * @returns The edit to apply when a suggestion was picked.\n     */\n    handleKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => MarkdownTextEdit | undefined;\n}\n\nconst sessionOf = (match: MarkdownCompletionMatch) => `${match.completionIndex}:${match.start}`;\n\n/**\n * Tracks the completion being typed at the caret, asks it for suggestions once typing pauses, and\n * drops answers that arrive for a query the person has already typed past.\n * @param value The markdown being edited.\n * @param selectionStart Where the selection starts.\n * @param selectionEnd Where the selection ends. Completion only runs on a plain caret.\n * @param completions The configured completions.\n * @returns The {@link MarkdownCompletionState}.\n */\nexport const useMarkdownCompletion = (\n    value: string,\n    selectionStart: number,\n    selectionEnd: number,\n    completions: readonly MarkdownCompletion[],\n): MarkdownCompletionState => {\n    const [answer, setAnswer] = useState<Answer>();\n    const [activeIndex, setActiveIndex] = useState(0);\n    const [dismissedSession, setDismissedSession] = useState<string>();\n\n    const found =\n        completions.length > 0 && selectionStart === selectionEnd\n            ? findCompletionMatch(value, selectionStart, completions)\n            : undefined;\n    const session = found ? sessionOf(found) : undefined;\n    const match = found && session !== dismissedSession ? found : undefined;\n    const request = match ? `${sessionOf(match)}:${match.query}` : undefined;\n\n    // The completions are usually recreated on every render of the host; only the request decides\n    // when to ask again, and the ask reads whichever completion is current.\n    const matchRef = useRef(match);\n    matchRef.current = match;\n\n    useEffect(() => {\n        const current = matchRef.current;\n        if (!current) return;\n        const controller = new AbortController();\n        const requestSession = sessionOf(current);\n        const timeout = window.setTimeout(() => {\n            Promise.resolve()\n                .then(() => current.completion.suggest(current.query, { signal: controller.signal }))\n                .then(\n                    suggestions => {\n                        if (!controller.signal.aborted) setAnswer({ session: requestSession, suggestions });\n                    },\n                    () => {\n                        if (!controller.signal.aborted) setAnswer({ session: requestSession, suggestions: [] });\n                    },\n                );\n        }, current.completion.debounce ?? defaultDebounce);\n\n        return () => {\n            window.clearTimeout(timeout);\n            controller.abort();\n        };\n    }, [request]);\n\n    // A dismissal lasts until the trigger it dismissed is gone - typing it again starts afresh.\n    useEffect(() => {\n        if (session === undefined) setDismissedSession(undefined);\n    }, [session]);\n\n    // An answer from the same session stays on screen while the next one is asked for, so the list\n    // does not flicker on every keystroke.\n    const suggestions = match && answer?.session === sessionOf(match) ? answer.suggestions : [];\n    const isOpen = suggestions.length > 0;\n    const highlighted = Math.min(activeIndex, Math.max(suggestions.length - 1, 0));\n\n    useEffect(() => setActiveIndex(0), [answer]);\n\n    const choose = (suggestion: MarkdownSuggestion) => {\n        if (!match) return undefined;\n        setAnswer(undefined);\n        return replaceRange(value, match.start, match.end, suggestion.insertText);\n    };\n\n    const handleKeyDown = (event: KeyboardEvent<HTMLTextAreaElement>) => {\n        if (!isOpen || !match) return undefined;\n        switch (event.key) {\n            case 'ArrowDown':\n                event.preventDefault();\n                setActiveIndex((highlighted + 1) % suggestions.length);\n                return undefined;\n            case 'ArrowUp':\n                event.preventDefault();\n                setActiveIndex((highlighted - 1 + suggestions.length) % suggestions.length);\n                return undefined;\n            case 'Enter':\n            case 'Tab':\n                event.preventDefault();\n                return choose(suggestions[highlighted]);\n            case 'Escape':\n                event.preventDefault();\n                event.stopPropagation();\n                setDismissedSession(sessionOf(match));\n                return undefined;\n            default:\n                return undefined;\n        }\n    };\n\n    return {\n        match,\n        suggestions,\n        isOpen,\n        activeIndex: highlighted,\n        highlight: setActiveIndex,\n        choose,\n        handleKeyDown,\n    };\n};\n"],"names":[],"mappings":"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"}

package/dist/esm/MarkdownEditor/useMarkdownUploads.d.ts

@@ -0,0 +1,38 @@
+/**
+ * What {@link useMarkdownUploads} needs from the editor it uploads for.
+ */
+export interface MarkdownUploadsOptions {
+    /** Uploads one file and returns the markdown that stands for it. Omit to turn uploads off. */
+    uploadFile?: (file: File) => Promise<string>;
+    /** Told about a file whose upload failed; its placeholder has already been taken out again. */
+    onUploadFailed?: (file: File, error: unknown) => void;
+    /** Reads the markdown as it is right now, not as it was when an upload started. */
+    currentValue: () => string;
+    /** Puts text in at the caret. */
+    insertAtCaret: (text: string) => void;
+    /** Replaces the whole markdown. */
+    replaceValue: (value: string) => void;
+}
+/**
+ * The state of the uploads started from an editor, as {@link useMarkdownUploads} reports it.
+ */
+export interface MarkdownUploadsState {
+    /** Whether files can be uploaded at all. */
+    isEnabled: boolean;
+    /** The names of the files uploading right now, in the order they were added. */
+    uploading: readonly string[];
+    /**
+     * Uploads files, each behind a placeholder put in at the caret straight away.
+     * @param files The files to upload.
+     */
+    upload: (files: readonly File[]) => void;
+}
+/**
+ * Uploads pasted and dropped files. Every file gets its placeholder at the caret first, so several
+ * added at once keep their order wherever the caret wanders, and each placeholder is resolved by value
+ * when its upload answers - replaced by the returned markdown, or taken out when the upload fails.
+ * @param options The {@link MarkdownUploadsOptions}.
+ * @returns The {@link MarkdownUploadsState}.
+ */
+export declare const useMarkdownUploads: (options: MarkdownUploadsOptions) => MarkdownUploadsState;
+//# sourceMappingURL=useMarkdownUploads.d.ts.map

package/dist/esm/MarkdownEditor/useMarkdownUploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdownUploads.d.ts","sourceRoot":"","sources":["../../../MarkdownEditor/useMarkdownUploads.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,8FAA8F;IAC9F,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7C,+FAA+F;IAC/F,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtD,mFAAmF;IACnF,YAAY,EAAE,MAAM,MAAM,CAAC;IAE3B,iCAAiC;IACjC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,mCAAmC;IACnC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IAEnB,gFAAgF;IAChF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAE7B;;;OAGG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,YAAa,sBAAsB,KAAG,oBAkDpE,CAAC"}

package/dist/esm/MarkdownEditor/useMarkdownUploads.js

@@ -0,0 +1,55 @@
+import { useState, useRef, useEffect } from 'react';
+import { replacePlaceholder } from './replacePlaceholder.js';
+import { uploadPlaceholderFor } from './uploadPlaceholderFor.js';
+
+const useMarkdownUploads = (options) => {
+    const [uploading, setUploading] = useState([]);
+    const optionsRef = useRef(options);
+    const mounted = useRef(true);
+    useEffect(() => {
+        optionsRef.current = options;
+    });
+    useEffect(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+        };
+    }, []);
+    const uploadOne = async (file, uploadFile) => {
+        const placeholder = uploadPlaceholderFor(file.name);
+        optionsRef.current.insertAtCaret(`${placeholder}\n`);
+        setUploading(current => [...current, file.name]);
+        try {
+            const markup = await uploadFile(file);
+            if (mounted.current) {
+                optionsRef.current.replaceValue(replacePlaceholder(optionsRef.current.currentValue(), placeholder, markup));
+            }
+        }
+        catch (error) {
+            if (mounted.current) {
+                const current = optionsRef.current.currentValue();
+                const inserted = current.includes(`${placeholder}\n`) ? `${placeholder}\n` : placeholder;
+                optionsRef.current.replaceValue(replacePlaceholder(current, inserted, ''));
+            }
+            optionsRef.current.onUploadFailed?.(file, error);
+        }
+        finally {
+            if (mounted.current) {
+                setUploading(current => {
+                    const index = current.indexOf(file.name);
+                    return index === -1 ? current : [...current.slice(0, index), ...current.slice(index + 1)];
+                });
+            }
+        }
+    };
+    const upload = (files) => {
+        const uploadFile = optionsRef.current.uploadFile;
+        if (!uploadFile)
+            return;
+        void Promise.all(files.map(file => uploadOne(file, uploadFile)));
+    };
+    return { isEnabled: options.uploadFile !== undefined, uploading, upload };
+};
+
+export { useMarkdownUploads };
+//# sourceMappingURL=useMarkdownUploads.js.map

package/dist/esm/MarkdownEditor/useMarkdownUploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdownUploads.js","sources":["../../../MarkdownEditor/useMarkdownUploads.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useEffect, useRef, useState } from 'react';\nimport { replacePlaceholder } from './replacePlaceholder';\nimport { uploadPlaceholderFor } from './uploadPlaceholderFor';\n\n/**\n * What {@link useMarkdownUploads} needs from the editor it uploads for.\n */\nexport interface MarkdownUploadsOptions {\n    /** Uploads one file and returns the markdown that stands for it. Omit to turn uploads off. */\n    uploadFile?: (file: File) => Promise<string>;\n\n    /** Told about a file whose upload failed; its placeholder has already been taken out again. */\n    onUploadFailed?: (file: File, error: unknown) => void;\n\n    /** Reads the markdown as it is right now, not as it was when an upload started. */\n    currentValue: () => string;\n\n    /** Puts text in at the caret. */\n    insertAtCaret: (text: string) => void;\n\n    /** Replaces the whole markdown. */\n    replaceValue: (value: string) => void;\n}\n\n/**\n * The state of the uploads started from an editor, as {@link useMarkdownUploads} reports it.\n */\nexport interface MarkdownUploadsState {\n    /** Whether files can be uploaded at all. */\n    isEnabled: boolean;\n\n    /** The names of the files uploading right now, in the order they were added. */\n    uploading: readonly string[];\n\n    /**\n     * Uploads files, each behind a placeholder put in at the caret straight away.\n     * @param files The files to upload.\n     */\n    upload: (files: readonly File[]) => void;\n}\n\n/**\n * Uploads pasted and dropped files. Every file gets its placeholder at the caret first, so several\n * added at once keep their order wherever the caret wanders, and each placeholder is resolved by value\n * when its upload answers - replaced by the returned markdown, or taken out when the upload fails.\n * @param options The {@link MarkdownUploadsOptions}.\n * @returns The {@link MarkdownUploadsState}.\n */\nexport const useMarkdownUploads = (options: MarkdownUploadsOptions): MarkdownUploadsState => {\n    const [uploading, setUploading] = useState<readonly string[]>([]);\n    const optionsRef = useRef(options);\n    const mounted = useRef(true);\n\n    useEffect(() => {\n        optionsRef.current = options;\n    });\n\n    useEffect(() => {\n        mounted.current = true;\n        return () => {\n            mounted.current = false;\n        };\n    }, []);\n\n    const uploadOne = async (file: File, uploadFile: (file: File) => Promise<string>) => {\n        const placeholder = uploadPlaceholderFor(file.name);\n        optionsRef.current.insertAtCaret(`${placeholder}\\n`);\n        setUploading(current => [...current, file.name]);\n\n        try {\n            const markup = await uploadFile(file);\n            if (mounted.current) {\n                optionsRef.current.replaceValue(replacePlaceholder(optionsRef.current.currentValue(), placeholder, markup));\n            }\n        } catch (error) {\n            if (mounted.current) {\n                const current = optionsRef.current.currentValue();\n                const inserted = current.includes(`${placeholder}\\n`) ? `${placeholder}\\n` : placeholder;\n                optionsRef.current.replaceValue(replacePlaceholder(current, inserted, ''));\n            }\n            optionsRef.current.onUploadFailed?.(file, error);\n        } finally {\n            if (mounted.current) {\n                setUploading(current => {\n                    const index = current.indexOf(file.name);\n                    return index === -1 ? current : [...current.slice(0, index), ...current.slice(index + 1)];\n                });\n            }\n        }\n    };\n\n    const upload = (files: readonly File[]) => {\n        const uploadFile = optionsRef.current.uploadFile;\n        if (!uploadFile) return;\n        void Promise.all(files.map(file => uploadOne(file, uploadFile)));\n    };\n\n    return { isEnabled: options.uploadFile !== undefined, uploading, upload };\n};\n"],"names":[],"mappings":";;;;AAmDO,MAAM,kBAAkB,GAAG,CAAC,OAA+B,KAA0B;IACxF,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAoB,EAAE,CAAC;AACjE,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;AAClC,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;IAE5B,SAAS,CAAC,MAAK;AACX,QAAA,UAAU,CAAC,OAAO,GAAG,OAAO;AAChC,IAAA,CAAC,CAAC;IAEF,SAAS,CAAC,MAAK;AACX,QAAA,OAAO,CAAC,OAAO,GAAG,IAAI;AACtB,QAAA,OAAO,MAAK;AACR,YAAA,OAAO,CAAC,OAAO,GAAG,KAAK;AAC3B,QAAA,CAAC;IACL,CAAC,EAAE,EAAE,CAAC;IAEN,MAAM,SAAS,GAAG,OAAO,IAAU,EAAE,UAA2C,KAAI;QAChF,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;QACnD,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA,EAAG,WAAW,CAAA,EAAA,CAAI,CAAC;AACpD,QAAA,YAAY,CAAC,OAAO,IAAI,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAEhD,QAAA,IAAI;AACA,YAAA,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;AACrC,YAAA,IAAI,OAAO,CAAC,OAAO,EAAE;AACjB,gBAAA,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YAC/G;QACJ;QAAE,OAAO,KAAK,EAAE;AACZ,YAAA,IAAI,OAAO,CAAC,OAAO,EAAE;gBACjB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE;gBACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA,EAAG,WAAW,CAAA,EAAA,CAAI,CAAC,GAAG,GAAG,WAAW,CAAA,EAAA,CAAI,GAAG,WAAW;AACxF,gBAAA,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC9E;YACA,UAAU,CAAC,OAAO,CAAC,cAAc,GAAG,IAAI,EAAE,KAAK,CAAC;QACpD;gBAAU;AACN,YAAA,IAAI,OAAO,CAAC,OAAO,EAAE;gBACjB,YAAY,CAAC,OAAO,IAAG;oBACnB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;AACxC,oBAAA,OAAO,KAAK,KAAK,EAAE,GAAG,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAC7F,gBAAA,CAAC,CAAC;YACN;QACJ;AACJ,IAAA,CAAC;AAED,IAAA,MAAM,MAAM,GAAG,CAAC,KAAsB,KAAI;AACtC,QAAA,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU;AAChD,QAAA,IAAI,CAAC,UAAU;YAAE;QACjB,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;AACpE,IAAA,CAAC;AAED,IAAA,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE;AAC7E;;"}