capacitor-sora-editor 1.2.1 → 1.8.2

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

@@ -1,120 +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 androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import java.util.List;
-
-import io.github.abc15018045126.sora.lang.styling.Span;
-
-/**
- * Interface for line based analyze managers
- *
- * @param <S> State type at line endings
- * @param <T> Token type
- */
-public interface IncrementalAnalyzeManager<S, T> extends AnalyzeManager {
-
-    /**
-     * Get the initial at document start
-     */
-    S getInitialState();
-
-    /**
-     * Get recorded state for subclass
-     */
-    LineTokenizeResult<S, T> getState(int line);
-
-    /**
-     * Compare the two states.
-     * Return true if they equal
-     */
-    boolean stateEquals(S state, S another);
-
-    /**
-     * Tokenize for the given line
-     *
-     * @param lineIndex -1 for unknown
-     */
-    LineTokenizeResult<S, T> tokenizeLine(CharSequence line, S state, int lineIndex);
-
-    /**
-     * Generate spans for the line
-     */
-    List<Span> generateSpansForLine(LineTokenizeResult<S, T> tokens);
-
-    /**
-     * Called when a State object is to be abandoned
-     */
-    void onAbandonState(S state);
-
-    /**
-     * Called when a State object is to be added
-     */
-    void onAddState(S state);
-
-    /**
-     * Saved state
-     */
-    class LineTokenizeResult<S_, T_> {
-
-        /**
-         * State at line end
-         */
-        public S_ state;
-
-        /**
-         * Tokens on this line
-         */
-        public List<T_> tokens;
-
-        /**
-         * Spans. If spans are generated as well you can directly return them here to avoid
-         * {@link #generateSpansForLine(LineTokenizeResult)} calls.
-         */
-        public List<Span> spans;
-
-        public LineTokenizeResult(@NonNull S_ state, @Nullable List<T_> tokens) {
-            this.state = state;
-            this.tokens = tokens;
-        }
-
-        public LineTokenizeResult(@NonNull S_ state, @Nullable List<T_> tokens, @Nullable List<Span> spans) {
-            this.state = state;
-            this.tokens = tokens;
-            this.spans = spans;
-        }
-
-        protected LineTokenizeResult<S_, T_> clearSpans() {
-            spans = null;
-            return this;
-        }
-
-    }
-
-
-}
-

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

@@ -1,238 +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 android.util.Log;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import io.github.abc15018045126.sora.lang.styling.Styles;
-import io.github.abc15018045126.sora.text.CharPosition;
-import io.github.abc15018045126.sora.text.ContentReference;
-import io.github.abc15018045126.sora.widget.CodeEditor;
-
-/**
- * Built-in implementation of {@link AnalyzeManager}.
- * <p>
- * This is a simple version without any incremental actions.
- * <p>
- * The analysis will always re-run when the text changes. Hopefully, it will stop previous outdated
- * runs by provide a {@link Delegate} object.
- *
- * @param <V> The shared object type that we get for auto-completion.
- */
-public abstract class SimpleAnalyzeManager<V> implements AnalyzeManager {
-
-    private final static String LOG_TAG = "SimpleAnalyzeManager";
-    private static int sThreadId = 0;
-    private final Object lock = new Object();
-    private StyleReceiver receiver;
-    private volatile ContentReference ref;
-    private Bundle extraArguments;
-    private volatile long newestRequestId;
-    private AnalyzeThread thread;
-    private V data;
-
-    private synchronized static int nextThreadId() {
-        sThreadId++;
-        return sThreadId;
-    }
-
-    @Override
-    public void setReceiver(@Nullable StyleReceiver receiver) {
-        this.receiver = receiver;
-    }
-
-    @Override
-    public void reset(@NonNull ContentReference content, @NonNull Bundle extraArguments) {
-        this.ref = content;
-        this.extraArguments = extraArguments;
-        rerun();
-    }
-
-    @Override
-    public void insert(@NonNull CharPosition start, @NonNull CharPosition end, @NonNull CharSequence insertedContent) {
-        rerun();
-    }
-
-    @Override
-    public void delete(@NonNull CharPosition start, @NonNull CharPosition end, @NonNull CharSequence deletedContent) {
-        rerun();
-    }
-
-    @Override
-    public synchronized void rerun() {
-        newestRequestId++;
-        if (thread == null || !thread.isAlive()) {
-            // Create new thread
-            Log.v(LOG_TAG, "Starting a new thread for analysis");
-            thread = new AnalyzeThread();
-            thread.setDaemon(true);
-            thread.setName("SplAnalyzer-" + nextThreadId());
-            thread.start();
-        }
-        synchronized (lock) {
-            lock.notify();
-        }
-    }
-
-    @Override
-    public void destroy() {
-        ref = null;
-        extraArguments = null;
-        newestRequestId = 0;
-        data = null;
-        if (thread != null && thread.isAlive()) {
-            thread.interrupt();
-        }
-        thread = null;
-        receiver = null;
-    }
-
-    /**
-     * Get extra arguments set by {@link CodeEditor#setText(CharSequence, Bundle)}
-     */
-    public Bundle getExtraArguments() {
-        return extraArguments;
-    }
-
-    /**
-     * Get data set by analyze thread
-     */
-    @Nullable
-    public V getData() {
-        return data;
-    }
-
-    /**
-     * Analyze the given input.
-     *
-     * @param text     A {@link StringBuilder} instance containing the text in editor. DO NOT SAVE THE INSTANCE OR
-     *                 UPDATE IT. It is continuously used by this analyzer.
-     * @param delegate A delegate used to check whether this invocation is outdated. You should stop your logic
-     *                 if {@link Delegate#isCancelled()} returns true.
-     * @return Styles created according to the text.
-     */
-    protected abstract Styles analyze(StringBuilder text, Delegate<V> delegate);
-
-    /**
-     * Analyze thread.
-     * <p>
-     * The thread will keep alive unless there is any exception or {@link AnalyzeManager#destroy()}
-     * is called.
-     */
-    private class AnalyzeThread extends Thread {
-
-        /**
-         * Single instance for text storing
-         */
-        private final StringBuilder textContainer = new StringBuilder();
-
-        @Override
-        public void run() {
-            Log.v(LOG_TAG, "Analyze thread started");
-            try {
-                while (!isInterrupted()) {
-                    var text = ref;
-                    if (text != null) {
-                        var requestId = 0L;
-                        Styles result = null;
-                        V newData = null;
-                        // Do the analysis, until the requestId matches
-                        do {
-                            text = ref;
-                            if (text == null) {
-                                break;
-                            }
-                            requestId = newestRequestId;
-                            var delegate = new Delegate<V>(requestId);
-
-                            // Collect line contents
-                            textContainer.setLength(0);
-                            textContainer.ensureCapacity(text.length());
-                            for (int i = 0; i < text.getLineCount() && requestId == newestRequestId; i++) {
-                                if (i != 0) {
-                                    textContainer.append(text.getLineSeparator(i - 1));
-                                }
-                                text.appendLineTo(textContainer, i);
-                            }
-
-                            // Invoke the implementation
-                            result = analyze(textContainer, delegate);
-                            newData = delegate.data;
-                        } while (requestId != newestRequestId);
-                        // Send result
-                        final var receiver = SimpleAnalyzeManager.this.receiver;
-                        if (receiver != null && result != null) {
-                            receiver.setStyles(SimpleAnalyzeManager.this, result);
-                        }
-                        data = newData;
-                    }
-                    // Wait for next time
-                    synchronized (lock) {
-                        lock.wait();
-                    }
-                }
-            } catch (InterruptedException e) {
-                Log.v(LOG_TAG, "Thread is interrupted.");
-            } catch (Exception e) {
-                Log.e(LOG_TAG, "Unexpected exception is thrown in the thread.", e);
-            }
-        }
-
-    }
-
-    /**
-     * Delegate between manager and analysis implementation
-     */
-    public final class Delegate<T> {
-
-        private final long myRequestId;
-        private T data;
-
-        public Delegate(long requestId) {
-            myRequestId = requestId;
-        }
-
-        /**
-         * Set shared data
-         */
-        public void setData(T value) {
-            data = value;
-        }
-
-        /**
-         * Check whether the operation is cancelled
-         */
-        public boolean isCancelled() {
-            return myRequestId != newestRequestId;
-        }
-
-    }
-
-
-}
-

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

@@ -1,90 +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 androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import io.github.abc15018045126.sora.lang.brackets.BracketsProvider;
-import io.github.abc15018045126.sora.lang.diagnostic.DiagnosticsContainer;
-import io.github.abc15018045126.sora.lang.styling.Styles;
-
-/**
- * A {@link StyleReceiver} receives spans and other styles from analyzers.
- * <p>
- * The implementations of the class must make sure its code can be safely run. For example, update
- * UI by posting its actions to UI thread, but not here.
- * <p>
- * Also, the implementations of the class should pay attention to concurrent invocations due not to
- * corrupt the information it maintains.
- *
- * @author abc15018045126
- */
-public interface StyleReceiver {
-
-    /**
-     * Send the styles to the receiver. You can call it in any thread.
-     * The implementation of this method should make sure that concurrent invocations to it are safe.
-     *
-     * @param sourceManager Source AnalyzeManager. The receiver may ignore the request if some checks on
-     *                      the sourceManager fail
-     */
-    void setStyles(@NonNull AnalyzeManager sourceManager, @Nullable Styles styles);
-
-    /**
-     * Send the styles to the receiver. You can call it in any thread.
-     * The implementation of this method should make sure that concurrent invocations to it are safe.
-     *
-     * @param sourceManager Source AnalyzeManager. The receiver may ignore the request if some checks on
-     *                      the sourceManager fail
-     * @param action Sometimes you may need to synchronize your action in main thread. This ensures the given action is executed
-     *               on main thread before the style updates.
-     */
-    void setStyles(@NonNull AnalyzeManager sourceManager, @Nullable Styles styles, @Nullable Runnable action);
-
-    /**
-     * Notify the receiver the given styles object is updated, and line range is given by {@code range}
-     *
-     * @param sourceManager Source AnalyzeManager. The receiver may ignore the request if some checks on
-     *                      the sourceManager fail
-     * @param styles        The Styles object previously set by {@link #setStyles(AnalyzeManager, Styles)}
-     * @param range         The line range of this update
-     */
-    default void updateStyles(@NonNull AnalyzeManager sourceManager, @NonNull Styles styles, @NonNull StyleUpdateRange range) {
-        setStyles(sourceManager, styles);
-    }
-
-    /**
-     * Specify new diagnostics. You can call it in any thread.
-     * The implementation of this method should make sure that concurrent invocations to it are safe.
-     */
-    void setDiagnostics(@NonNull AnalyzeManager sourceManager, @Nullable DiagnosticsContainer diagnostics);
-
-    /**
-     * Set new provider for brackets highlighting
-     */
-    void updateBracketProvider(@NonNull AnalyzeManager sourceManager, @Nullable BracketsProvider provider);
-
-}
-

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

@@ -1,49 +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.brackets;
-
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
-import io.github.abc15018045126.sora.text.Content;
-
-/**
- * Interface for providing paired brackets
- *
- * @author abc15018045126
- */
-public interface BracketsProvider {
-
-    /**
-     * Get left and right brackets position in text
-     *
-     * @param text  The text in editor
-     * @param index Index of cursor in text
-     * @return Paired positions or null if not matched
-     */
-    @Nullable
-    PairedBracket getPairedBracketAt(@NonNull Content text, int index);
-
-}
-

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

@@ -1,112 +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.brackets;
-
-import androidx.annotation.NonNull;
-
-import io.github.abc15018045126.sora.text.Content;
-
-/**
- * Compute paired bracket when queried
- *
- * @author abc15018045126
- */
-public class OnlineBracketsMatcher implements BracketsProvider {
-
-    private final char[] pairs;
-    private final int limit;
-
-    /**
-     * @param pairs Pairs. For example: {'(', ')', '{', '}'}
-     * @param limit Max length to search
-     */
-    public OnlineBracketsMatcher(char[] pairs, int limit) {
-        if ((pairs.length & 1) != 0) {
-            throw new IllegalArgumentException("pairs must have even length");
-        }
-        this.pairs = pairs;
-        this.limit = limit;
-    }
-
-    private int findIndex(char ch) {
-        for (int i = 0; i < pairs.length; i++) {
-            if (ch == pairs[i]) {
-                return i;
-            }
-        }
-        return -1;
-    }
-
-    private PairedBracket tryComputePaired(Content text, int index) {
-        char a = text.charAt(index);
-        int symbolIndex = findIndex(a);
-        if (symbolIndex != -1) {
-            char b = pairs[symbolIndex ^ 1];
-            int stack = 0;
-            if ((symbolIndex & 1) == 0) {
-                // Find forward
-                for (int i = index + 1; i < text.length() && i - index < limit; i++) {
-                    char ch = text.charAt(i);
-                    if (ch == b) {
-                        if (stack <= 0) {
-                            return new PairedBracket(index, i);
-                        } else {
-                            stack--;
-                        }
-                    } else if (ch == a) {
-                        stack++;
-                    }
-                }
-            } else {
-                // Find backward
-                for (int i = index - 1; i >= 0 && index - i < limit; i--) {
-                    char ch = text.charAt(i);
-                    if (ch == b) {
-                        if (stack <= 0) {
-                            return new PairedBracket(i, index);
-                        } else {
-                            stack--;
-                        }
-                    } else if (ch == a) {
-                        stack++;
-                    }
-                }
-            }
-        }
-        return null;
-    }
-
-    @Override
-    public PairedBracket getPairedBracketAt(@NonNull Content text, int index) {
-        PairedBracket pairedBracket = null;
-        if (index > 0) {
-            pairedBracket = tryComputePaired(text, index - 1);
-        }
-        if (pairedBracket == null && index < text.length()) {
-            pairedBracket = tryComputePaired(text, index);
-        }
-        return pairedBracket;
-    }
-}
-

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

@@ -1,57 +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.brackets;
-
-/**
- * Describes paired brackets
- *
- * @author abc15018045126
- */
-public class PairedBracket {
-
-    public final int leftIndex, leftLength, rightIndex, rightLength;
-
-    /**
-     * Currently length is always 1.
-     *
-     * @see #PairedBracket(int, int, int, int)
-     */
-    public PairedBracket(int leftIndex, int rightIndex) {
-        this(leftIndex, 1, rightIndex, 1);
-    }
-
-    /**
-     * @param leftIndex   Index of left bracket in text
-     * @param leftLength  Text length of left bracket
-     * @param rightIndex  Index of right bracket in text
-     * @param rightLength Text length of right bracket
-     */
-    public PairedBracket(int leftIndex, int leftLength, int rightIndex, int rightLength) {
-        this.leftIndex = leftIndex;
-        this.leftLength = leftLength;
-        this.rightIndex = rightIndex;
-        this.rightLength = rightLength;
-    }
-}
-