@lapismd/mira 0.0.1

package/dist/core/index.d.ts

@@ -0,0 +1,69 @@
+import { EditorState, type Extension } from "@codemirror/state";
+import { EditorView } from "@codemirror/view";
+import type { MiraAssetResolver, MiraExtension, MiraFileAdapter, MiraImageConfig, MiraMarkdownAuthoringConfig, MiraLinkResolver, MiraTemplateSelection, MiraMode } from "@lapismd/mira/extensions";
+import { type MiraMarkdownActionId } from "./markdown-actions";
+export { applyMiraMarkdownAction, isMiraMarkdownActionActive, miraMarkdownActionIds, type MiraMarkdownActionId, } from "./markdown-actions";
+export { createMiraCodeMirrorExtensions, type MiraCodeMirrorExtensionsOptions, } from "./code-mirror";
+export { createImageDropPasteExtension, createImageMarkdown, createUploadingImageMarkdown, defaultMiraEditorImageMaxSizeBytes, defaultMiraEditorImageMimeTypes, insertImageFiles, miraUploadingImageScheme, openImageFilePicker, resolveMiraImageConfig, } from "./images";
+export type { ResolvedMiraImageConfig } from "./images";
+export type MiraEditorPosition = {
+    line: number;
+    ch: number;
+};
+export type MiraEditorSelection = {
+    anchor: MiraEditorPosition;
+    head: MiraEditorPosition;
+};
+export type MiraEditorOptions = {
+    value?: string;
+    extensions?: MiraExtension[];
+    mode?: MiraMode;
+    readonly?: boolean;
+    placeholder?: string;
+    lineWrapping?: boolean;
+    spellcheck?: boolean;
+    sourcePath?: string;
+    linkResolver?: MiraLinkResolver;
+    assetResolver?: MiraAssetResolver;
+    fileAdapter?: MiraFileAdapter;
+    imageConfig?: MiraImageConfig;
+    authoring?: MiraMarkdownAuthoringConfig;
+    frontmatterOpen?: boolean;
+    frontmatterConfig?: unknown;
+    onChange?: (value: string, change: MiraEditorChange) => void;
+    onFrontmatterChange?: (nextYaml: string, nextValue: string) => void;
+    onSelectionChange?: (selection: MiraEditorSelection) => void;
+};
+export type MiraEditorChange = {
+    view: EditorView;
+    docChanged: boolean;
+    userEvent: string | undefined;
+};
+export type MiraEditorControllerOptions = MiraEditorOptions & {
+    codeMirrorExtensions?: Extension[];
+};
+export type MiraEditorControllerUpdate = Partial<Omit<MiraEditorControllerOptions, "codeMirrorExtensions">> & {
+    codeMirrorExtensions?: Extension[];
+};
+export declare function toOffset(doc: EditorState["doc"], position: MiraEditorPosition): number;
+export declare function fromOffset(doc: EditorState["doc"], offset: number): MiraEditorPosition;
+export declare class MiraEditorController {
+    readonly view: EditorView;
+    private value;
+    private options;
+    private suppressChange;
+    constructor(options?: MiraEditorControllerOptions);
+    mount(target: HTMLElement): void;
+    destroy(): void;
+    focus(): void;
+    getValue(): string;
+    setValue(value: string): void;
+    update(options: MiraEditorControllerUpdate): void;
+    getSelection(): MiraEditorSelection;
+    setSelection(selection: MiraEditorSelection): void;
+    replaceSelection(value: string, selection?: MiraTemplateSelection): void;
+    applyMarkdownAction(action: MiraMarkdownActionId): boolean;
+    private createState;
+}
+export declare function createMiraEditorController(options?: MiraEditorControllerOptions): MiraEditorController;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/index.js

@@ -0,0 +1,138 @@
+import { EditorSelection, EditorState, Transaction, } from "@codemirror/state";
+import { EditorView } from "@codemirror/view";
+import { applyMiraMarkdownAction, } from "./markdown-actions";
+export { applyMiraMarkdownAction, isMiraMarkdownActionActive, miraMarkdownActionIds, } from "./markdown-actions";
+export { createMiraCodeMirrorExtensions, } from "./code-mirror";
+export { createImageDropPasteExtension, createImageMarkdown, createUploadingImageMarkdown, defaultMiraEditorImageMaxSizeBytes, defaultMiraEditorImageMimeTypes, insertImageFiles, miraUploadingImageScheme, openImageFilePicker, resolveMiraImageConfig, } from "./images";
+export function toOffset(doc, position) {
+    const lineNumber = Math.max(1, Math.min(doc.lines, position.line + 1));
+    const line = doc.line(lineNumber);
+    return Math.max(line.from, Math.min(line.to, line.from + position.ch));
+}
+export function fromOffset(doc, offset) {
+    const line = doc.lineAt(Math.max(0, Math.min(doc.length, offset)));
+    return {
+        line: line.number - 1,
+        ch: offset - line.from,
+    };
+}
+export class MiraEditorController {
+    view;
+    value;
+    options;
+    suppressChange = false;
+    constructor(options = {}) {
+        this.value = options.value ?? "";
+        this.options = options;
+        this.view = new EditorView({
+            state: this.createState(this.value, options.codeMirrorExtensions ?? []),
+            dispatch: (transaction) => {
+                this.view.update([transaction]);
+                if (transaction.docChanged) {
+                    const nextValue = this.view.state.doc.toString();
+                    this.value = nextValue;
+                    if (!this.suppressChange) {
+                        this.options.onChange?.(nextValue, {
+                            view: this.view,
+                            docChanged: true,
+                            userEvent: transaction.annotation(Transaction.userEvent),
+                        });
+                    }
+                }
+                if (transaction.selection) {
+                    this.options.onSelectionChange?.(this.getSelection());
+                }
+            },
+        });
+    }
+    mount(target) {
+        if (this.view.dom.parentElement !== target) {
+            target.append(this.view.dom);
+        }
+    }
+    destroy() {
+        this.view.destroy();
+    }
+    focus() {
+        this.view.focus();
+    }
+    getValue() {
+        return this.view.state.doc.toString();
+    }
+    setValue(value) {
+        if (value === this.getValue()) {
+            return;
+        }
+        this.suppressChange = true;
+        this.value = value;
+        this.view.dispatch({
+            changes: {
+                from: 0,
+                to: this.view.state.doc.length,
+                insert: value,
+            },
+        });
+        this.suppressChange = false;
+    }
+    update(options) {
+        this.options = {
+            ...this.options,
+            ...options,
+        };
+        if (options.value !== undefined) {
+            this.setValue(options.value);
+        }
+        if (options.codeMirrorExtensions) {
+            const selection = this.view.state.selection;
+            this.view.setState(this.createState(this.getValue(), options.codeMirrorExtensions, selection));
+        }
+    }
+    getSelection() {
+        const selection = this.view.state.selection.main;
+        return {
+            anchor: fromOffset(this.view.state.doc, selection.anchor),
+            head: fromOffset(this.view.state.doc, selection.head),
+        };
+    }
+    setSelection(selection) {
+        this.view.dispatch({
+            selection: EditorSelection.single(toOffset(this.view.state.doc, selection.anchor), toOffset(this.view.state.doc, selection.head)),
+            scrollIntoView: true,
+        });
+    }
+    replaceSelection(value, selection) {
+        const range = this.view.state.selection.main;
+        const transaction = this.view.state.replaceSelection(value);
+        if (selection === undefined) {
+            this.view.dispatch(transaction);
+            return;
+        }
+        const relativeAnchor = typeof selection === "number" ? selection : selection.anchor;
+        const relativeHead = typeof selection === "number"
+            ? selection
+            : (selection.head ?? selection.anchor);
+        const nextLength = this.view.state.doc.length - (range.to - range.from) + value.length;
+        const anchor = clampOffset(range.from + relativeAnchor, nextLength);
+        const head = clampOffset(range.from + relativeHead, nextLength);
+        this.view.dispatch({
+            ...transaction,
+            selection: EditorSelection.single(anchor, head),
+        });
+    }
+    applyMarkdownAction(action) {
+        return applyMiraMarkdownAction(this.view, action);
+    }
+    createState(value, extensions, selection) {
+        return EditorState.create({
+            doc: value,
+            selection,
+            extensions,
+        });
+    }
+}
+function clampOffset(value, max) {
+    return Math.max(0, Math.min(max, value));
+}
+export function createMiraEditorController(options = {}) {
+    return new MiraEditorController(options);
+}

package/dist/core/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/core/index.test.d.ts.map

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

package/dist/core/index.test.js

@@ -0,0 +1,11 @@
+import { describe, expect, it } from "vitest";
+import { EditorState } from "@codemirror/state";
+import { fromOffset, toOffset } from ".";
+describe("position conversion", () => {
+    it("round trips offsets and editor positions", () => {
+        const state = EditorState.create({ doc: "one\ntwo" });
+        const position = fromOffset(state.doc, 5);
+        expect(position).toEqual({ line: 1, ch: 1 });
+        expect(toOffset(state.doc, position)).toBe(5);
+    });
+});

package/dist/core/markdown-actions.d.ts

@@ -0,0 +1,11 @@
+import { EditorState } from "@codemirror/state";
+import type { EditorView } from "@codemirror/view";
+export declare const miraMarkdownActionIds: readonly ["heading", "bold", "italic", "strikethrough", "inlineCode", "quote", "bulletList", "numberedList", "taskList", "link"];
+export type MiraMarkdownActionId = (typeof miraMarkdownActionIds)[number];
+export declare function applyMiraMarkdownAction(view: EditorView, action: MiraMarkdownActionId): boolean;
+/**
+ * Report whether the current selection would be unwrapped by an inline
+ * Markdown action. Line actions do not expose a binary active state.
+ */
+export declare function isMiraMarkdownActionActive(state: EditorState, action: MiraMarkdownActionId): boolean;
+//# sourceMappingURL=markdown-actions.d.ts.map

package/dist/core/markdown-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-actions.d.ts","sourceRoot":"","sources":["../../src/core/markdown-actions.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EAIZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAO,MAAM,qBAAqB,kIAWxB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AA8B1E,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAuBT;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAeT"}