capacitor-sora-editor 1.2.1 → 1.8.2

package/android/sora-editor/editor/src/main/java/io/github/abc15018045126/sora/lang/EmptyLanguage.java

@@ -1,159 +0,0 @@
-/*
- *    sora-editor - the awesome code editor for Android
- *    https://github.com/abc15018045126/sora-editor
- *    Copyright (C) 2020-2024  abc15018045126
- *
- *     This library is free software; you can redistribute it and/or
- *     modify it under the terms of the GNU Lesser General Public
- *     License as published by the Free Software Foundation; either
- *     version 2.1 of the License, or (at your option) any later version.
- *
- *     This library is distributed in the hope that it will be useful,
- *     but WITHOUT ANY WARRANTY; without even the implied warranty of
- *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- *     Lesser General Public License for more details.
- *
- *     You should have received a copy of the GNU Lesser General Public
- *     License along with this library; if not, write to the Free Software
- *     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301
- *     USA
- *
- *     Please contact abc15018045126 by email 2073412493@qq.com if you need
- *     additional information or have any questions
- */
-package io.github.abc15018045126.sora.lang;
-
-import android.os.Bundle;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import io.github.abc15018045126.sora.lang.analysis.AnalyzeManager;
-import io.github.abc15018045126.sora.lang.completion.CompletionPublisher;
-import io.github.abc15018045126.sora.lang.format.Formatter;
-import io.github.abc15018045126.sora.lang.smartEnter.NewlineHandler;
-import io.github.abc15018045126.sora.lang.util.BaseAnalyzeManager;
-import io.github.abc15018045126.sora.text.CharPosition;
-import io.github.abc15018045126.sora.text.Content;
-import io.github.abc15018045126.sora.text.ContentReference;
-import io.github.abc15018045126.sora.text.TextRange;
-import io.github.abc15018045126.sora.widget.SymbolPairMatch;
-
-/**
- * Empty language
- *
- * @author abc15018045126
- */
-public class EmptyLanguage implements Language {
-
-
-    public final static SymbolPairMatch EMPTY_SYMBOL_PAIRS = new SymbolPairMatch();
-
-    @NonNull
-    @Override
-    public Formatter getFormatter() {
-        return EmptyFormatter.INSTANCE;
-    }
-
-    @Override
-    public SymbolPairMatch getSymbolPairs() {
-        return EMPTY_SYMBOL_PAIRS;
-    }
-
-    @Override
-    public void requireAutoComplete(@NonNull ContentReference content, @NonNull CharPosition position, @NonNull CompletionPublisher publisher, @NonNull Bundle extraArguments) {
-
-    }
-
-    @Override
-    public int getInterruptionLevel() {
-        return INTERRUPTION_LEVEL_STRONG;
-    }
-
-    @Override
-    public NewlineHandler[] getNewlineHandlers() {
-        return new NewlineHandler[0];
-    }
-
-    @NonNull
-    @Override
-    public AnalyzeManager getAnalyzeManager() {
-        return EmptyAnalyzeManager.INSTANCE;
-    }
-
-    @Override
-    public int getIndentAdvance(@NonNull ContentReference content, int line, int column) {
-        return 0;
-    }
-
-    @Nullable
-    @Override
-    public QuickQuoteHandler getQuickQuoteHandler() {
-        return null;
-    }
-
-
-    @Override
-    public void destroy() {
-
-    }
-
-    @Override
-    public boolean useTab() {
-        return false;
-    }
-
-    public static class EmptyFormatter implements Formatter {
-
-        public final static EmptyFormatter INSTANCE = new EmptyFormatter();
-
-        @Override
-        public void format(@NonNull Content text, @NonNull TextRange cursorRange) {
-
-        }
-
-        @Override
-        public void formatRegion(@NonNull Content text, @NonNull TextRange rangeToFormat, @NonNull TextRange cursorRange) {
-
-        }
-
-        @Override
-        public void setReceiver(@Nullable FormatResultReceiver receiver) {
-
-        }
-
-        @Override
-        public boolean isRunning() {
-            return false;
-        }
-
-        @Override
-        public void destroy() {
-
-        }
-    }
-
-    public static class EmptyAnalyzeManager extends BaseAnalyzeManager {
-
-        public final static EmptyAnalyzeManager INSTANCE = new EmptyAnalyzeManager();
-
-
-        @Override
-        public void insert(@NonNull CharPosition start, @NonNull CharPosition end, @NonNull CharSequence insertedContent) {
-
-        }
-
-        @Override
-        public void delete(@NonNull CharPosition start, @NonNull CharPosition end, @NonNull CharSequence deletedContent) {
-
-        }
-
-        @Override
-        public void rerun() {
-
-        }
-
-    }
-}
-
-

package/android/sora-editor/editor/src/main/java/io/github/abc15018045126/sora/lang/Language.java

@@ -1,215 +0,0 @@
-/*
- *    sora-editor - the awesome code editor for Android
- *    https://github.com/abc15018045126/sora-editor
- *    Copyright (C) 2020-2024  abc15018045126
- *
- *     This library is free software; you can redistribute it and/or
- *     modify it under the terms of the GNU Lesser General Public
- *     License as published by the Free Software Foundation; either
- *     version 2.1 of the License, or (at your option) any later version.
- *
- *     This library is distributed in the hope that it will be useful,
- *     but WITHOUT ANY WARRANTY; without even the implied warranty of
- *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- *     Lesser General Public License for more details.
- *
- *     You should have received a copy of the GNU Lesser General Public
- *     License along with this library; if not, write to the Free Software
- *     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301
- *     USA
- *
- *     Please contact abc15018045126 by email 2073412493@qq.com if you need
- *     additional information or have any questions
- */
-package io.github.abc15018045126.sora.lang;
-
-import android.os.Bundle;
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-import androidx.annotation.UiThread;
-import androidx.annotation.WorkerThread;
-import io.github.abc15018045126.sora.lang.analysis.AnalyzeManager;
-import io.github.abc15018045126.sora.lang.completion.CompletionCancelledException;
-import io.github.abc15018045126.sora.lang.completion.CompletionHelper;
-import io.github.abc15018045126.sora.lang.completion.CompletionPublisher;
-import io.github.abc15018045126.sora.lang.format.Formatter;
-import io.github.abc15018045126.sora.lang.smartEnter.NewlineHandler;
-import io.github.abc15018045126.sora.text.CharPosition;
-import io.github.abc15018045126.sora.text.ContentReference;
-import io.github.abc15018045126.sora.widget.CodeEditor;
-import io.github.abc15018045126.sora.widget.SymbolPairMatch;
-
-/**
- * Language for editor
- * <p>
- * A Language helps editor to highlight text and provide auto-completion.
- * Implement this interface when you want to add new language support for editor.
- * <p>
- * <strong>NOTE:</strong> A language must not be single instance.
- * One language instance should always serve for only one editor.
- * It means that you should not give one language object to other editor instances
- * after it has been applied to one editor.
- *
- * @author abc15018045126
- */
-public interface Language {
-
-    /**
-     * Set the thread's interrupted flag by calling {@link Thread#interrupt()}.
-     * <p>
-     * Throw {@link CompletionCancelledException} exceptions
-     * from {@link ContentReference} and {@link CompletionPublisher}.
-     * <p>
-     * Set thread's flag for abortion.
-     */
-    int INTERRUPTION_LEVEL_STRONG = 0;
-    /**
-     * Throw {@link CompletionCancelledException} exceptions
-     * from {@link ContentReference} and {@link CompletionPublisher}.
-     * <p>
-     * Set thread's flag for abortion.
-     */
-    int INTERRUPTION_LEVEL_SLIGHT = 1;
-    /**
-     * Throw {@link CompletionCancelledException} exceptions
-     * from {@link ContentReference}
-     * <p>
-     * Set thread's flag for abortion.
-     */
-    int INTERRUPTION_LEVEL_NONE = 2;
-
-    /**
-     * Get {@link AnalyzeManager} of the language.
-     * This is called from time to time by the editor. Cache your instance please.
-     */
-    @NonNull
-    AnalyzeManager getAnalyzeManager();
-
-    /**
-     * Get the interruption level for auto-completion.
-     *
-     * @see #INTERRUPTION_LEVEL_STRONG
-     * @see #INTERRUPTION_LEVEL_SLIGHT
-     * @see #INTERRUPTION_LEVEL_NONE
-     */
-    int getInterruptionLevel();
-
-    /**
-     * Request to auto-complete the code at the given {@code position}.
-     * This is called in a worker thread other than UI thread.
-     *
-     * @param content        Read-only reference of content
-     * @param position       The position for auto-complete
-     * @param publisher      The publisher used to update items
-     * @param extraArguments Arguments set by {@link CodeEditor#setText(CharSequence, Bundle)}
-     * @throws io.github.abc15018045126.sora.lang.completion.CompletionCancelledException This thread can be abandoned
-     *                                                                             by the editor framework because the auto-completion items of
-     *                                                                             this invocation are no longer needed by the user. This can either be thrown
-     *                                                                             by {@link ContentReference} or {@link CompletionPublisher}.
-     *                                                                             How the exceptions will be thrown is according to
-     *                                                                             your settings: {@link #getInterruptionLevel()}
-     * @see ContentReference
-     * @see CompletionPublisher
-     * @see #getInterruptionLevel()
-     * @see CompletionHelper#checkCancelled()
-     */
-    @WorkerThread
-    void requireAutoComplete(@NonNull ContentReference content, @NonNull CharPosition position,
-                             @NonNull CompletionPublisher publisher,
-                             @NonNull Bundle extraArguments) throws CompletionCancelledException;
-
-    /**
-     * Get delta indent spaces count.
-     *
-     * @param content Content of given line.
-     * @param line    0-indexed line number. The indentation is applied on line index: {@code line + 1}.
-     * @param column  Column on the given line, where a line separator is inserted.
-     * @return Delta count of indent spaces. It can be a negative/positive number or zero.
-     */
-    @UiThread
-    int getIndentAdvance(@NonNull ContentReference content, int line, int column);
-
-    /**
-     * Get delta indent spaces count.
-     *
-     * @param content          Content of given line.
-     * @param line             0-indexed line number. The indentation is applied on line index: {@code line + 1}.
-     * @param column           Column on the given line, where a line separator is inserted.
-     * @param spaceCountOnLine The number of spaces on {@code line}.
-     * @param tabCountOnLine   The number of tabs on {@code line}.
-     * @return Delta count of indent spaces. It can be a negative/positive number or zero.
-     */
-    @UiThread
-    default int getIndentAdvance(
-      @NonNull ContentReference content,
-      int line,
-      int column,
-      int spaceCountOnLine,
-      int tabCountOnLine
-    ) {
-        return getIndentAdvance(content, line, column);
-    }
-
-    /**
-     * Use tab to format
-     */
-    @UiThread
-    boolean useTab();
-
-
-    /**
-     * Get the code formatter for the current language.
-     * The formatter is expected to be the same one during the lifecycle of a language instance.
-     *
-     * @return The code formatter for the current language.
-     */
-    @UiThread
-    @NonNull
-    Formatter getFormatter();
-
-    /**
-     * Returns language specified symbol pairs.
-     * The method is called only once when the language is applied.
-     */
-    @UiThread
-    SymbolPairMatch getSymbolPairs();
-
-    /**
-     * Get newline handlers of this language.
-     * This method is called each time the user presses ENTER key.
-     * <p>
-     * Pay attention to the performance as this method is called frequently
-     *
-     * @return NewlineHandlers , maybe null
-     */
-    @UiThread
-    @Nullable
-    NewlineHandler[] getNewlineHandlers();
-
-    /**
-     * Get newline handlers of this language.
-     * This method is called each time the user types a single character (or a single code point)
-     * and some text is currently selected.
-     * <p>
-     * Pay attention to the performance as this method is called frequently
-     *
-     * @return QuickQuoteHandler, maybe null
-     */
-    @UiThread
-    @Nullable
-    default QuickQuoteHandler getQuickQuoteHandler() {
-        return null;
-    }
-
-    /**
-     * Destroy this {@link Language} object.
-     * <p>
-     * When called, you should stop your resource-taking actions and remove any reference
-     * of editor or other objects related to editor (such as references to text in editor) to avoid
-     * memory leaks and resource waste.
-     */
-    @UiThread
-    void destroy();
-
-}
-

package/android/sora-editor/editor/src/main/java/io/github/abc15018045126/sora/lang/QuickQuoteHandler.java

@@ -1,78 +0,0 @@
-/*
- *    sora-editor - the awesome code editor for Android
- *    https://github.com/abc15018045126/sora-editor
- *    Copyright (C) 2020-2024  abc15018045126
- *
- *     This library is free software; you can redistribute it and/or
- *     modify it under the terms of the GNU Lesser General Public
- *     License as published by the Free Software Foundation; either
- *     version 2.1 of the License, or (at your option) any later version.
- *
- *     This library is distributed in the hope that it will be useful,
- *     but WITHOUT ANY WARRANTY; without even the implied warranty of
- *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- *     Lesser General Public License for more details.
- *
- *     You should have received a copy of the GNU Lesser General Public
- *     License along with this library; if not, write to the Free Software
- *     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301
- *     USA
- *
- *     Please contact abc15018045126 by email 2073412493@qq.com if you need
- *     additional information or have any questions
- */
-package io.github.abc15018045126.sora.lang;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import io.github.abc15018045126.sora.lang.styling.Styles;
-import io.github.abc15018045126.sora.text.Content;
-import io.github.abc15018045126.sora.text.TextRange;
-
-public interface QuickQuoteHandler {
-
-    /**
-     * Checks whether the given input matches the requirement to invoke this handler
-     *
-     * @param candidateCharacter The character going to be inserted. Length can be 1 or 2.
-     * @param text               Current text in editor
-     * @param cursor             The range of cursor
-     * @param style              Current code styles
-     * @return Whether this handler consumed the event
-     */
-    @NonNull
-    HandleResult onHandleTyping(@NonNull String candidateCharacter, @NonNull Content text, @NonNull TextRange cursor, @Nullable Styles style);
-
-    class HandleResult {
-
-        public final static HandleResult NOT_CONSUMED = new HandleResult(false, null);
-
-        private boolean consumed;
-
-        private TextRange newCursorRange;
-
-        public HandleResult(boolean consumed, TextRange newCursorRange) {
-            this.consumed = consumed;
-            this.newCursorRange = newCursorRange;
-        }
-
-        public boolean isConsumed() {
-            return consumed;
-        }
-
-        public void setConsumed(boolean consumed) {
-            this.consumed = consumed;
-        }
-
-        public TextRange getNewCursorRange() {
-            return newCursorRange;
-        }
-
-        public void setNewCursorRange(TextRange newCursorRange) {
-            this.newCursorRange = newCursorRange;
-        }
-    }
-
-}
-

package/android/sora-editor/editor/src/main/java/io/github/abc15018045126/sora/lang/analysis/AnalyzeManager.java

@@ -1,97 +0,0 @@
-/*
- *    sora-editor - the awesome code editor for Android
- *    https://github.com/abc15018045126/sora-editor
- *    Copyright (C) 2020-2024  abc15018045126
- *
- *     This library is free software; you can redistribute it and/or
- *     modify it under the terms of the GNU Lesser General Public
- *     License as published by the Free Software Foundation; either
- *     version 2.1 of the License, or (at your option) any later version.
- *
- *     This library is distributed in the hope that it will be useful,
- *     but WITHOUT ANY WARRANTY; without even the implied warranty of
- *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- *     Lesser General Public License for more details.
- *
- *     You should have received a copy of the GNU Lesser General Public
- *     License along with this library; if not, write to the Free Software
- *     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301
- *     USA
- *
- *     Please contact abc15018045126 by email 2073412493@qq.com if you need
- *     additional information or have any questions
- */
-package io.github.abc15018045126.sora.lang.analysis;
-
-import android.os.Bundle;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import io.github.abc15018045126.sora.text.CharPosition;
-import io.github.abc15018045126.sora.text.Content;
-import io.github.abc15018045126.sora.text.ContentReference;
-import io.github.abc15018045126.sora.widget.CodeEditor;
-
-/**
- * AnalyzeManager receives text updates and do its work to start lexers/parsers to analyze the code
- * so that we can provide syntax-highlighting and exact auto-completion.
- *
- * @author abc15018045126
- */
-public interface AnalyzeManager {
-
-    /**
-     * Set the span receiver of the manager.
-     * <p>
-     * This is called when the {@link io.github.abc15018045126.sora.lang.Language} is going to be used by
-     * an editor. It will also be called when the instance is no longer used.
-     * Make sure you check the exact receiver at the time you send results to it.
-     * Thus, you should save the instance at your side.
-     */
-    void setReceiver(@Nullable StyleReceiver receiver);
-
-    /**
-     * Called when new text is set in editor by either {@link CodeEditor#setText(CharSequence)}
-     * or {@link CodeEditor#setText(CharSequence, Bundle).}
-     *
-     * @param content        New text, read-only. Accesses to it are not validated. It is not recommended saving
-     *                       this object for reading. You can make a copy of the text and update it. But for
-     *                       memory saving, you may want to store it.
-     * @param extraArguments Arguments set by {@link CodeEditor#setText(CharSequence, Bundle)}
-     */
-    void reset(@NonNull ContentReference content, @NonNull Bundle extraArguments);
-
-    /**
-     * The {@link ContentReference} set by {@link #reset(ContentReference, Bundle)} has inserted
-     * text with the given position and text.
-     *
-     * @param start           The insertion start
-     * @param end             The insertion end
-     * @param insertedContent The content inserted
-     */
-    void insert(@NonNull CharPosition start, @NonNull CharPosition end, @NonNull CharSequence insertedContent);
-
-    /**
-     * The {@link ContentReference} set by {@link #reset(ContentReference, Bundle)} has deleted
-     * text with the given position and text.
-     *
-     * @param start          The deletion start
-     * @param end            The deletion end
-     * @param deletedContent The text deleted. Generated by {@link Content} object.
-     */
-    void delete(@NonNull CharPosition start, @NonNull CharPosition end, @NonNull CharSequence deletedContent);
-
-    /**
-     * Rerun the analysis forcibly
-     */
-    void rerun();
-
-    /**
-     * Destroy the manager. Release any resources held.
-     * Make sure that you will not call the receiver anymore.
-     */
-    void destroy();
-
-}
-