[
{
"path": ".gitattributes",
"content": "# Auto detect text files and perform LF normalization\n* text=auto\n\n# Java sources\n*.java text diff=java eol=lf\n*.gradle text diff=java eol=lf\n\n# These files are text and should be normalized (Convert crlf => lf)\n*.css text diff=css eol=lf\n*.html text diff=html eol=lf\n*.md text diff=markdown eol=lf\n*.js text eol=lf\n*.csv text eol=lf\n*.json text eol=lf\n*.properties text eol=lf\n*.svg text eol=lf\n*.xml text eol=lf\n*.yaml text eol=lf\n*.yml text eol=lf\n*.toml text eol=lf\n*.lang text eol=lf\n\n# These files are binary and should be left untouched\n*.png binary\n*.gif binary\n*.jpg binary\n*.jpeg binary\n\n# Common build-tool wrapper scripts\nmvnw text eol=lf\ngradlew text eol=lf\n*.sh text eol=lf\n*.bat text eol=crlf\n*.cmd text eol=crlf"
},
{
"path": ".github/ISSUE_TEMPLATE/bug_report.md",
"content": "---\nname: Bug report\nabout: Create a report to notify developers of unintended behavior\n\n---\n\n**Describe the bug**\n\n> A clear and concise description of what the bug is.\n\n**To Reproduce**\n\nSteps to reproduce the behavior:\n1. Open sample '...' _(provide sample download if possible)_\n2. Navigate to '....'\n3. Do something '....'\n4. See error\n\n**Exception**\n\nIf applicable, add the exception/stacktrace.\n```\nstacktrace goes here\n```\n\n**Screenshots**\n\nIf applicable, add screenshots to help explain your problem.\n"
},
{
"path": ".github/ISSUE_TEMPLATE/feature_request.md",
"content": "---\nname: Feature request\nabout: Suggest a feature to improve Recaf\n\n---\n\n## Feature_Name\n\nDescription of the feature"
},
{
"path": ".github/ISSUE_TEMPLATE/other.md",
"content": "---\nname: Other\nabout: If it isn't a bug or a feature request, choose this\n\n---\n\n"
},
{
"path": ".github/workflows/build.yml",
"content": "name: CI/CD\n\non:\n push:\n branches:\n - master\n pull_request:\n branches:\n - master\n workflow_dispatch:\n inputs:\n is-a-release:\n description: Publish release? (Only works on master, and for untagged versions)\n type: boolean\n\npermissions:\n contents: write\n\njobs:\n test:\n name: Run test suite\n strategy:\n fail-fast: false\n matrix:\n os: [ ubuntu-latest ]\n java-version: [ 22 ]\n runs-on: ubuntu-latest\n timeout-minutes: 10\n steps:\n - name: Checkout\n uses: actions/checkout@v3\n - name: Setup JDK\n uses: actions/setup-java@v3\n with:\n distribution: temurin\n java-version: 22\n check-latest: true\n # The project version extract NEEDS to have the gradle wrapper already downloaded.\n # So we have a dummy step here just to initialize it.\n - name: Setup Gradle\n uses: gradle/actions/setup-gradle@v4\n # Run the tests and upload results/coverage\n - name: Run tests\n run: ./gradlew test\n - name: Upload test coverage to CodeCov.io\n uses: codecov/codecov-action@v3\n env:\n CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}\n - name: Upload test artifacts\n if: always()\n uses: actions/upload-artifact@v4\n with:\n name: test-artifacts\n retention-days: 21\n path: |\n **/TEST-*\n **/hs_err_pid*\n # Build the distribution jar and upload it, without bundling JavaFX in the jar\n - name: Create distribution jar\n run: ./gradlew assemble -x compileTestJava -Dskip_jfx_bundle=true\n - name: Upload distribution jar\n if: always()\n uses: actions/upload-artifact@v4\n with:\n name: snapshot-build\n retention-days: 30\n path: |\n recaf-ui/build/libs/recaf-ui-*-all.jar\n\n # Publishes the test results from prior task work\n publish-test-results:\n name: Publish tests results\n needs: test\n if: always()\n runs-on: ubuntu-latest\n permissions:\n checks: write\n pull-requests: write\n steps:\n - name: Download artifacts\n uses: actions/download-artifact@v4\n with:\n name: test-artifacts\n - name: Publish test results\n uses: EnricoMi/publish-unit-test-result-action@v2\n with:\n check_name: Unit test results\n files: |\n **/*.xml\n\n # Builds the projects and attempts to publish a release if the current project version\n # does not match any existing tags in the repository.\n build-and-release:\n name: Publish release\n needs: test\n if: inputs.is-a-release && github.repository == 'Col-E/Recaf' && github.ref == 'refs/heads/master'\n strategy:\n fail-fast: false\n runs-on: ubuntu-latest\n timeout-minutes: 20\n steps:\n - name: Checkout\n uses: actions/checkout@v3\n with:\n fetch-depth: 0 # Required depth for JReleaser\n - name: Setup Java JDK\n uses: actions/setup-java@v3\n with:\n distribution: temurin\n java-version: 22\n # The project version extract NEEDS to have the gradle wrapper already downloaded.\n # So we have a dummy step here just to initialize it.\n - name: Setup Gradle\n uses: gradle/actions/setup-gradle@v4\n # Set environment variable for the project version: \"var_to_set=$(command_to_run)\" >> sink\n # - For maven: echo \"PROJECT_VERSION=$(./mvnw help:evaluate -Dexpression=project.version -q -DforceStdout)\" >> $GITHUB_ENV\n # - For gradle: echo \"PROJECT_VERSION=$(./gradlew properties | grep -Po '(?<=version: ).*')\" >> $GITHUB_ENV\n - name: Extract project version to environment variable\n run: echo \"PROJECT_VERSION=$(./gradlew properties | grep -Po '(?<=version\\W ).*')\" >> $GITHUB_ENV\n # Check if a tag exists that matches the current project version.\n # Write the existence state to the step output 'tagExists'.\n - name: Check the package version has corresponding Git tag\n id: tagged\n shell: bash\n run: |\n git show-ref --tags --verify --quiet -- \"refs/tags/${{ env.PROJECT_VERSION }}\" && echo \"tagExists=1\" >> $GITHUB_OUTPUT || echo \"tagExists=0\" >> $GITHUB_OUTPUT\n git show-ref --tags --verify --quiet -- \"refs/tags/${{ env.PROJECT_VERSION }}\" && echo \"Tag for current version exists\" || echo \"Tag for current version does not exist\"\n # If the tag could not be fetched, show a message and abort the job.\n # The wonky if logic is a workaround for: https://github.com/actions/runner/issues/1173\n - name: Abort if tag exists, or existence check fails\n if: ${{ false && steps.tagged.outputs.tagExists }}\n run: |\n echo \"Output of 'tagged' step: ${{ steps.tagged.outputs.tagExists }}\"\n echo \"Failed to check if tag exists.\"\n echo \"PROJECT_VERSION: ${{ env.PROJECT_VERSION }}\"\n echo \"Tags $(git tag | wc -l):\"\n git tag\n git show-ref --tags --verify -- \"refs/tags/${{ env.PROJECT_VERSION }}\"\n exit 1\n # Run build to generate the release artifacts.\n # Tag does not exist AND trigger was manual. Deploy release artifacts!\n - name: Build release artifacts\n run: ./gradlew publish # TODO: Publish all modules' artifacts into a single directory\n # Make release with JReleaser, only running when the project version does not exist as a tag on the repository.\n - name: Publish release\n uses: jreleaser/release-action@v2\n with:\n arguments: full-release\n env:\n JRELEASER_PROJECT_VERSION: ${{ env.PROJECT_VERSION }}\n JRELEASER_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n JRELEASER_GPG_PASSPHRASE: ${{ secrets.JRELEASER_GPG_PASSPHRASE }}\n JRELEASER_GPG_PUBLIC_KEY: ${{ secrets.JRELEASER_GPG_PUBLIC_KEY }}\n JRELEASER_GPG_SECRET_KEY: ${{ secrets.JRELEASER_GPG_SECRET_KEY }}\n JRELEASER_MAVENCENTRAL_USERNAME: ${{ secrets.JRELEASER_MAVENCENTRAL_USERNAME }}\n JRELEASER_MAVENCENTRAL_TOKEN: ${{ secrets.JRELEASER_MAVENCENTRAL_TOKEN }}\n # Upload JRelease debug log\n - name: JReleaser output\n uses: actions/upload-artifact@v4\n if: always()\n with:\n name: jreleaser-release\n path: |\n out/jreleaser/trace.log\n out/jreleaser/output.properties"
},
{
"path": ".gitignore",
"content": "# IntelliJ\nout/\n.idea/\n.idea_modules/\n*.iws\n*.iml\n\n# Eclipse\n.settings/\n.classpath\n.checkstyle\n.project\n\n# Gradle\ntarget/\nbuild/\ngenerated/\ngradle-app.setting\n.gradle\n.gradletasknamecache\n!gradle-wrapper.jar\n**/build/\n\n# Misc\nhs_err_pid*\n*.log\n*.ctxt\ntemp/\n\n# IntelliJ\nlib/"
},
{
"path": "CONTRIBUTING.md",
"content": "# Contributing to Recaf\n\nThe following is a series of guidelines for contributing to Recaf. They're not _\"rules\"_ per say, rather they're more like goals to strive towards. Regardless of how closely you adhere to the following guidelines I really appreciate you taking the time to contribute, it means a lot :+1:\n\n**Table of Contents**\n\n- [What if I am not a programmer?](#what-if-i-am-not-a-programmer)\n- [What should I know before I get started?](#what-should-i-know-before-getting-started)\n- [Is there a todo list?](#is-there-a-to-do-list)\n- [Reporting Bugs](#reporting-bugs)\n- [Suggesting Features](#suggesting-features)\n- [Coding Guidelines](#coding-guidelines)\n- [Pull Requests](#pull-requests)\n\n**TLDR?**\n\n- Follow the code style.\n- Document and comment your code.\n- Make sure the tests pass after making changes.\n- Translations and feature ideas are appreciated too.\n\n**Questions?**\n\nYou can DM `invokecoley` on discord, or join the [Recaf discord](https://discord.gg/Bya5HaA).\n\n## What if I am not a programmer?\n\n[There is plenty to contribute that isn't based in code.](https://www.youtube.com/watch?v=GAqfMNB-YBU&t=603)\n\nFor example, you can contribute ideas, add translations, or write documentation:\n\n- [Documentation source](https://github.com/Col-E/recaf-site)\n- [Documentation site](https://recaf.coley.software/)\n\n## What should I know before getting started?\n\nIt depends on what changes you are making. For instance, changing the user-interface requires very minimal or no reverse-engineering prior knowledge. If you do need JVM reversal knowledge to work on a feature you can check the [primer guide](PRIMER.md) which points to several good resources and outlines key details. For a general understanding of how Recaf works and how to begin creating contributions you can read our [getting started](https://recaf.coley.software/dev/getting-started.html) page as well.\n\n## Is there a to-do list?\n\nUnfortunately the to-do list is scattered around a few places. We're working on eventually consolidating everything into one place.\n\n## Reporting Bugs\n\nWhen creating an issue select the `Bug report` button.\nThis will provide a template that you can fill in the details for your bug.\nPlease include as much information as possible.\nThis can include:\n\n- Clear and descriptive title\n- Log files\n- Steps to reproduce the bug\n- An explanation of what you _\\*expected\\*_ to happen\n- The file being analyzed _(Do not share anything you do not own the rights to)_\n\n## Suggesting Features\n\nWhen creating an issue select the `Feature request` button.\nThis will provide a template that you can fill in the details for your feature idea.\nBe as descriptive as possible with your idea.\n\n**Note**: Not all ideas may be within Recaf's scope. In these cases the feature should be implemented as a script or plugin.\n\n## Coding Guidelines\n\n**Style**: IDE code formatting rules can be found in the [`/setup` directory](setup/).\n\n**Commits**: Try and keep commits small and focused on one thing at a time.\n\n## Pull Requests\n\nWhen creating a pull request please consider the following when filling in the template:\n\n- Clear and descriptive title\n- A clear description of what changes are included in the pull\n\nGithub's PR system will validate that your changes compile and pass the unit tests as well."
},
{
"path": "LICENSE",
"content": "The MIT License (MIT)\n\nCopyright (c) 2017-2025 Matthew Coley\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."
},
{
"path": "PRIMER.md",
"content": "# What should I know before getting started?\n\n## JVM / Class file format\n\n### General concepts\n\nA basic understanding of the JVM / class file format is _highly_ reccomended before contributing. \nHere are some articles that should bring you up to speed:\n\n- [JVM Architecture 101: Get to Know Your Virtual Machine](https://blog.overops.com/jvm-architecture-101-get-to-know-your-virtual-machine/)\n- [JVM Internals](https://blog.jamesdbloom.com/JVMInternals.html)\n- [Java Code To Byte Code](https://blog.jamesdbloom.com/JavaCodeToByteCode_PartOne.html)\n\n### Terminology\n\n**Qualified name**: Package separators using the `.` character. \nThese are names used by runtime functions like `Class.forName(name)`.\n\nFor example: \n\n- `java.lang.String`\n- `com.example.MyClass.InnerClass`\n\n**Internal name**: Package separators using the `/` character. \nInner classes specified with the `$` character. \nThese are names how classes are specified internally in the class file.\n\nFor example: \n\n- `java/lang/String`\n- `com/example/MyClass$InnerClass`\n\nPrimitives *(Not the boxed types)* use single characters:\n\n| Primitive | Internal |\n|-----------|----------|\n| `long` | `J` |\n| `int` | `I` |\n| `short` | `S` |\n| `byte` | `B` |\n| `boolean` | `Z` |\n| `float` | `F` |\n| `double` | `D` |\n| `void` | `V` |\n\n**Descriptor**: Used to describe field and method types. \nThese are essentially the same as internal names, but class names are wrapped in a prefix (`L`) and suffix character (`;`).\n\nFor example: \n\n * `Ljava/lang/String;`\n * `I` _(primitives stay the same)_\n \nMethod descriptors are formatted like so:\n \n * `double method(int i, String s)` = `(ILjava/lang/String;)D`\n * `void method()` = `()V`\n \nArrays are prefixed with a `[` for each level of the array.\n\n * `int[]` = `[I`\n * `String[][]` = `[[Ljava/lang/String;`\n \n### Quirks\n\n**Wide types**: `double` and `long` typed variables take up two slots _(On the stack and in the local variable table)_.\nFor example, declaring two doubles in a static method will use slots 0, then 2. \nSlots 0-3 are all in-use. \n\n**Lambdas**: The content of a lambda is defined in compiler-generated hidden methods and are invoked with `INVOKEDYNAMIC`. \nDecompilers will in-line the code so that it looks more similar to the source representation."
},
{
"path": "PULL_REQUEST_TEMPLATE.md",
"content": "## What's new\n\n* Summary of additions\n\n## What's fixed\n\n* Summary of bugs fixed\n"
},
{
"path": "README.md",
"content": "# Recaf [](https://discord.gg/Bya5HaA) [](https://codecov.io/gh/Col-E/Recaf)  [](CONTRIBUTING.md)\n\n\n\nAn easy to use modern Java bytecode editor that abstracts away the complexities of Java programs.\n\n## Download\n\n- [Launcher](https://github.com/Col-E/Recaf-Launcher)\n - Usage & instructions found on the launcher repo\n- [Snapshot releases](https://github.com/Col-E/Recaf-Launcher/blob/master/MANUAL.md)\n - See [CI actions](https://github.com/Col-E/Recaf/actions/workflows/build.yml) for release artifacts\n- [Independent releases](https://github.com/Col-E/Recaf/releases) _(None for 4X currently)_\n\n## Features\n\n- Edit Java bytecode with ease from a high or low level _(minus the annoying parts)_\n - Editor features within Recaf abstract away complex details of compiled Java applications like:\n - The constant pool\n - Stack frame calculation\n - Using wide instructions when needed\n - And more!\n- Easy to use navigable interface with context-sensitive actions\n- Support for standard Java _and_ Android applications\n- Multiple decompilers to switch between, with all of their parameters made fully configurable\n- Built in compiler to allow recompiling decompiled classes, even if some referenced classes are missing *(When supported, support may vary depending on code complexity and obfuscation)*\n- A bytecode assembler with a simple syntax, and supporting tooling\n - See the state of local variables and stack values at any point in methods\n - Access variables by names instead of indices for clearer disassembled code\n - Convert snippets of Java source code to bytecode sequences automatically\n- Searching for a variety of different content: Strings/numeric constants, classes and member references, instruction patterns\n- Tools for deobfuscating obfuscated code\n - Specially crafted class files with the intent of crashing reverse engineering tools are automatically patched when opened in Recaf\n - Specially crafted jar/zip files are read as the JVM does, bypassing sneaky tricks that can trick reverse engineering tools into showing the wrong data\n - Support for automatically renaming obfuscated classes and their members\n - Support for manually renaming classes and their members *_(And exporting these mappings to a variety of mapping formats for use in other tools)_*\n - Bytecode transformers for simplifying common obfuscation strategies\n- Attach to running Java process with instrumentation capabilities\n- And much more\n\nA complete list of features can be found in the [user documentation](https://recaf.coley.software/user/index.html).\n\n## Scripting & Plugins\n\nRecaf exposes almost all of its functionality through modular API's. Automating behaviors can be done easily with scripts, or with plugins for more complex situations. Additional features can also be added via plugins, which can register hooks in API's that offer them.\n\nTo create your own script or plugin, see the [developer documentation](https://recaf.coley.software/dev/index.html), specifically the _\"plugins & scripts\"_ section.\n\n## Command Line\n\nRecaf can run as a command line application, which can be especially useful when paired with scripts provided at startup. You can see all the current launch arguments by passing `--help` as an application argument.\n\n## Development Setup\n\nClone the repository via `git clone https://github.com/Col-E/Recaf.git`\n\nOpen the project in an IDE or generate the build with gradle.\n\n**IDE**:\n1. Import the project from the `build.gradle` file\n2. Create a run configuration with the main class `software.coley.recaf.Main`\n\n**Without IDE**:\n1. Run `gradlew build`\n - Output will be located at: `recaf-ui/build/libs/recaf-ui-{VERSION}-all.jar`\n"
},
{
"path": "build.gradle",
"content": "plugins {\n alias(libs.plugins.benmanes.versions) apply false\n alias(libs.plugins.coverage.report.aggregator)\n alias(libs.plugins.checker.processor) apply false\n}\n\nallprojects {\n group = 'software.coley'\n version = '4.0.0-SNAPSHOT'\n}\n\nsubprojects {\n apply plugin: 'java'\n apply plugin: 'jacoco'\n apply plugin: 'maven-publish'\n apply plugin: 'com.github.ben-manes.versions'\n\n repositories {\n mavenLocal()\n mavenCentral()\n google()\n maven {\n url = 'https://jitpack.io'\n name = 'JitPack'\n }\n }\n\n // ======================= DEPENDENCIES ========================\n dependencies {\n // Enforce jakarta annotations everywhere as the standard for Nullable/Nonnull\n implementation(libs.jakarta.annotation)\n\n // Local libraries for internal use only\n // (none of the types from these libraries should be part of a public API)\n implementation fileTree(dir: \"$rootProject.projectDir/libs\", include: ['*.jar'])\n }\n\n configurations.configureEach {\n // Annoying annotations that replace desired tab completions.\n exclude group: 'org.checkerframework'\n\n // Other annotations we don't use which are transitive deps of deps\n exclude group: 'com.google.code.findbugs'\n exclude group: 'com.google.errorprone'\n exclude group: 'com.google.j2objc'\n exclude group: 'org.jetbrains', module: 'annotations'\n\n // Used by ANTLR runtime, has a lot of IL8N related files which we don't use.\n // Removing this dependency doesn't inhibit the behavior of libraries using the\n // runtime in practice though.\n exclude group: 'com.ibm.icu'\n }\n\n // ========================== COMPILE ==========================\n\n // https://docs.gradle.org/current/userguide/toolchains.html\n // gradlew -q javaToolchains - see the list of detected toolchains.\n java {\n toolchain {\n languageVersion = JavaLanguageVersion.of(System.getenv('TARGET_VERSION') ?: '22')\n }\n }\n\n // Append options for unchecked/deprecation\n tasks.withType(JavaCompile).configureEach {\n options.compilerArgs << '-Xlint:unchecked' << '-Xlint:deprecation' << '-g' << '-parameters'\n options.encoding = 'UTF-8'\n options.incremental = true\n }\n\n // Enable automatic generation of null checks on annotated methods\n afterEvaluate { Project p ->\n p.plugins.apply('gov.tak.gradle.plugins.checker-processor')\n }\n\n // ========================== TESTING ==========================\n\n // All modules should have the same test framework setup.\n test {\n useJUnitPlatform()\n\n // Required for Mockito in newer JDK's which disable useful features by default for 'integrity' reasons.\n jvmArgs '-XX:+EnableDynamicAgentLoading'\n\n systemProperty 'junit.jupiter.execution.parallel.enabled', true\n systemProperty 'junit.jupiter.execution.parallel.mode.default', 'concurrent'\n\n testLogging {\n showStandardStreams = true\n events \"passed\", \"skipped\", \"failed\"\n }\n }\n\n // All modules with Java components should share the same test dependencies.\n plugins.withType(JavaPlugin).configureEach {\n dependencies {\n testImplementation(libs.junit.api)\n testImplementation(libs.junit.params)\n testImplementation(libs.mockito)\n testImplementation(libs.assertj)\n testRuntimeOnly(libs.junit.engine)\n testRuntimeOnly(libs.junit.launcher)\n }\n }\n\n // Need to tell any test-fixture-plugin to include dependencies\n // in its own configuration. Otherwise it can get confused.\n plugins.withType(JavaTestFixturesPlugin).configureEach {\n dependencies {\n testFixturesApi(libs.junit.api)\n testFixturesApi(libs.junit.params)\n testFixturesApi(libs.mockito)\n }\n }\n\n // Configure report outputs, and jacoco packages to target.\n tasks.withType(Test).configureEach {\n reports.html.required = false\n reports.junitXml.required = true\n\n // We want to cover all recaf classes, but not the test classes themselves (or auto-gen classes).\n // The exclusion list is applied after the inclusion list, so this ends up working out.\n jacoco {\n includes = ['software/coley/recaf/**']\n excludes = ['software/coley/recaf/**Test**', 'software/coley/recaf/test/**', '**/**WeldClientProxy']\n }\n }\n\n // Setup artifact publishing to maven local\n publishing {\n publications {\n mavenJava(MavenPublication) {\n from components.java\n }\n }\n repositories {\n mavenLocal()\n }\n }\n}\n\n// Always emit HTML & XML aggregate reports\njacocoAggregation {\n outputHtml = true\n outputXml = true\n}\n\n// Build aggregate report for test coverage when subproject 'test' tasks complete.\n// But only do so when the 'test' tasks have executed.\n// You can skip tests by specifying '-x test' in your gradle task arguments.\ntasks.register('test') {\n dependsOn(subprojects.test)\n doLast {\n if (subprojects.test.stream().anyMatch(Task::getDidWork))\n buildJacocoAggregate.execute()\n }\n}\n\ntasks.register('build') {\n // Build will run tests, unless skipped by '-x test'.\n // Even if skipped, this will still lead to the subproject build tasks being executed, such as:\n // - recaf-ui:shadowJar\n dependsOn(tasks.named('test'))\n}"
},
{
"path": "codecov.yml",
"content": "coverage:\n precision: 2\n round: down\n status:\n project:\n default:\n informational: true\n patch:\n default:\n informational: true\n\nignore:\n - \"**/src/test/\"\n - \"**/src/testFixtures\""
},
{
"path": "docs/README.md",
"content": "# Github pages directory\n\nGithub pages requires this directory be named `docs`. \nIf you were looking for documentation go here:\n\n- [User documentation](https://recaf.coley.software/user/index.html)\n- [Developer documentation](https://recaf.coley.software/dev/index.html)"
},
{
"path": "docs/index.html",
"content": "\n\n Recaf - The modern bytecode editor\n\t\n\t\n\t\n \n \n \n\n\n
\n * Searching for usages of these keys will show what listeners/classes fire in which order.\n *\n * @author Matt Coley\n */\npublic final class PriorityKeys {\n\tpublic static final int EARLIEST = -1000;\n\tpublic static final int EARLIER = -100;\n\tpublic static final int EARLY = -10;\n\tpublic static final int DEFAULT = 0;\n\tpublic static final int LATE = 10;\n\tpublic static final int LATER = 100;\n\tpublic static final int LATEST = 1000;\n\n\tprivate PriorityKeys() {}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/behavior/PrioritySortable.java",
"content": "package software.coley.recaf.behavior;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.collections.Lists;\n\nimport java.util.List;\n\n/**\n * Priority sortable item.\n *\n * @author Matt Coley\n */\npublic interface PrioritySortable extends Comparable {\n\t/**\n\t * @return This item's priority value.\n\t * Negative values have higher priority.\n\t * Positive values have lower priority.\n\t *\n\t * @see PriorityKeys\n\t */\n\tdefault int getPriority() {\n\t\t// Everything will default to '0' and the order of items is not guaranteed.\n\t\t//\n\t\t// The idea is that most things do not need a guaranteed run order, but for the few edge cases that do\n\t\t// those specific cases will use higher/lower values to be moved to the front/end of the sorted list.\n\t\treturn PriorityKeys.DEFAULT;\n\t}\n\n\t@Override\n\tdefault int compareTo(@Nonnull PrioritySortable o) {\n\t\treturn Integer.compare(getPriority(), o.getPriority());\n\t}\n\n\t/**\n\t * Add a sortable item to a sortable list.\n\t *\n\t * @param items\n\t * \t\tList to add to.\n\t * @param item\n\t * \t\tItem to add.\n\t * @param \n\t * \t\tChild priority-sortable type.\n\t *\n\t * @return {@code true} on add. {@code false} on failure (Insertion index cannot be computed),\n\t */\n\tstatic boolean add(@Nonnull List items, @Nonnull T item) {\n\t\treturn Lists.sortedInsert(PrioritySortable::compareTo, items, item);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/cdi/EagerInitialization.java",
"content": "package software.coley.recaf.cdi;\n\nimport jakarta.enterprise.context.ApplicationScoped;\nimport jakarta.enterprise.event.Observes;\n\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\n/**\n * Applied to beans to enable eager initialization, which is to say they and their dependencies get created as soon as\n * possible depending on the {@link #value() value of the intended} {@link InitializationStage}. This will result in\n * the bean's {@code @Inject} annotated constructor being called.\n *
\n * Alternatively, you could also observe the events {@link InitializationEvent} or {@link UiInitializationEvent}\n * in a method with {@link Observes}. This would allow you to separate the initialization logic from the constructor\n * and have it reside in a separate method.\n *
\n * NOTE: Beans are not eagerly initialized while in a test environment.\n *\n * @author Matt Coley\n */\n@Retention(RetentionPolicy.RUNTIME)\n@Target(ElementType.TYPE)\npublic @interface EagerInitialization {\n\t/**\n\t * Determines when to run early initialization.\n\t * \n\t * Changing this value is mostly applicable to {@link ApplicationScoped} beans.\n\t * Having the value set to {@link InitializationStage#IMMEDIATE} will result in the bean and all of\n\t * its dependencies being created as soon as the application begins. For beans dealing with UI capabilities this\n\t * will likely lead to problems. For those situations, use {@link InitializationStage#AFTER_UI_INIT} to delay\n\t * initialization until after the UI has been populated.\n\t *\n\t * @return When the initialization should occur.\n\t */\n\tInitializationStage value() default InitializationStage.IMMEDIATE;\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/cdi/EagerInitializationExtension.java",
"content": "package software.coley.recaf.cdi;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.enterprise.context.ApplicationScoped;\nimport jakarta.enterprise.event.Observes;\nimport jakarta.enterprise.inject.spi.Annotated;\nimport jakarta.enterprise.inject.spi.Bean;\nimport jakarta.enterprise.inject.spi.BeanManager;\nimport jakarta.enterprise.inject.spi.Extension;\nimport jakarta.enterprise.inject.spi.ProcessBean;\nimport jakarta.inject.Inject;\n\nimport java.util.ArrayList;\nimport java.util.List;\n\n/**\n * Extension to force creation of {@link EagerInitialization} annotated beans without the need to\n * {@link Inject} and reference them externally.\n *\n * @author Matt Coley\n */\npublic class EagerInitializationExtension implements Extension {\n\tprivate static final EagerInitializationExtension INSTANCE = new EagerInitializationExtension();\n\tprivate static final List> applicationScopedEagerBeans = new ArrayList<>();\n\tprivate static final List> applicationScopedEagerBeansForUi = new ArrayList<>();\n\tprivate static BeanManager beanManager;\n\n\tprivate EagerInitializationExtension() {\n\t}\n\n\t/**\n\t * @return Extension singleton.\n\t */\n\t@Nonnull\n\tpublic static EagerInitializationExtension getInstance() {\n\t\treturn INSTANCE;\n\t}\n\n\t/**\n\t * @return Application scoped {@link EagerInitialization} beans.\n\t */\n\t@Nonnull\n\tpublic static List> getApplicationScopedEagerBeans() {\n\t\treturn applicationScopedEagerBeans;\n\t}\n\n\t/**\n\t * @return Application scoped {@link EagerInitialization} beans which will wait for the UI to be initialized before being initialized.\n\t */\n\t@Nonnull\n\tpublic static List> getApplicationScopedEagerBeansForUi() {\n\t\treturn applicationScopedEagerBeansForUi;\n\t}\n\n\t/**\n\t * Called when a bean is discovered and processed.\n\t * We will record eager beans here so that we can initialize them later.\n\t *\n\t * @param event\n\t * \t\tCDI bean process event.\n\t */\n\tpublic void onProcessBean(@Observes ProcessBean event) {\n\t\tAnnotated annotated = event.getAnnotated();\n\t\tEagerInitialization eager = annotated.getAnnotation(EagerInitialization.class);\n\t\tif (eager != null && annotated.isAnnotationPresent(ApplicationScoped.class)) {\n\t\t\tif (eager.value() == InitializationStage.IMMEDIATE)\n\t\t\t\tapplicationScopedEagerBeans.add(event.getBean());\n\t\t\telse if (eager.value() == InitializationStage.AFTER_UI_INIT)\n\t\t\t\tapplicationScopedEagerBeansForUi.add(event.getBean());\n\t\t}\n\t}\n\n\t/**\n\t * Called when Recaf initializes the CDI container, and after plugins are loaded.\n\t *\n\t * @param event\n\t * \t\tRecaf initialization event.\n\t * @param beanManager\n\t * \t\tCDI bean manager.\n\t */\n\tpublic void onInitialize(@Observes InitializationEvent event, @Nonnull BeanManager beanManager) {\n\t\tEagerInitializationExtension.beanManager = beanManager;\n\t\tfor (Bean bean : applicationScopedEagerBeans)\n\t\t\tcreate(bean);\n\t}\n\n\t/**\n\t * Called when the UI is populated.\n\t * This obviously means that this only gets called when running from the UI module.\n\t *\n\t * @param event\n\t * \t\tUI initialization event.\n\t * @param beanManager\n\t * \t\tCDI bean manager.\n\t */\n\tpublic void onUiInitialize(@Observes UiInitializationEvent event, @Nonnull BeanManager beanManager) {\n\t\tEagerInitializationExtension.beanManager = beanManager;\n\t\tfor (Bean bean : applicationScopedEagerBeansForUi)\n\t\t\tcreate(bean);\n\t}\n\n\tstatic void create(@Nonnull Bean bean) {\n\t\t// NOTE: Calling toString() triggers the bean's proxy to the real implementation to initialize it.\n\t\t// We have a null check here because under some test environments this may trigger without being set (see above)\n\t\tif (beanManager != null)\n\t\t\tbeanManager.getReference(bean, bean.getBeanClass(), beanManager.createCreationalContext(bean)).toString();\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/cdi/InitializationEvent.java",
"content": "package software.coley.recaf.cdi;\n\n/**\n * Empty type, used to notify CDI consumers observing this type that the application has been launched.\n *\n * @author Matt Coley\n * @see UiInitializationEvent Alternative which waits for the UI to initialize.\n */\npublic class InitializationEvent {\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/cdi/InitializationStage.java",
"content": "package software.coley.recaf.cdi;\n\n/**\n * Initialization stage for {@link EagerInitialization#value()}.\n *\n * @author Matt Coley\n * @see EagerInitialization\n */\npublic enum InitializationStage {\n\t/**\n\t * Occurs as soon as possible.\n\t */\n\tIMMEDIATE,\n\t/**\n\t * Occurs after the UI is initialized.\n\t */\n\tAFTER_UI_INIT\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/cdi/UiInitializationEvent.java",
"content": "package software.coley.recaf.cdi;\n\n/**\n * Empty type, used to notify CDI consumers observing this type that the UI has been populated.\n *\n * @author Matt Coley\n * @see InitializationEvent Alternative which runs before the UI is initialized.\n */\npublic class UiInitializationEvent {\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/BasicCollectionConfigValue.java",
"content": "package software.coley.recaf.config;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.observables.ObservableCollection;\n\nimport java.util.Collection;\n\n/**\n * Basic implementation of {@link ConfigCollectionValue}.\n *\n * @param \n * \t\tValue type.\n * @param \n * \t\tCollection type.\n *\n * @author Matt Coley\n */\npublic class BasicCollectionConfigValue> implements ConfigCollectionValue {\n\tprivate final String key;\n\tprivate final Class collectionType;\n\tprivate final Class itemType;\n\tprivate final ObservableCollection observable;\n\tprivate final boolean hidden;\n\n\t/**\n\t * @param key\n\t * \t\tValue key.\n\t * @param type\n\t * \t\tValue type class.\n\t * @param observable\n\t * \t\tObservable of value.\n\t */\n\t@SuppressWarnings(\"rawtypes\")\n\tpublic BasicCollectionConfigValue(@Nonnull String key,\n\t @Nonnull Class type,\n\t @Nonnull Class itemType,\n\t @Nonnull ObservableCollection observable) {\n\t\tthis(key, type, itemType, observable, false);\n\t}\n\n\t/**\n\t * @param key\n\t * \t\tValue key.\n\t * @param type\n\t * \t\tValue type class.\n\t * @param observable\n\t * \t\tObservable of value.\n\t * @param hidden\n\t * \t\tHidden flag.\n\t */\n\t@SuppressWarnings({\"rawtypes\", \"unchecked\"})\n\tpublic BasicCollectionConfigValue(@Nonnull String key,\n\t @Nonnull Class type,\n\t @Nonnull Class itemType,\n\t @Nonnull ObservableCollection observable,\n\t boolean hidden) {\n\t\tthis.key = key;\n\t\tthis.collectionType = (Class) type;\n\t\tthis.itemType = itemType;\n\t\tthis.observable = observable;\n\t\tthis.hidden = hidden;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getId() {\n\t\treturn key;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Class getType() {\n\t\treturn collectionType;\n\t}\n\n\t@Override\n\tpublic Class getItemType() {\n\t\treturn itemType;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic ObservableCollection getObservable() {\n\t\treturn observable;\n\t}\n\n\t@Override\n\tpublic boolean isHidden() {\n\t\treturn hidden;\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null || getClass() != o.getClass()) return false;\n\n\t\tBasicCollectionConfigValue other = (BasicCollectionConfigValue) o;\n\n\t\tif (!key.equals(other.key)) return false;\n\t\tif (!collectionType.equals(other.collectionType)) return false;\n\t\tif (!itemType.equals(other.itemType)) return false;\n\t\treturn observable.equals(other.observable);\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = key.hashCode();\n\t\tresult = 31 * result + collectionType.hashCode();\n\t\tresult = 31 * result + itemType.hashCode();\n\t\tresult = 31 * result + observable.hashCode();\n\t\treturn result;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn \"BasicCollectionConfigValue{\" +\n\t\t\t\t\"key='\" + key + '\\'' +\n\t\t\t\t\", collectionType=\" + collectionType +\n\t\t\t\t\", itemType=\" + itemType +\n\t\t\t\t'}';\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/BasicConfigContainer.java",
"content": "package software.coley.recaf.config;\n\nimport jakarta.annotation.Nonnull;\n\nimport java.util.Map;\nimport java.util.TreeMap;\n\n/**\n * Basic implementation of {@link ConfigContainer}\n *\n * @author Matt Coley\n */\npublic class BasicConfigContainer implements ConfigContainer {\n\tprivate final Map> configMap = new TreeMap<>();\n\tprivate final String group;\n\tprivate final String id;\n\n\t/**\n\t * @param group\n\t * \t\tContainer group.\n\t * @param id\n\t * \t\tContainer ID.\n\t */\n\tpublic BasicConfigContainer(@Nonnull String group, @Nonnull String id) {\n\t\tthis.group = group;\n\t\tthis.id = id;\n\t}\n\n\t/**\n\t * @param value\n\t * \t\tValue to add.\n\t */\n\tprotected void addValue(@Nonnull ConfigValue value) {\n\t\tconfigMap.put(value.getId(), value);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getGroup() {\n\t\treturn group;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getId() {\n\t\treturn id;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Map> getValues() {\n\t\treturn configMap;\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null || getClass() != o.getClass()) return false;\n\n\t\tBasicConfigContainer that = (BasicConfigContainer) o;\n\n\t\tif (!configMap.equals(that.configMap)) return false;\n\t\treturn id.equals(that.id);\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = configMap.hashCode();\n\t\tresult = 31 * result + id.hashCode();\n\t\treturn result;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/BasicConfigValue.java",
"content": "package software.coley.recaf.config;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.observables.Observable;\n\n/**\n * Basic implementation of {@link ConfigValue}.\n *\n * @param \n * \t\tValue type.\n *\n * @author Matt Coley\n */\npublic class BasicConfigValue implements ConfigValue {\n\tprivate final String key;\n\tprivate final Class type;\n\tprivate final Observable observable;\n\tprivate final boolean hidden;\n\n\t/**\n\t * @param key\n\t * \t\tValue key.\n\t * @param type\n\t * \t\tValue type class.\n\t * @param observable\n\t * \t\tObservable of value.\n\t */\n\tpublic BasicConfigValue(String key, Class type, Observable observable) {\n\t\tthis(key, type, observable, false);\n\t}\n\n\t/**\n\t * @param key\n\t * \t\tValue key.\n\t * @param type\n\t * \t\tValue type class.\n\t * @param observable\n\t * \t\tObservable of value.\n\t * @param hidden\n\t * \t\tHidden flag.\n\t */\n\tpublic BasicConfigValue(String key, Class type, Observable observable, boolean hidden) {\n\t\tthis.key = key;\n\t\tthis.type = type;\n\t\tthis.observable = observable;\n\t\tthis.hidden = hidden;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getId() {\n\t\treturn key;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Class getType() {\n\t\treturn type;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Observable getObservable() {\n\t\treturn observable;\n\t}\n\n\t@Override\n\tpublic boolean isHidden() {\n\t\treturn hidden;\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null || getClass() != o.getClass()) return false;\n\n\t\tBasicConfigValue other = (BasicConfigValue) o;\n\n\t\tif (!key.equals(other.key)) return false;\n\t\treturn type.equals(other.type);\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = key.hashCode();\n\t\tresult = 31 * result + type.hashCode();\n\t\treturn result;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn \"BasicConfigValue{\" +\n\t\t\t\t\"key='\" + key + '\\'' +\n\t\t\t\t\", type=\" + type +\n\t\t\t\t'}';\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/BasicMapConfigValue.java",
"content": "package software.coley.recaf.config;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.observables.ObservableMap;\n\nimport java.util.Map;\n\n/**\n * Basic implementation of {@link ConfigMapValue}.\n *\n * @param \n * \t\tMap key type.\n * @param \n * \t\tMap value type.\n * @param \n * \t\tMap type.\n *\n * @author Matt Coley\n */\npublic class BasicMapConfigValue> implements ConfigMapValue {\n\tprivate final String key;\n\tprivate final Class keyType;\n\tprivate final Class valueType;\n\tprivate final Class mapType;\n\tprivate final ObservableMap observable;\n\tprivate final boolean hidden;\n\n\t/**\n\t * @param key\n\t * \t\tValue key.\n\t * @param type\n\t * \t\tValue type class.\n\t * @param observable\n\t * \t\tObservable of value.\n\t */\n\t@SuppressWarnings(\"rawtypes\")\n\tpublic BasicMapConfigValue(String key,\n\t Class type,\n\t Class keyType,\n\t Class valueType,\n\t ObservableMap observable) {\n\t\tthis(key, type, keyType, valueType, observable, false);\n\t}\n\n\t/**\n\t * @param key\n\t * \t\tValue key.\n\t * @param type\n\t * \t\tValue type class.\n\t * @param observable\n\t * \t\tObservable of value.\n\t * @param hidden\n\t * \t\tHidden flag.\n\t */\n\t@SuppressWarnings({\"rawtypes\", \"unchecked\"})\n\tpublic BasicMapConfigValue(String key,\n\t Class type,\n\t Class keyType,\n\t Class valueType,\n\t ObservableMap observable,\n\t boolean hidden) {\n\t\tthis.key = key;\n\t\tthis.mapType = (Class) type;\n\t\tthis.keyType = keyType;\n\t\tthis.valueType = valueType;\n\t\tthis.observable = observable;\n\t\tthis.hidden = hidden;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getId() {\n\t\treturn key;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Class getType() {\n\t\treturn mapType;\n\t}\n\n\t@Override\n\tpublic Class getKeyType() {\n\t\treturn keyType;\n\t}\n\n\t@Override\n\tpublic Class getValueType() {\n\t\treturn valueType;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic ObservableMap getObservable() {\n\t\treturn observable;\n\t}\n\n\t@Override\n\tpublic boolean isHidden() {\n\t\treturn hidden;\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null || getClass() != o.getClass()) return false;\n\n\t\tBasicMapConfigValue that = (BasicMapConfigValue) o;\n\n\t\tif (hidden != that.hidden) return false;\n\t\tif (!key.equals(that.key)) return false;\n\t\tif (!keyType.equals(that.keyType)) return false;\n\t\tif (!valueType.equals(that.valueType)) return false;\n\t\tif (!mapType.equals(that.mapType)) return false;\n\t\treturn observable.equals(that.observable);\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = key.hashCode();\n\t\tresult = 31 * result + keyType.hashCode();\n\t\tresult = 31 * result + valueType.hashCode();\n\t\tresult = 31 * result + mapType.hashCode();\n\t\tresult = 31 * result + observable.hashCode();\n\t\tresult = 31 * result + (hidden ? 1 : 0);\n\t\treturn result;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn \"BasicMapConfigValue{\" +\n\t\t\t\t\"key='\" + key + '\\'' +\n\t\t\t\t\", keyType=\" + keyType +\n\t\t\t\t\", valueType=\" + valueType +\n\t\t\t\t\", mapType=\" + mapType +\n\t\t\t\t\", observable=\" + observable +\n\t\t\t\t\", hidden=\" + hidden +\n\t\t\t\t'}';\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/ConfigCollectionValue.java",
"content": "package software.coley.recaf.config;\n\nimport java.util.Collection;\n\n/**\n * An option stored in a {@link ConfigContainer} object representing a collection.\n *\n * @param \n * \t\tCollection value type.\n * @param \n * \t\tCollection type.\n *\n * @author Matt Coley\n */\npublic interface ConfigCollectionValue> extends ConfigValue {\n\t/**\n\t * @return Collection type.\n\t */\n\tClass getItemType();\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/ConfigContainer.java",
"content": "package software.coley.recaf.config;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.enterprise.context.ApplicationScoped;\n\nimport java.util.Map;\n\nimport static software.coley.recaf.config.ConfigGroups.PACKAGE_SPLIT;\n\n/**\n * Configurable object. Implementations will almost always want to use {@link ApplicationScoped} for their scope.\n * This is so that the config container is shared between all instances of the item it is a config for.\n *\n * @author Matt Coley.\n * @see ConfigValue Values within this container.\n * @see ConfigGroups Values for {@link #getGroup()}.\n */\npublic interface ConfigContainer {\n\tString CONFIG_SUFFIX = \"-config\";\n\n\t/**\n\t * @return Group ID the container belongs to.\n\t *\n\t * @see ConfigGroups For constant values.\n\t */\n\t@Nonnull\n\tString getGroup();\n\n\t/**\n\t * The unique ID of this container should be globally unique.\n\t * The {@link #getGroup() group} does not act as an identifier prefix.\n\t *\n\t * @return Unique ID of this container.\n\t */\n\t@Nonnull\n\tString getId();\n\n\t/**\n\t * @return Combined {@link #getGroup()} and {@link #getId()}.\n\t */\n\t@Nonnull\n\tdefault String getGroupAndId() {\n\t\treturn getGroup() + PACKAGE_SPLIT + getId();\n\t}\n\n\t/**\n\t * @return Values in the container.\n\t */\n\t@Nonnull\n\tMap> getValues();\n\n\t/**\n\t * @param value\n\t * \t\tValue to get path of.\n\t *\n\t * @return Full path, scoped to this container.\n\t */\n\t@Nonnull\n\tdefault String getScopedId(ConfigValue value) {\n\t\treturn getGroupAndId() + PACKAGE_SPLIT + value.getId();\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/ConfigGroups.java",
"content": "package software.coley.recaf.config;\n\nimport software.coley.recaf.services.Service;\n\n/**\n * Constants for {@link ConfigContainer#getGroup()}.\n *\n * @author Matt Coley\n */\npublic final class ConfigGroups {\n\t/**\n\t * Used to split group into sections.\n\t */\n\tpublic static final String PACKAGE_SPLIT = \".\";\n\t/**\n\t * Group base for {@link Service} classes.\n\t */\n\tpublic static final String SERVICE = \"service\";\n\t/**\n\t * Group for analyzing components.\n\t */\n\tpublic static final String SERVICE_ANALYSIS = SERVICE + PACKAGE_SPLIT + \"analysis\";\n\t/**\n\t * Group for assembler components.\n\t */\n\tpublic static final String SERVICE_ASSEMBLER = SERVICE + PACKAGE_SPLIT + \"assembler\";\n\t/**\n\t * Group for compiler components.\n\t */\n\tpublic static final String SERVICE_COMPILE = SERVICE + PACKAGE_SPLIT + \"compile\";\n\t/**\n\t * Group for debug/attach components.\n\t */\n\tpublic static final String SERVICE_DEBUG = SERVICE + PACKAGE_SPLIT + \"debug\";\n\t/**\n\t * Group for decompilation components.\n\t */\n\tpublic static final String SERVICE_DECOMPILE = SERVICE + PACKAGE_SPLIT + \"decompile\";\n\t/**\n\t * Group for specific decompiler components.\n\t */\n\tpublic static final String SERVICE_DECOMPILE_IMPL = SERVICE_DECOMPILE + PACKAGE_SPLIT + \"impl\";\n\t/**\n\t * Group for IO components.\n\t */\n\tpublic static final String SERVICE_IO = SERVICE + PACKAGE_SPLIT + \"io\";\n\t/**\n\t * Group for mapping components.\n\t */\n\tpublic static final String SERVICE_MAPPING = SERVICE + PACKAGE_SPLIT + \"mapping\";\n\t/**\n\t * Group for plugin components.\n\t */\n\tpublic static final String SERVICE_PLUGIN = SERVICE + PACKAGE_SPLIT + \"plugin\";\n\t/**\n\t * Group for transformation components.\n\t */\n\tpublic static final String SERVICE_TRANSFORM = SERVICE + PACKAGE_SPLIT + \"transform\";\n\t/**\n\t * Group base for UI classes.\n\t */\n\tpublic static final String SERVICE_UI = SERVICE + PACKAGE_SPLIT + \"ui\";\n\t/**\n\t * Group for 3rd party.\n\t * \n\t * Plugin registering new {@link ConfigContainer} instances should use this as the {@link ConfigContainer#getGroup()}.\n\t * This group is given special treatment in the UI.\n\t */\n\tpublic static final String EXTERNAL = \"external\";\n\n\tprivate ConfigGroups() {\n\t}\n\n\t/**\n\t * @param container\n\t * \t\tContainer to get packages from.\n\t *\n\t * @return Group packages.\n\t */\n\tpublic static String[] getGroupPackages(ConfigContainer container) {\n\t\treturn container.getGroup().split('\\\\' + PACKAGE_SPLIT);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/ConfigMapValue.java",
"content": "package software.coley.recaf.config;\n\nimport java.util.Map;\n\n/**\n * An option stored in a {@link ConfigContainer} object representing a map.\n *\n * @param \n * \t\tMap key type.\n * @param \n * \t\tMap value type.\n * @param \n * \t\tMap type.\n *\n * @author Matt Coley\n */\npublic interface ConfigMapValue> extends ConfigValue {\n\t/**\n\t * @return Map key type.\n\t */\n\tClass getKeyType();\n\n\t/**\n\t * @return Map value type.\n\t */\n\tClass getValueType();\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/ConfigPersistence.java",
"content": "package software.coley.recaf.config;\n\nimport jakarta.annotation.Nonnull;\n\n/**\n * Outline of persistence for {@link ConfigContainer}\n *\n * @author Matt Coley\n */\npublic interface ConfigPersistence {\n\t/**\n\t * @param container\n\t * \t\tContainer with values to save to persistent medium.\n\t */\n\tvoid save(@Nonnull ConfigContainer container);\n\n\t/**\n\t * @param container\n\t * \t\tContainer with values to load from persistent medium.\n\t */\n\tvoid load(@Nonnull ConfigContainer container);\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/ConfigValue.java",
"content": "package software.coley.recaf.config;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.observables.Observable;\n\n/**\n * An option stored in a {@link ConfigContainer} object.\n *\n * @param \n * \t\tValue type.\n *\n * @author Matt Coley\n */\npublic interface ConfigValue {\n\t/**\n\t * @return Unique ID of this value.\n\t */\n\t@Nonnull\n\tString getId();\n\n\t/**\n\t * @return Value type class.\n\t */\n\t@Nonnull\n\tClass getType();\n\n\t/**\n\t * @return Observable of value.\n\t */\n\t@Nonnull\n\tObservable getObservable();\n\n\t/**\n\t * @param value\n\t * \t\tValue to set.\n\t */\n\tdefault void setValue(@Nonnull T value) {\n\t\tgetObservable().setValue(value);\n\t}\n\n\t/**\n\t * @return Current value.\n\t */\n\t@Nonnull\n\tdefault T getValue() {\n\t\treturn getObservable().getValue();\n\t}\n\n\t/**\n\t * @return {@code true} for hidden values not to be shown to users (Strictly in the UI).\n\t */\n\tdefault boolean isHidden() {\n\t\treturn false;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/config/RestoreAwareConfigContainer.java",
"content": "package software.coley.recaf.config;\n\nimport software.coley.recaf.services.config.ConfigManager;\n\n/**\n * Outline of a config container that is aware of when its contents are restored.\n *\n * @author Matt Coley\n */\npublic interface RestoreAwareConfigContainer extends ConfigContainer {\n\t/**\n\t * Called when this container has its contents restored via {@link ConfigManager}.\n\t */\n\tdefault void onRestore() {}\n\n\t/**\n\t * Called when this container was checked for contents via {@link ConfigManager} for restoration,\n\t * but no local files were found and thus there was nothing to restore.\n\t */\n\tdefault void onNoRestore() {}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/Accessed.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.member.ClassMember;\n\nimport static java.lang.reflect.Modifier.*;\n\n/**\n * Outline of a class or member with access modifiers.\n *\n * @author Matt Coley\n * @see ClassMember\n * @see ClassInfo\n */\npublic interface Accessed {\n\t/**\n\t * @return Access modifiers.\n\t */\n\tint getAccess();\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code public}.\n\t */\n\tdefault boolean hasPublicModifier() {\n\t\treturn hasModifierMask(PUBLIC);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code protected}.\n\t */\n\tdefault boolean hasProtectedModifier() {\n\t\treturn hasModifierMask(PROTECTED);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code private}.\n\t */\n\tdefault boolean hasPrivateModifier() {\n\t\treturn hasModifierMask(PRIVATE);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains none of:\n\t * {@code public}, {@code protected}, or {@code private}.\n\t */\n\tdefault boolean hasPackagePrivateModifier() {\n\t\treturn hasNoneOfMask(PRIVATE | PROTECTED | PUBLIC);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code static}.\n\t */\n\tdefault boolean hasStaticModifier() {\n\t\treturn hasModifierMask(STATIC);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code final}.\n\t */\n\tdefault boolean hasFinalModifier() {\n\t\treturn hasModifierMask(FINAL);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code synchronized}.\n\t */\n\tdefault boolean hasSynchronizedModifier() {\n\t\treturn hasModifierMask(SYNCHRONIZED);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code volatile}.\n\t */\n\tdefault boolean hasVolatileModifier() {\n\t\treturn hasModifierMask(VOLATILE);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code transient}.\n\t */\n\tdefault boolean hasTransientModifier() {\n\t\treturn hasModifierMask(TRANSIENT);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code native}.\n\t */\n\tdefault boolean hasNativeModifier() {\n\t\treturn hasModifierMask(NATIVE);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code enum}.\n\t */\n\tdefault boolean hasEnumModifier() {\n\t\treturn hasModifierMask(0x00004000);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code annotation}.\n\t */\n\tdefault boolean hasAnnotationModifier() {\n\t\treturn hasModifierMask(0x00002000);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code interface}.\n\t */\n\tdefault boolean hasInterfaceModifier() {\n\t\treturn hasModifierMask(INTERFACE);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code module}.\n\t */\n\tdefault boolean hasModuleModifier() {\n\t\treturn hasModifierMask(0x8000);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code abstract}.\n\t */\n\tdefault boolean hasAbstractModifier() {\n\t\treturn hasModifierMask(ABSTRACT);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code strictfp}.\n\t */\n\tdefault boolean hasStrictFpModifier() {\n\t\treturn hasModifierMask(STRICT);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code varargs}.\n\t */\n\tdefault boolean hasVarargsModifier() {\n\t\treturn hasModifierMask(0x00000080);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code bridge}.\n\t */\n\tdefault boolean hasBridgeModifier() {\n\t\treturn hasModifierMask(0x00000040);\n\t}\n\n\t/**\n\t * @return {@code true} when this item's access modifiers contains {@code synthetic}.\n\t */\n\tdefault boolean hasSyntheticModifier() {\n\t\treturn hasModifierMask(0x00001000);\n\t}\n\n\t/**\n\t * @return {@code true} when {@link #hasSyntheticModifier()} or {@link #hasBridgeModifier()} are {@code true}.\n\t */\n\tdefault boolean isCompilerGenerated() {\n\t\treturn hasBridgeModifier() || hasSyntheticModifier();\n\t}\n\n\t/**\n\t * @param mask\n\t * \t\tMask to check.\n\t *\n\t * @return {@code true} if the access modifiers of this item match the given mask.\n\t */\n\tdefault boolean hasModifierMask(int mask) {\n\t\treturn (getAccess() & mask) == mask;\n\t}\n\n\t/**\n\t * @param modifiers\n\t * \t\tModifiers to check.\n\t *\n\t * @return {@code true} if the access modifiers of this item contain all the given modifiers.\n\t */\n\tdefault boolean hasAllModifiers(int... modifiers) {\n\t\tfor (int modifier : modifiers)\n\t\t\tif (!hasModifierMask(modifier))\n\t\t\t\treturn false;\n\t\treturn true;\n\t}\n\n\t/**\n\t * @param modifiers\n\t * \t\tModifiers to check.\n\t *\n\t * @return {@code true} if the access modifiers of this item contain any the given modifiers.\n\t */\n\tdefault boolean hasAnyModifiers(int... modifiers) {\n\t\tfor (int modifier : modifiers)\n\t\t\tif (hasModifierMask(modifier))\n\t\t\t\treturn true;\n\t\treturn false;\n\t}\n\n\t/**\n\t * @param mask\n\t * \t\tMask to check.\n\t *\n\t * @return {@code true} if the access modifiers of this item do not match the mask.\n\t */\n\tdefault boolean hasNoneOfMask(int mask) {\n\t\treturn (getAccess() & mask) == 0;\n\t}\n\n\t/**\n\t * @param modifiers\n\t * \t\tModifiers to check.\n\t *\n\t * @return {@code true} if the access modifiers of this item contain none the given modifiers.\n\t */\n\tdefault boolean hasNoneOfModifiers(int... modifiers) {\n\t\tfor (int modifier : modifiers)\n\t\t\tif (!hasNoneOfMask(modifier))\n\t\t\t\treturn false;\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/AndroidChunkFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport com.google.devrel.gmscore.tools.apk.arsc.BinaryResourceFile;\nimport jakarta.annotation.Nonnull;\n\n/**\n * Outline of files that utilize the Android chunk format.\n *\n * @author Matt Coley\n * @see BinaryXmlFileInfo For {@code AndroidManifest.xml} contents.\n * @see ArscFileInfo For {@code resources.arsc} contents.\n */\npublic interface AndroidChunkFileInfo extends FileInfo {\n\t/**\n\t * @return Model representation of the chunk file.\n\t */\n\t@Nonnull\n\tBinaryResourceFile getChunkModel();\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/AndroidClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.builder.AndroidClassInfoBuilder;\n\nimport java.util.function.Consumer;\nimport java.util.function.Predicate;\n\n/**\n * Outline of an Android class.\n *\n * @author Matt Coley\n */\npublic interface AndroidClassInfo extends ClassInfo {\n\t/**\n\t * @return {@code true} when {@link #asJvmClass()} can act as a mapping operation.\n\t * {@code false} when mapping to JVM classes is unsupported.\n\t */\n\tdefault boolean canMapToJvmClass() {\n\t\treturn false;\n\t}\n\n\t/**\n\t * @return New builder wrapping this class information.\n\t */\n\t@Nonnull\n\tdefault AndroidClassInfoBuilder toAndroidBuilder() {\n\t\treturn new AndroidClassInfoBuilder(this);\n\t}\n\n\t@Override\n\tdefault void acceptIfJvmClass(@Nonnull Consumer action) {\n\t\t// no-op\n\t}\n\n\t@Override\n\tdefault void acceptIfAndroidClass(@Nonnull Consumer action) {\n\t\taction.accept(this);\n\t}\n\n\t@Override\n\tdefault boolean testIfJvmClass(@Nonnull Predicate predicate) {\n\t\treturn false;\n\t}\n\n\t@Override\n\tdefault boolean testIfAndroidClass(@Nonnull Predicate predicate) {\n\t\treturn predicate.test(this);\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault JvmClassInfo asJvmClass() {\n\t\tthrow new IllegalStateException(\"Android class cannot be cast to JVM class\");\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault AndroidClassInfo asAndroidClass() {\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault boolean isJvmClass() {\n\t\treturn false;\n\t}\n\n\t@Override\n\tdefault boolean isAndroidClass() {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/ApkFileInfo.java",
"content": "package software.coley.recaf.info;\n\n/**\n * Outline of an APK Android file container.\n *\n * @author Matt Coley\n */\npublic interface ApkFileInfo extends ZipFileInfo {\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/ArscFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.android.xml.AndroidResourceProvider;\n\n/**\n * Outline of a ARSC file, used by Android APK's.\n *\n * @author Matt Coley\n */\npublic interface ArscFileInfo extends AndroidChunkFileInfo {\n\t/**\n\t * Standard name of ARSC resource file in APK files.\n\t */\n\tString NAME = \"resources.arsc\";\n\n\t/**\n\t * @return Resource information extracted from the ARSC file contents.\n\t */\n\t@Nonnull\n\tAndroidResourceProvider getResourceInfo();\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/AudioFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\n\n/**\n * Outline of an audio file.\n *\n * @author Matt Coley\n */\npublic interface AudioFileInfo extends FileInfo {\n\t@Nonnull\n\t@Override\n\tdefault AudioFileInfo asAudioFile() {\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault boolean isAudioFile() {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicAndroidChunkFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport com.google.devrel.gmscore.tools.apk.arsc.BinaryResourceFile;\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.builder.ChunkFileInfoBuilder;\n\n/**\n * Common implementation for {@link BasicBinaryXmlFileInfo} and {@link BasicArscFileInfo}.\n *\n * @author Matt Coley\n */\npublic class BasicAndroidChunkFileInfo extends BasicFileInfo implements AndroidChunkFileInfo {\n\tprivate BinaryResourceFile resourceFile;\n\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicAndroidChunkFileInfo(ChunkFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic BinaryResourceFile getChunkModel() {\n\t\tif (resourceFile == null)\n\t\t\tresourceFile = new BinaryResourceFile(getRawContent());\n\t\treturn resourceFile;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicAndroidClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport com.android.tools.r8.graph.DexProgramClass;\nimport jakarta.annotation.Nonnull;\nimport org.objectweb.asm.ClassReader;\nimport software.coley.dextranslator.Options;\nimport software.coley.dextranslator.ir.ConversionException;\nimport software.coley.dextranslator.model.ApplicationData;\nimport software.coley.recaf.info.builder.AndroidClassInfoBuilder;\nimport software.coley.recaf.info.builder.JvmClassInfoBuilder;\n\nimport java.io.IOException;\nimport java.util.Collections;\n\n/**\n * Basic Android class info implementation.\n *\n * @author Matt Coley\n */\npublic class BasicAndroidClassInfo extends BasicClassInfo implements AndroidClassInfo {\n\tprivate final DexProgramClass dexClass;\n\tprivate JvmClassInfo converted;\n\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull info from.\n\t */\n\tpublic BasicAndroidClassInfo(@Nonnull AndroidClassInfoBuilder builder) {\n\t\tsuper(builder);\n\t\tdexClass = builder.getDexClass();\n\t}\n\n\t@Override\n\tpublic boolean canMapToJvmClass() {\n\t\t// See below\n\t\treturn true;\n\t}\n\n\t/**\n\t * @return Translation into JVM class.\n\t */\n\t@Nonnull\n\t@Override\n\tpublic JvmClassInfo asJvmClass() {\n\t\tif (converted == null) {\n\t\t\t// This is an expensive operation, so it's best to make other thread access wait until it is done and\n\t\t\t// then use the singular return value.\n\t\t\tsynchronized (this) {\n\t\t\t\t// If there are 2+ requests here, and we let one through to completion, when the others are let in\n\t\t\t\t// this value should be computed then.\n\t\t\t\tif (converted != null)\n\t\t\t\t\treturn converted;\n\t\t\t\ttry {\n\t\t\t\t\tString name = getName();\n\t\t\t\t\tApplicationData data = ApplicationData.fromProgramClasses(Collections.singleton(dexClass));\n\t\t\t\t\tdata.setOperationOptionsProvider(() -> new Options()\n\t\t\t\t\t\t\t.enableLoadStoreOptimization()\n\t\t\t\t\t\t\t.setLenient(true)\n\t\t\t\t\t\t\t.setReplaceInvalidMethodBodies(true));\n\t\t\t\t\tbyte[] convertedBytecode = data.exportToJvmClass(name);\n\t\t\t\t\tif (convertedBytecode == null)\n\t\t\t\t\t\tthrow new IllegalStateException(\"Failed to convert Dalvik model of \" + name + \" to JVM bytecode, \" +\n\t\t\t\t\t\t\t\t\"conversion results did not include type name.\");\n\t\t\t\t\tClassReader reader = new ClassReader(convertedBytecode);\n\t\t\t\t\tconverted = new JvmClassInfoBuilder(reader).build();\n\t\t\t\t} catch (ConversionException | IOException ex) {\n\t\t\t\t\tthrow new IllegalStateException(ex);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn converted;\n\t}\n\n\t/**\n\t * @return Backing program class node.\n\t */\n\t@Nonnull\n\tpublic DexProgramClass getDexClass() {\n\t\treturn dexClass;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn \"Android class: \" + getName();\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicApkFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.ZipFileInfoBuilder;\n\n/**\n * Basic implementation of an Android APK file info.\n *\n * @author Matt Coley\n */\npublic class BasicApkFileInfo extends BasicZipFileInfo implements ApkFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicApkFileInfo(ZipFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicArscFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport org.slf4j.Logger;\nimport software.coley.android.xml.AndroidResourceProvider;\nimport software.coley.android.xml.NoopAndroidResourceProvider;\nimport software.coley.recaf.analytics.logging.Logging;\nimport software.coley.recaf.info.builder.ArscFileInfoBuilder;\nimport software.coley.recaf.util.android.AndroidRes;\n\n/**\n * Basic implementation of ARSC file info.\n *\n * @author Matt Coley\n */\npublic class BasicArscFileInfo extends BasicAndroidChunkFileInfo implements ArscFileInfo {\n\tprivate static final Logger logger = Logging.get(BasicArscFileInfo.class);\n\tprivate AndroidResourceProvider res;\n\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicArscFileInfo(ArscFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic AndroidResourceProvider getResourceInfo() {\n\t\tif (res == null)\n\t\t\ttry {\n\t\t\t\tres = AndroidRes.fromArsc(getChunkModel());\n\t\t\t} catch (Throwable t) {\n\t\t\t\tlogger.error(\"Failed to decode '{}', will use an empty model instead\", getName(), t);\n\t\t\t\tres = NoopAndroidResourceProvider.INSTANCE;\n\t\t\t}\n\t\treturn res;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicAudioFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.AudioFileInfoBuilder;\n\n/**\n * Basic implementation of an audio file info.\n *\n * @author Matt Coley\n */\npublic class BasicAudioFileInfo extends BasicFileInfo implements AudioFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicAudioFileInfo(AudioFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicBinaryXmlFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.BinaryXmlFileInfoBuilder;\n\n/**\n * Basic implementation of binary XML file info.\n *\n * @author Matt Coley\n */\npublic class BasicBinaryXmlFileInfo extends BasicAndroidChunkFileInfo implements BinaryXmlFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicBinaryXmlFileInfo(BinaryXmlFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.annotation.AnnotationInfo;\nimport software.coley.recaf.info.annotation.TypeAnnotationInfo;\nimport software.coley.recaf.info.builder.AbstractClassInfoBuilder;\nimport software.coley.recaf.info.member.BasicMember;\nimport software.coley.recaf.info.member.FieldMember;\nimport software.coley.recaf.info.member.LocalVariable;\nimport software.coley.recaf.info.member.MethodMember;\nimport software.coley.recaf.info.properties.Property;\nimport software.coley.recaf.info.properties.PropertyContainer;\nimport software.coley.recaf.util.Types;\n\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.Objects;\nimport java.util.stream.Stream;\n\n/**\n * Basic implementation of class info.\n *\n * @author Matt Coley\n * @see BasicJvmClassInfo\n * @see BasicAndroidClassInfo\n */\npublic abstract class BasicClassInfo implements ClassInfo {\n\tprivate static final int SIGS_VALID = 1;\n\tprivate static final int SIGS_INVALID = 0;\n\tprivate static final int SIGS_UNKNOWN = -1;\n\tprivate final PropertyContainer properties;\n\tprivate final String name;\n\tprivate final String superName;\n\tprivate final List interfaces;\n\tprivate final int access;\n\tprivate final String signature;\n\tprivate final String sourceFileName;\n\tprivate final List annotations;\n\tprivate final List typeAnnotations;\n\tprivate final String outerClassName;\n\tprivate final String outerMethodName;\n\tprivate final String outerMethodDescriptor;\n\tprivate final List innerClasses;\n\tprivate final List fields;\n\tprivate final List methods;\n\tprivate List breadcrumbs;\n\tprivate int sigCheck = SIGS_UNKNOWN;\n\n\tprotected BasicClassInfo(@Nonnull AbstractClassInfoBuilder builder) {\n\t\tthis(builder.getName(),\n\t\t\t\tbuilder.getSuperName(),\n\t\t\t\tbuilder.getInterfaces(),\n\t\t\t\tbuilder.getAccess(),\n\t\t\t\tbuilder.getSignature(),\n\t\t\t\tbuilder.getSourceFileName(),\n\t\t\t\tbuilder.getAnnotations(),\n\t\t\t\tbuilder.getTypeAnnotations(),\n\t\t\t\tbuilder.getOuterClassName(),\n\t\t\t\tbuilder.getOuterMethodName(),\n\t\t\t\tbuilder.getOuterMethodDescriptor(),\n\t\t\t\tbuilder.getInnerClasses(),\n\t\t\t\tbuilder.getFields(),\n\t\t\t\tbuilder.getMethods(),\n\t\t\t\tbuilder.getPropertyContainer());\n\t}\n\n\tprotected BasicClassInfo(@Nonnull String name, String superName, @Nonnull List interfaces, int access,\n\t String signature, String sourceFileName,\n\t @Nonnull List annotations,\n\t @Nonnull List typeAnnotations,\n\t String outerClassName, String outerMethodName,\n\t String outerMethodDescriptor,\n\t @Nonnull List innerClasses,\n\t @Nonnull List fields, @Nonnull List methods,\n\t @Nonnull PropertyContainer properties) {\n\t\tthis.name = name;\n\t\tthis.superName = superName;\n\t\tthis.interfaces = interfaces;\n\t\tthis.access = access;\n\t\tthis.signature = signature;\n\t\tthis.sourceFileName = sourceFileName;\n\t\tthis.annotations = annotations;\n\t\tthis.typeAnnotations = typeAnnotations;\n\t\tthis.outerClassName = outerClassName;\n\t\tthis.outerMethodName = outerMethodName;\n\t\tthis.outerMethodDescriptor = outerMethodDescriptor;\n\t\tthis.innerClasses = innerClasses;\n\t\tthis.fields = fields;\n\t\tthis.methods = methods;\n\t\tthis.properties = properties;\n\t\t// Link fields/methods to self\n\t\tStream.concat(fields.stream(), methods.stream())\n\t\t\t\t.filter(member -> member instanceof BasicMember)\n\t\t\t\t.map(member -> (BasicMember) member)\n\t\t\t\t.forEach(member -> member.setDeclaringClass(this));\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getName() {\n\t\treturn name;\n\t}\n\n\t@Override\n\tpublic String getSuperName() {\n\t\treturn superName;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getInterfaces() {\n\t\treturn interfaces;\n\t}\n\n\t@Override\n\tpublic int getAccess() {\n\t\treturn access;\n\t}\n\n\t@Override\n\tpublic String getSignature() {\n\t\treturn signature;\n\t}\n\n\t@Override\n\tpublic String getSourceFileName() {\n\t\treturn sourceFileName;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getAnnotations() {\n\t\treturn annotations;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getTypeAnnotations() {\n\t\treturn typeAnnotations;\n\t}\n\n\t@Override\n\tpublic String getOuterClassName() {\n\t\treturn outerClassName;\n\t}\n\n\t@Override\n\tpublic String getOuterMethodName() {\n\t\treturn outerMethodName;\n\t}\n\n\t@Override\n\tpublic String getOuterMethodDescriptor() {\n\t\treturn outerMethodDescriptor;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getOuterClassBreadcrumbs() {\n\t\tif (breadcrumbs == null) {\n\t\t\tString currentOuter = getOuterClassName();\n\t\t\tif (currentOuter == null)\n\t\t\t\treturn breadcrumbs = Collections.emptyList();\n\n\t\t\tint maxOuterDepth = 10;\n\t\t\tList list = new ArrayList<>();\n\t\t\tint counter = 0;\n\t\t\twhile (currentOuter != null) {\n\t\t\t\tif (++counter > maxOuterDepth) {\n\t\t\t\t\tlist.clear(); // assuming some obfuscator is at work, so breadcrumbs might be invalid.\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tlist.addFirst(currentOuter);\n\t\t\t\tString targetOuter = currentOuter;\n\t\t\t\tcurrentOuter = innerClasses.stream()\n\t\t\t\t\t\t.filter(i -> i.getInnerClassName().equals(targetOuter) && i.getOuterClassName() != null)\n\t\t\t\t\t\t.map(InnerClassInfo::getOuterClassName)\n\t\t\t\t\t\t.findFirst().orElse(null);\n\t\t\t}\n\t\t\tbreadcrumbs = Collections.unmodifiableList(list);\n\t\t}\n\t\treturn breadcrumbs;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getInnerClasses() {\n\t\treturn innerClasses;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getFields() {\n\t\treturn fields;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getMethods() {\n\t\treturn methods;\n\t}\n\n\t@Override\n\tpublic void setProperty(Property property) {\n\t\tproperties.setProperty(property);\n\t}\n\n\t@Override\n\tpublic void removeProperty(String key) {\n\t\tproperties.removeProperty(key);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Map> getProperties() {\n\t\treturn properties.getProperties();\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null) return false;\n\n\t\tif (o instanceof ClassInfo other) {\n\t\t\t// NOTE: Do NOT consider the properties since contents of the map can point back to this instance\n\t\t\t// or our containing resource, causing a cycle.\n\t\t\tif (access != other.getAccess()) return false;\n\t\t\tif (!name.equals(other.getName())) return false;\n\t\t\tif (!Objects.equals(superName, other.getSuperName())) return false;\n\t\t\tif (!interfaces.equals(other.getInterfaces())) return false;\n\t\t\tif (!Objects.equals(signature, other.getSignature())) return false;\n\t\t\tif (!Objects.equals(sourceFileName, other.getSourceFileName())) return false;\n\t\t\tif (!annotations.equals(other.getAnnotations())) return false;\n\t\t\tif (!typeAnnotations.equals(other.getTypeAnnotations())) return false;\n\t\t\tif (!Objects.equals(outerClassName, other.getOuterClassName())) return false;\n\t\t\tif (!Objects.equals(outerMethodName, other.getOuterMethodName())) return false;\n\t\t\tif (!Objects.equals(outerMethodDescriptor, other.getOuterMethodDescriptor())) return false;\n\t\t\tif (!innerClasses.equals(other.getInnerClasses())) return false;\n\t\t\tif (!fields.equals(other.getFields())) return false;\n\t\t\treturn methods.equals(other.getMethods());\n\t\t}\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\t// NOTE: Do NOT consider the properties since contents of the map can point back to this instance\n\t\t// or our containing resource, causing a cycle.\n\t\tint result = name.hashCode();\n\t\tresult = 31 * result + (superName != null ? superName.hashCode() : 0);\n\t\tresult = 31 * result + interfaces.hashCode();\n\t\tresult = 31 * result + access;\n\t\tresult = 31 * result + (signature != null ? signature.hashCode() : 0);\n\t\tresult = 31 * result + (sourceFileName != null ? sourceFileName.hashCode() : 0);\n\t\tresult = 31 * result + annotations.hashCode();\n\t\tresult = 31 * result + typeAnnotations.hashCode();\n\t\tresult = 31 * result + (outerClassName != null ? outerClassName.hashCode() : 0);\n\t\tresult = 31 * result + (outerMethodName != null ? outerMethodName.hashCode() : 0);\n\t\tresult = 31 * result + (outerMethodDescriptor != null ? outerMethodDescriptor.hashCode() : 0);\n\t\tresult = 31 * result + innerClasses.hashCode();\n\t\tresult = 31 * result + fields.hashCode();\n\t\tresult = 31 * result + methods.hashCode();\n\t\treturn result;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicDexFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.DexFileInfoBuilder;\n\n/**\n * Basic implementation of an Android DEX file info.\n *\n * @author Matt Coley\n */\npublic class BasicDexFileInfo extends BasicFileInfo implements DexFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicDexFileInfo(DexFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.builder.FileInfoBuilder;\nimport software.coley.recaf.info.properties.Property;\nimport software.coley.recaf.info.properties.PropertyContainer;\n\nimport java.util.Arrays;\nimport java.util.Map;\n\n/**\n * Basic implementation of file info.\n *\n * @author Matt Coley\n */\npublic class BasicFileInfo implements FileInfo {\n\tprivate final PropertyContainer properties;\n\tprivate final String name;\n\tprivate final byte[] rawContent;\n\n\tpublic BasicFileInfo(@Nonnull FileInfoBuilder builder) {\n\t\tthis(builder.getName(),\n\t\t\t\tbuilder.getRawContent(),\n\t\t\t\tbuilder.getProperties());\n\t}\n\n\t/**\n\t * @param name\n\t * \t\tFile name/path.\n\t * @param rawContent\n\t * \t\tRaw contents of file.\n\t * @param properties\n\t * \t\tAssorted properties.\n\t */\n\tpublic BasicFileInfo(@Nonnull String name, @Nonnull byte[] rawContent, @Nonnull PropertyContainer properties) {\n\t\tthis.name = name;\n\t\tthis.rawContent = rawContent;\n\t\tthis.properties = properties;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic byte[] getRawContent() {\n\t\treturn rawContent;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getName() {\n\t\treturn name;\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null) return false;\n\t\tif (o instanceof FileInfo other) {\n\t\t\tif (!name.equals(other.getName())) return false;\n\t\t\treturn Arrays.equals(rawContent, other.getRawContent());\n\t\t}\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = name.hashCode();\n\t\tresult = 31 * result + Arrays.hashCode(rawContent);\n\t\treturn result;\n\t}\n\n\t@Override\n\tpublic void setProperty(Property property) {\n\t\tproperties.setProperty(property);\n\t}\n\n\t@Override\n\tpublic void removeProperty(String key) {\n\t\tproperties.removeProperty(key);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Map> getProperties() {\n\t\treturn properties.getProperties();\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn name;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicImageFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.ImageFileInfoBuilder;\n\n/**\n * Basic implementation of an image file info.\n *\n * @author Matt Coley\n */\npublic class BasicImageFileInfo extends BasicFileInfo implements ImageFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicImageFileInfo(ImageFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicInnerClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\n\nimport java.util.Objects;\n\n/**\n * Basic implementation of inner class info.\n *\n * @author Matt Coley\n */\npublic class BasicInnerClassInfo implements InnerClassInfo {\n\tprivate final String outerDeclaringClassName; // Recaf specific, not modeling class spec\n\tprivate final String innerClassName;\n\tprivate final String outerClassName;\n\tprivate final String innerName;\n\tprivate final int access;\n\tprivate String simpleName;\n\n\t/**\n\t * @param outerDeclaringClassName\n\t * \t\tDeclaring class name,\n\t * @param innerClassName\n\t * \t\tInner name.\n\t * @param outerClassName\n\t * \t\tOuter name.\n\t * @param innerName\n\t * \t\tLocal inner name.\n\t * @param access\n\t * \t\tInner class flags originally declared.\n\t */\n\tpublic BasicInnerClassInfo(String outerDeclaringClassName, String innerClassName,\n\t String outerClassName, String innerName, int access) {\n\t\tthis.outerDeclaringClassName = outerDeclaringClassName;\n\t\tthis.innerClassName = innerClassName;\n\t\tthis.outerClassName = outerClassName;\n\t\tthis.innerName = innerName;\n\t\tthis.access = access;\n\t}\n\n\t@Override\n\tpublic int getAccess() {\n\t\treturn access;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getOuterDeclaringClassName() {\n\t\treturn outerDeclaringClassName;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getInnerClassName() {\n\t\treturn innerClassName;\n\t}\n\n\t@Override\n\tpublic String getOuterClassName() {\n\t\treturn outerClassName;\n\t}\n\n\t@Override\n\tpublic String getInnerName() {\n\t\treturn innerName;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getSimpleName() {\n\t\t// Cache simple name computation\n\t\tif (simpleName == null) simpleName = InnerClassInfo.super.getSimpleName();\n\t\treturn simpleName;\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null) return false;\n\n\t\tif (o instanceof InnerClassInfo inner) {\n\t\t\tif (access != inner.getAccess()) return false;\n\t\t\tif (!innerClassName.equals(inner.getInnerClassName())) return false;\n\t\t\tif (!Objects.equals(outerClassName, inner.getOuterClassName())) return false;\n\t\t\treturn Objects.equals(innerName, inner.getInnerName());\n\t\t}\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = innerClassName.hashCode();\n\t\tresult = 31 * result + (outerClassName != null ? outerClassName.hashCode() : 0);\n\t\tresult = 31 * result + (innerName != null ? innerName.hashCode() : 0);\n\t\tresult = 31 * result + access;\n\t\treturn result;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn \"Inner class: \" + getSimpleName();\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicJModFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.JModFileInfoBuilder;\n\n/**\n * Basic implementation of JMod file info.\n *\n * @author Matt Coley\n */\npublic class BasicJModFileInfo extends BasicZipFileInfo implements JModFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicJModFileInfo(JModFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicJarFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.JarFileInfoBuilder;\n\n/**\n * Basic implementation of JAR file info.\n *\n * @author Matt Coley\n */\npublic class BasicJarFileInfo extends BasicZipFileInfo implements JarFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicJarFileInfo(JarFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicJvmClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport org.objectweb.asm.ClassReader;\nimport software.coley.recaf.info.builder.JvmClassInfoBuilder;\n\nimport java.util.Arrays;\n\n/**\n * Basic JVM class info implementation.\n *\n * @author Matt Coley\n */\npublic class BasicJvmClassInfo extends BasicClassInfo implements JvmClassInfo {\n\tprivate final byte[] bytecode;\n\tprivate final int version;\n\tprivate ClassReader reader;\n\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull info from.\n\t */\n\tpublic BasicJvmClassInfo(@Nonnull JvmClassInfoBuilder builder) {\n\t\tsuper(builder);\n\t\tthis.bytecode = builder.getBytecode();\n\t\tthis.version = builder.getVersion();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic byte[] getBytecode() {\n\t\treturn bytecode;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic ClassReader getClassReader() {\n\t\tif (reader == null)\n\t\t\treader = new ClassReader(bytecode);\n\t\treturn reader;\n\t}\n\n\t@Override\n\tpublic int getVersion() {\n\t\treturn version;\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null) return false;\n\n\t\tif (o instanceof JvmClassInfo other) {\n\t\t\tif (version != other.getVersion()) return false;\n\t\t\treturn Arrays.equals(bytecode, other.getBytecode());\n\t\t} else if (!super.equals(o)) {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = super.hashCode();\n\t\tresult = 31 * result + Arrays.hashCode(bytecode);\n\t\tresult = 31 * result + version;\n\t\treturn result;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn \"JVM class: \" + getName();\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicModulesFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.ModulesFileInfoBuilder;\n\n/**\n * Basic implementation of Modules file info.\n *\n * @author Matt Coley\n */\npublic class BasicModulesFileInfo extends BasicFileInfo implements ModulesFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicModulesFileInfo(ModulesFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicNativeLibraryFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.NativeLibraryFileInfoBuilder;\n\n/**\n * Basic implementation of a native-library file info.\n *\n * @author Matt Coley\n */\npublic class BasicNativeLibraryFileInfo extends BasicFileInfo implements NativeLibraryFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicNativeLibraryFileInfo(NativeLibraryFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicTextFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.builder.TextFileInfoBuilder;\n\nimport java.nio.charset.Charset;\n\n/**\n * Basic implementation of text file info.\n *\n * @author Matt Coley\n */\npublic class BasicTextFileInfo extends BasicFileInfo implements TextFileInfo {\n\tprivate final Charset charset;\n\tprivate final String text;\n\tprivate String[] lines;\n\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicTextFileInfo(@Nonnull TextFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t\ttext = builder.getText();\n\t\tcharset = builder.getCharset();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getText() {\n\t\treturn text;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String[] getTextLines() {\n\t\tif (lines == null)\n\t\t\tlines = getText().lines().toArray(String[]::new);\n\t\treturn lines;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Charset getCharset() {\n\t\treturn charset;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicVideoFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.VideoFileInfoBuilder;\n\n/**\n * Basic implementation of a video file info.\n *\n * @author Matt Coley\n */\npublic class BasicVideoFileInfo extends BasicFileInfo implements VideoFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicVideoFileInfo(VideoFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicWarFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.WarFileInfoBuilder;\n\n/**\n * Basic implementation of WAR file info.\n *\n * @author Matt Coley\n */\npublic class BasicWarFileInfo extends BasicZipFileInfo implements WarFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicWarFileInfo(WarFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BasicZipFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport software.coley.recaf.info.builder.ZipFileInfoBuilder;\n\n/**\n * Basic implementation of ZIP file info.\n *\n * @author Matt Coley\n */\npublic class BasicZipFileInfo extends BasicFileInfo implements ZipFileInfo {\n\t/**\n\t * @param builder\n\t * \t\tBuilder to pull information from.\n\t */\n\tpublic BasicZipFileInfo(ZipFileInfoBuilder builder) {\n\t\tsuper(builder);\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/BinaryXmlFileInfo.java",
"content": "package software.coley.recaf.info;\n\n/**\n * Outline of a binary XML file, used by Android APK's.\n *\n * @author Matt Coley\n */\npublic interface BinaryXmlFileInfo extends AndroidChunkFileInfo {\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/ClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.annotation.Nullable;\nimport software.coley.recaf.info.annotation.Annotated;\nimport software.coley.recaf.info.member.ClassMember;\nimport software.coley.recaf.info.member.FieldMember;\nimport software.coley.recaf.info.member.MethodMember;\nimport software.coley.recaf.util.Types;\nimport software.coley.recaf.util.visitors.IllegalSignatureRemovingVisitor;\n\nimport java.util.List;\nimport java.util.function.Consumer;\nimport java.util.function.Function;\nimport java.util.function.Predicate;\nimport java.util.stream.Stream;\n\n/**\n * Outline of a class.\n *\n * @author Matt Coley\n * @see JvmClassInfo For JVM classes.\n * @see AndroidClassInfo For Android classes.\n */\npublic interface ClassInfo extends Info, Annotated, Accessed {\n\t/**\n\t * @return Name of the source file the class was compiled from.\n\t * May be {@code null} when there is no debug data attached to the class.\n\t */\n\t@Nullable\n\tString getSourceFileName();\n\n\t/**\n\t * @return List of implemented interfaces.\n\t */\n\t@Nonnull\n\tList getInterfaces();\n\n\t/**\n\t * @return Super-name of the class.\n\t * May be {@code null} for {@link java.lang.annotation.Annotation} and {@code module-info} classes.\n\t */\n\t@Nullable\n\tString getSuperName();\n\n\t/**\n\t * @return Package the class resides in.\n\t * May be {@code null} for classes in the default package.\n\t */\n\t@Nullable\n\tdefault String getPackageName() {\n\t\tString className = getName();\n\t\tint packageIndex = className.lastIndexOf('/');\n\t\tif (packageIndex <= 0) return null;\n\t\treturn className.substring(0, packageIndex);\n\t}\n\n\t/**\n\t * @return {@code true} when the class name has no package.\n\t */\n\tdefault boolean isInDefaultPackage() {\n\t\treturn getPackageName() == null;\n\t}\n\n\t/**\n\t * @return Stream of all parent types, where the {@link #getSuperName()} is first if present,\n\t * followed by any {@link #getInterfaces()}.\n\t */\n\t@Nonnull\n\tdefault Stream parentTypesStream() {\n\t\treturn Stream.concat(\n\t\t\t\tStream.ofNullable(getSuperName()),\n\t\t\t\tgetInterfaces().stream()\n\t\t);\n\t}\n\n\t/**\n\t * @return Signature containing generic information. May be {@code null}.\n\t */\n\t@Nullable\n\tString getSignature();\n\n\t/**\n\t * @return Name of outer class that this is declared in, if this is an inner class.\n\t * {@code null} when this class is not an inner class.\n\t */\n\t@Nullable\n\tString getOuterClassName();\n\n\t/**\n\t * @return Name of the outer method that this is declared in, as an anonymous inner class.\n\t * {@code null} when this class is not an inner anonymous class.\n\t *\n\t * @see #getOuterMethodDescriptor() Descriptor of outer method\n\t */\n\t@Nullable\n\tString getOuterMethodName();\n\n\t/**\n\t * @return Descriptor of the outer method that this is declared in, as an anonymous inner class.\n\t * {@code null} when this class is not an inner anonymous class.\n\t *\n\t * @see #getOuterMethodName() Name of outer method.\n\t */\n\t@Nullable\n\tString getOuterMethodDescriptor();\n\n\t/**\n\t * Breadcrumbs of the outer class.\n\t * This List MUST be sorted in order of the outermost first.\n\t * The last element is the outer of the class itself.\n\t * \n\t * For an example, if our class is 'C' then this list will be {@code [foo/A, foo/A$B]}:\n\t *
{@code\n\t * package foo;\n\t *\n\t * class A {\n\t * class B {\n\t * class C {} // This class\n\t * }\n\t * }\n\t * }
\n\t *\n\t * @return Breadcrumbs of the outer class.\n\t */\n\t@Nonnull\n\tList getOuterClassBreadcrumbs();\n\n\t/**\n\t * @return List of declared inner classes.\n\t */\n\t@Nonnull\n\tList getInnerClasses();\n\n\t/**\n\t * Gets a named inner class by the local name.\n\t * Given the following example, you would pass {@code \"Bar\"} or even {@code \"FizzBuzz\"}:\n\t *
{@code\n\t * class Foo {\n\t * class Bar {\n\t * class FizzBuzz {}\n\t * }\n\t * }\n\t * }
\n\t * Because anonymous inner classes do not have a name declared, they cannot be yielded here.\n\t *\n\t * @param innerName\n\t * \t\tLocal name of inner class.\n\t *\n\t * @return Inner class of the matching name, or {@code null} if no such inner exists.\n\t */\n\t@Nullable\n\tdefault InnerClassInfo getInnerClassByInnerName(@Nonnull String innerName) {\n\t\tfor (InnerClassInfo innerClass : getInnerClasses())\n\t\t\tif (innerName.equals(innerClass.getInnerName()))\n\t\t\t\treturn innerClass;\n\t\treturn null;\n\t}\n\n\t/**\n\t * @return {@code true} when this class is an inner class of another class.\n\t */\n\tdefault boolean isInnerClass() {\n\t\treturn getOuterClassName() != null || getOuterMethodName() != null;\n\t}\n\n\t/**\n\t * @param className\n\t * \t\tName of a supposed outer class.\n\t *\n\t * @return {@code true} if this class is an inner class of the given outer class.\n\t */\n\tdefault boolean isInnerClassOf(@Nonnull String className) {\n\t\t// If we don't start with that class name, we can't possibly be an inner class.\n\t\tif (!getName().startsWith(className + \"$\"))\n\t\t\treturn false;\n\t\treturn getOuterClassBreadcrumbs().contains(className);\n\t}\n\n\t/**\n\t * @return {@code true} when this class is an anonymous inner class of another class.\n\t */\n\tdefault boolean isAnonymousInnerClass() {\n\t\t// Check if the 'full' name of the inner 'InnerClassName' is the current class (entry representing ourselves)\n\t\t// Then if the 'OuterClassName' is null, this means our class does not expose a name because it is anonymous.\n\t\treturn getInnerClasses().stream()\n\t\t\t\t.anyMatch(inner -> inner.getInnerClassName().equals(getName()) && inner.getOuterClassName() == null);\n\t}\n\n\t/**\n\t * @return List of declared fields.\n\t */\n\t@Nonnull\n\tList getFields();\n\n\t/**\n\t * @return List of declared methods.\n\t */\n\t@Nonnull\n\tList getMethods();\n\n\t/**\n\t * @return Stream of declared fields.\n\t */\n\t@Nonnull\n\tdefault Stream fieldStream() {\n\t\treturn Stream.of(this).flatMap(self -> self.getFields().stream());\n\t}\n\n\t/**\n\t * @return Stream of declared methods.\n\t */\n\t@Nonnull\n\tdefault Stream methodStream() {\n\t\treturn Stream.of(this).flatMap(self -> self.getMethods().stream());\n\t}\n\n\t/**\n\t * @return Stream of declared fields and methods.\n\t */\n\t@Nonnull\n\tdefault Stream fieldAndMethodStream() {\n\t\treturn Stream.concat(fieldStream(), methodStream());\n\t}\n\n\t/**\n\t * Do note that there can be multiple fields with one name if there are different descriptors for each.\n\t * To differentiate properly, please use {@link #getDeclaredField(String, String)}.\n\t *\n\t * @param name\n\t * \t\tField name.\n\t *\n\t * @return First matching field definition, or {@code null} if none were found.\n\t */\n\t@Nullable\n\tdefault FieldMember getFirstDeclaredFieldByName(@Nonnull String name) {\n\t\treturn fieldStream()\n\t\t\t\t.filter(f -> f.getName().equals(name))\n\t\t\t\t.findFirst().orElse(null);\n\t}\n\n\t/**\n\t * @param name\n\t * \t\tField name.\n\t * @param descriptor\n\t * \t\tField descriptor.\n\t *\n\t * @return Field matching definition, or {@code null} if none were found.\n\t */\n\t@Nullable\n\tdefault FieldMember getDeclaredField(@Nonnull String name, @Nonnull String descriptor) {\n\t\treturn fieldStream()\n\t\t\t\t.filter(f -> f.getName().equals(name) && f.getDescriptor().equals(descriptor))\n\t\t\t\t.findFirst().orElse(null);\n\t}\n\n\t/**\n\t * @param name\n\t * \t\tMethod name.\n\t * @param descriptor\n\t * \t\tMethod descriptor.\n\t *\n\t * @return Method matching definition, or {@code null} if none were found.\n\t */\n\t@Nullable\n\tdefault MethodMember getDeclaredMethod(@Nonnull String name, @Nonnull String descriptor) {\n\t\treturn methodStream()\n\t\t\t\t.filter(m -> m.getName().equals(name) && m.getDescriptor().equals(descriptor))\n\t\t\t\t.findFirst().orElse(null);\n\t}\n\n\t/**\n\t * Do note that there can be multiple methods with one name if there are different method descriptors for each.\n\t * To differentiate properly, please use {@link #getDeclaredMethod(String, String)}.\n\t *\n\t * @param name\n\t * \t\tMethod name.\n\t *\n\t * @return First matching method definition, or {@code null} if none were found.\n\t */\n\t@Nullable\n\tdefault MethodMember getFirstDeclaredMethodByName(@Nonnull String name) {\n\t\treturn methodStream()\n\t\t\t\t.filter(m -> m.getName().equals(name))\n\t\t\t\t.findFirst().orElse(null);\n\t}\n\n\t/**\n\t * @param action\n\t * \t\tAction to run if this is a JVM class.\n\t */\n\tvoid acceptIfJvmClass(@Nonnull Consumer action);\n\n\t/**\n\t * @param action\n\t * \t\tAction to run if this is an Android class.\n\t */\n\tvoid acceptIfAndroidClass(@Nonnull Consumer action);\n\n\t/**\n\t * @param action\n\t * \t\tAction to run.\n\t */\n\tdefault void acceptClass(@Nonnull Consumer action) {\n\t\taction.accept(this);\n\t}\n\n\t/**\n\t * @param predicate\n\t * \t\tPredicate to run if this is a JVM class.\n\t *\n\t * @return {@code true} when the predicate passes.\n\t * {@code false} when it does not, or the class is not a JVM class.\n\t */\n\tboolean testIfJvmClass(@Nonnull Predicate predicate);\n\n\t/**\n\t * @param predicate\n\t * \t\tPredicate to run if this is an Android class.\n\t *\n\t * @return {@code true} when the predicate passes.\n\t * {@code false} when it does not, or the class is not an Android class.\n\t */\n\tboolean testIfAndroidClass(@Nonnull Predicate predicate);\n\n\t/**\n\t * @param predicate\n\t * \t\tPredicate to run.\n\t *\n\t * @return Predicate evaluation.\n\t */\n\tdefault boolean testClass(@Nonnull Predicate predicate) {\n\t\treturn predicate.test(this);\n\t}\n\n\t/**\n\t * @param function\n\t * \t\tMapping function.\n\t * @param \n\t * \t\tFunction return type.\n\t *\n\t * @return Mapped value.\n\t */\n\tdefault R mapClass(@Nonnull Function function) {\n\t\treturn function.apply(this);\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault ClassInfo asClass() {\n\t\treturn this;\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault FileInfo asFile() {\n\t\tthrow new IllegalStateException(\"Class cannot be cast to generic file\");\n\t}\n\n\t/**\n\t * @return Self cast to JVM class.\n\t */\n\t@Nonnull\n\tJvmClassInfo asJvmClass();\n\n\t/**\n\t * @return Self cast to Android class.\n\t */\n\t@Nonnull\n\tAndroidClassInfo asAndroidClass();\n\n\t@Override\n\tdefault boolean isClass() {\n\t\treturn true;\n\t}\n\n\t@Override\n\tdefault boolean isFile() {\n\t\treturn false;\n\t}\n\n\t/**\n\t * @return {@code true} if self is a JVM class.\n\t */\n\tboolean isJvmClass();\n\n\t/**\n\t * @return {@code true} if self is an Android class.\n\t */\n\tboolean isAndroidClass();\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/DexFileInfo.java",
"content": "package software.coley.recaf.info;\n\n/**\n * Outline of an Android dex file.\n *\n * @author Matt Coley\n */\npublic interface DexFileInfo extends FileInfo {\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/FileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.annotation.Nullable;\nimport software.coley.recaf.info.builder.FileInfoBuilder;\n\n/**\n * Outline of a file.\n *\n * @author Matt Coley\n */\npublic interface FileInfo extends Info {\n\t/**\n\t * @return New builder wrapping this file information.\n\t */\n\t@Nonnull\n\tdefault FileInfoBuilder toFileBuilder() {\n\t\treturn FileInfoBuilder.forFile(this);\n\t}\n\n\t/**\n\t * @return Raw bytes of file content.\n\t */\n\t@Nonnull\n\tbyte[] getRawContent();\n\n\t/**\n\t * @return File extension of {@link #getName() the file name}, if any exists.\n\t */\n\t@Nullable\n\tdefault String getFileExtension() {\n\t\tString fileName = getName();\n\t\tint i = fileName.indexOf('.') + 1;\n\t\tif (i > 0)\n\t\t\treturn fileName.toLowerCase().substring(i);\n\t\treturn null;\n\t}\n\n\t/**\n\t * @return Directory the file resides in.\n\t * May be {@code null} for files in the root directory.\n\t */\n\t@Nullable\n\tdefault String getDirectoryName() {\n\t\tString fileName = getName();\n\t\tint directoryIndex = fileName.lastIndexOf('/');\n\t\tif (directoryIndex <= 0) return null;\n\t\treturn fileName.substring(0, directoryIndex);\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault ClassInfo asClass() {\n\t\tthrow new IllegalStateException(\"File cannot be cast to generic class\");\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault FileInfo asFile() {\n\t\treturn this;\n\t}\n\n\t/**\n\t * @return Self cast to text file.\n\t */\n\t@Nonnull\n\tdefault TextFileInfo asTextFile() {\n\t\tthrow new IllegalStateException(\"Non-text file cannot be cast to text file\");\n\t}\n\n\t/**\n\t * @return Self cast to image file.\n\t */\n\t@Nonnull\n\tdefault ImageFileInfo asImageFile() {\n\t\tthrow new IllegalStateException(\"Non-image file cannot be cast to image file\");\n\t}\n\n\t/**\n\t * @return Self cast to audio file.\n\t */\n\t@Nonnull\n\tdefault AudioFileInfo asAudioFile() {\n\t\tthrow new IllegalStateException(\"Non-audio file cannot be cast to audio file\");\n\t}\n\n\t/**\n\t * @return Self cast to video file.\n\t */\n\t@Nonnull\n\tdefault VideoFileInfo asVideoFile() {\n\t\tthrow new IllegalStateException(\"Non-video file cannot be cast to video file\");\n\t}\n\n\t/**\n\t * @return Self cast to video file.\n\t */\n\t@Nonnull\n\tdefault NativeLibraryFileInfo asNativeLibraryFile() {\n\t\tthrow new IllegalStateException(\"Non-native-library file cannot be cast to native-library file\");\n\t}\n\n\t/**\n\t * @return Self cast to zip file.\n\t */\n\t@Nonnull\n\tdefault ZipFileInfo asZipFile() {\n\t\tthrow new IllegalStateException(\"Non-zip file cannot be cast to zip file\");\n\t}\n\n\t@Override\n\tdefault boolean isClass() {\n\t\treturn false;\n\t}\n\n\t@Override\n\tdefault boolean isFile() {\n\t\treturn true;\n\t}\n\n\t/**\n\t * @return {@code true} if self is a text file.\n\t */\n\tdefault boolean isTextFile() {\n\t\treturn false;\n\t}\n\n\t/**\n\t * @return {@code true} if self is an image file.\n\t */\n\tdefault boolean isImageFile() {\n\t\treturn false;\n\t}\n\n\t/**\n\t * @return {@code true} if self is an audio file.\n\t */\n\tdefault boolean isAudioFile() {\n\t\treturn false;\n\t}\n\n\t/**\n\t * @return {@code true} if self is a video file.\n\t */\n\tdefault boolean isVideoFile() {\n\t\treturn false;\n\t}\n\n\t/**\n\t * @return {@code true} if self is a native-library file.\n\t */\n\tdefault boolean isNativeLibraryFile() {\n\t\treturn false;\n\t}\n\n\t/**\n\t * @return {@code true} if self is a zip file.\n\t */\n\tdefault boolean isZipFile() {\n\t\treturn false;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/ImageFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\n\n/**\n * Outline of an image file.\n *\n * @author Matt Coley\n */\npublic interface ImageFileInfo extends FileInfo {\n\t@Nonnull\n\t@Override\n\tdefault ImageFileInfo asImageFile() {\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault boolean isImageFile() {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/Info.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.properties.PropertyContainer;\n\n/**\n * Outline of all info types.\n *\n * @author Matt Coley\n */\npublic interface Info extends Named, PropertyContainer {\n\t/**\n\t * @return Self cast to general class.\n\t */\n\t@Nonnull\n\tClassInfo asClass();\n\n\t/**\n\t * @return Self cast to general file.\n\t */\n\t@Nonnull\n\tFileInfo asFile();\n\n\t/**\n\t * @return {@code true} if self is a general class.\n\t */\n\tboolean isClass();\n\n\t/**\n\t * @return {@code true} if self is a general file.\n\t */\n\tboolean isFile();\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/InnerClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.annotation.Nullable;\n\n/**\n * Outline of an inner class for a declaring {@link ClassInfo}.\n * \n * Important note: Oracle's Java Virtual Machine implementation\n * does not check the consistency of an InnerClasses attribute against a class\n * file representing a class or interface referenced by the attribute.\n *\n * @author Matt Coley\n * @author Amejonah\n */\npublic interface InnerClassInfo extends Accessed, Named {\n\t@Nonnull\n\t@Override\n\tdefault String getName() {\n\t\treturn getInnerClassName();\n\t}\n\n\t/**\n\t * @return The name of the outer declaring class for this inner class.\n\t */\n\t@Nonnull\n\tString getOuterDeclaringClassName();\n\n\t/**\n\t * Given the following example, the inner name is {@code Apple$Worm}.\n\t *
\n\t * class Apple {\n\t * class Worm {}\n\t * }\n\t *
\n\t *\n\t * @return The internal name of an inner class.\n\t */\n\t@Nonnull\n\tString getInnerClassName();\n\n\t/**\n\t * Given the following example, the inner name is {@code Apple}.\n\t *
\n\t * class Apple {\n\t * class Worm {}\n\t * }\n\t *
\n\t *\n\t * @return The internal name of the class to which the inner class belongs.\n\t * May be {@code null} for anonymous classes.\n\t */\n\t@Nullable\n\tString getOuterClassName();\n\n\t/**\n\t * Given the following example, the inner name is {@code Worm}.\n\t *
\n\t * class Apple {\n\t * class Worm {}\n\t * }\n\t *
\n\t *\n\t * @return The (simple) name of the inner class inside its enclosing class.\n\t * May be {@code null} for anonymous inner classes.\n\t */\n\t@Nullable\n\tString getInnerName();\n\n\t/**\n\t * There are some wierd cases where there can be inner-class entries of classes defined by other classes.\n\t * You can use this to filter those cases out.\n\t *\n\t * @return {@code true} when this inner-class entry denotes an inner-class\n\t * reference to a class defined in another class.\n\t */\n\tdefault boolean isExternalReference() {\n\t\treturn !getInnerClassName().startsWith(getOuterDeclaringClassName());\n\t}\n\n\t/**\n\t * @return The access modifiers of the inner class as originally declared in the enclosing class.\n\t */\n\tdefault int getInnerAccess() {\n\t\treturn getAccess();\n\t}\n\n\t/**\n\t * @return Either {@link #getInnerName()} if not {@code null},\n\t * otherwise the last \"part\" (after last $ or /) of {@link #getOuterClassName()}.\n\t */\n\t@Nonnull\n\tdefault String getSimpleName() {\n\t\t// Check for inner name\n\t\tString innerName = getInnerName();\n\t\tif (innerName != null) return innerName;\n\n\t\t// Substring from outer class prefix\n\t\tString outerDeclaringClass = getOuterDeclaringClassName();\n\t\tString outerName = getOuterClassName();\n\t\tif (outerName != null) {\n\t\t\tint outerDeclaringLength = outerDeclaringClass.length();\n\t\t\tint lastIndex = 0;\n\t\t\tint endIndex = Math.min(outerDeclaringLength, outerName.length());\n\t\t\tfor (; lastIndex < endIndex; lastIndex++) {\n\t\t\t\tif (outerDeclaringClass.charAt(lastIndex) != outerName.charAt(lastIndex)) break;\n\t\t\t}\n\n\t\t\t// Edge case handling with outer name\n\t\t\tif (lastIndex == 0)\n\t\t\t\treturn outerName;\n\t\t\telse if (outerName.startsWith(\"$\", lastIndex))\n\t\t\t\tlastIndex++;\n\t\t\treturn outerName.substring(lastIndex);\n\t\t}\n\n\t\t// Class entry is for anonymous class.\n\t\tString innerClassName = getInnerClassName();\n\t\treturn \"Anonymous '\" + innerClassName.substring(innerClassName.lastIndexOf('$') + 1) + \"'\";\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/JModFileInfo.java",
"content": "package software.coley.recaf.info;\n\n/**\n * Outline of a JVM JMod file.\n * These files are found at {@code %JAVA%/jmods/}.\n *\n * @author Matt Coley\n */\npublic interface JModFileInfo extends ZipFileInfo {\n\t/**\n\t * Classes in the JMod archive are prefixed with this path.\n\t */\n\tString CLASSES_PREFIX = \"classes/\";\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/JarFileInfo.java",
"content": "package software.coley.recaf.info;\n\n/**\n * Outline of a JAR file container.\n *\n * @author Matt Coley\n */\npublic interface JarFileInfo extends ZipFileInfo {\n\t/**\n\t * Multi-release JARs prefix class names with this, plus the target version.\n\t * For example: Multiple versions of {@code foo/Bar.class}\n\t *
\n\t *
{@code foo/Bar.class}
\n\t *
{@code META-INF/versions/9/foo/Bar.class}
\n\t *
{@code META-INF/versions/11/foo/Bar.class}
\n\t *
\n\t * The first item is used for Java 8. \n\t * The second item for Java 9 and 10. \n\t * The third item for Java 11+.\n\t */\n\tString MULTI_RELEASE_PREFIX = \"META-INF/versions/\";\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/JvmClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport org.objectweb.asm.ClassReader;\nimport org.objectweb.asm.Opcodes;\nimport org.objectweb.asm.Type;\nimport software.coley.cafedude.classfile.ConstantPoolConstants;\nimport software.coley.recaf.info.builder.JvmClassInfoBuilder;\nimport software.coley.recaf.info.properties.builtin.ReferencedClassesProperty;\nimport software.coley.recaf.info.properties.builtin.StringDefinitionsProperty;\nimport software.coley.recaf.util.JavaVersion;\nimport software.coley.recaf.util.Types;\nimport software.coley.recaf.util.visitors.TypeVisitor;\n\nimport java.util.*;\nimport java.util.function.Consumer;\nimport java.util.function.Predicate;\n\n/**\n * Outline of a JVM class.\n *\n * @author Matt Coley\n */\npublic interface JvmClassInfo extends ClassInfo {\n\t/**\n\t * Denotes the base version offset.\n\t *
\n\t *
For version 1 of you would use {@code BASE_VERSION + 1}.
\n\t *
For version 2 of you would use {@code BASE_VERSION + 2}.
\n\t *
...
\n\t *
For version N of you would use {@code BASE_VERSION + N}.
\n\t *
\n\t */\n\tint BASE_VERSION = 44;\n\n\t/**\n\t * @return New builder wrapping this class information.\n\t */\n\t@Nonnull\n\tdefault JvmClassInfoBuilder toJvmClassBuilder() {\n\t\treturn new JvmClassInfoBuilder(this);\n\t}\n\n\t/**\n\t * @return Java class file version.\n\t */\n\tint getVersion();\n\n\t/**\n\t * @return Bytecode of class.\n\t */\n\t@Nonnull\n\tbyte[] getBytecode();\n\n\t/**\n\t * @return Class reader of {@link #getBytecode()}.\n\t */\n\t@Nonnull\n\tClassReader getClassReader();\n\n\t/**\n\t * @return Default flags to use with {@link #getClassReader()}\n\t */\n\tdefault int getClassReaderFlags() {\n\t\t// There are some old classes with stack-frame data.\n\t\t// These aren't strictly required on old classes, and ASM dies when re-writing them (\n\t\t// - MethodWriter.visitFrame checks for pre Java 6 and throws\n\t\treturn getVersion() <= Opcodes.V1_5 ?\n\t\t\t\tClassReader.SKIP_FRAMES : 0;\n\t}\n\n\t/**\n\t * @return Set of all classes referenced in the constant pool.\n\t */\n\t@Nonnull\n\tdefault NavigableSet getReferencedClasses() {\n\t\tNavigableSet classes = ReferencedClassesProperty.get(this);\n\t\tif (classes != null)\n\t\t\treturn classes;\n\n\t\tSet classNames = new HashSet<>();\n\t\tClassReader reader = getClassReader();\n\n\t\t// Iterate over pool entries. Supe fast way to discover most of the referenced types.\n\t\tint itemCount = reader.getItemCount();\n\t\tchar[] buffer = new char[reader.getMaxStringLength()];\n\t\tfor (int i = 1; i < itemCount; i++) {\n\t\t\tint offset = reader.getItem(i);\n\t\t\tif (offset >= 10) {\n\t\t\t\ttry {\n\t\t\t\t\tint itemTag = reader.readByte(offset - 1);\n\t\t\t\t\tif (itemTag == ConstantPoolConstants.CLASS) {\n\t\t\t\t\t\tString className = reader.readUTF8(offset, buffer);\n\t\t\t\t\t\tif (className.isEmpty())\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\taddName(className, classNames);\n\t\t\t\t\t} else if (itemTag == ConstantPoolConstants.NAME_TYPE) {\n\t\t\t\t\t\tString desc = reader.readUTF8(offset + 2, buffer);\n\t\t\t\t\t\tif (desc.isEmpty())\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\tif (desc.charAt(0) == '(') {\n\t\t\t\t\t\t\taddMethodType(Type.getMethodType(desc), classNames);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tType type = Type.getType(desc);\n\t\t\t\t\t\t\taddType(type, classNames);\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (itemTag == ConstantPoolConstants.METHOD_TYPE) {\n\t\t\t\t\t\tString methodDesc = reader.readUTF8(offset, buffer);\n\t\t\t\t\t\tif (methodDesc.isEmpty() || methodDesc.charAt(0) != '(')\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\taddMethodType(Type.getMethodType(methodDesc), classNames);\n\t\t\t\t\t}\n\t\t\t\t} catch (Throwable ignored) {\n\t\t\t\t\t// Exists only to catch situations where obfuscators put unused junk pool entries\n\t\t\t\t\t// with malformed descriptors, which cause ASM's type parser to crash.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// In some cases like interface classes, there may be UTF8 pool entries outlining method descriptors which\n\t\t// are not directly linked in NameType or MethodType pool entries. We need to iterate over fields and methods\n\t\t// to get the descriptors in these cases.\n\t\treader.accept(new TypeVisitor(t -> {\n\t\t\tif (t.getSort() == Type.METHOD)\n\t\t\t\taddMethodType(t, classNames);\n\t\t\telse\n\t\t\t\taddType(t, classNames);\n\t\t}), ClassReader.SKIP_DEBUG | ClassReader.SKIP_CODE);\n\n\t\treturn ReferencedClassesProperty.set(this, classNames);\n\t}\n\n\tprivate static void addMethodType(@Nonnull Type methodType, @Nonnull Set classNames) {\n\t\tfor (Type argumentType : methodType.getArgumentTypes())\n\t\t\taddType(argumentType, classNames);\n\t\tType returnType = methodType.getReturnType();\n\t\taddType(returnType, classNames);\n\t}\n\n\tprivate static void addType(@Nonnull Type type, @Nonnull Set classNames) {\n\t\tif (type.getSort() == Type.ARRAY)\n\t\t\ttype = type.getElementType();\n\t\tif (!Types.isPrimitive(type))\n\t\t\taddName(type.getInternalName(), classNames);\n\t}\n\n\tprivate static void addName(@Nonnull String className, @Nonnull Set classNames) {\n\t\tif (className.isEmpty())\n\t\t\treturn;\n\t\tif (className.indexOf(0) == '[' || className.charAt(className.length() - 1) == ';')\n\t\t\taddType(Type.getType(className), classNames);\n\t\telse if (className.indexOf(0) == '(')\n\t\t\taddMethodType(Type.getMethodType(className), classNames);\n\t\telse\n\t\t\tclassNames.add(className);\n\t}\n\n\t/**\n\t * @return Set of all string constants listed in the constant pool.\n\t */\n\t@Nonnull\n\tdefault Set getStringConstants() {\n\t\tSortedSet strings = StringDefinitionsProperty.get(this);\n\t\tif (strings != null)\n\t\t\treturn strings;\n\n\t\tSet stringSet = new HashSet<>();\n\t\tClassReader reader = getClassReader();\n\t\tint itemCount = reader.getItemCount();\n\t\tchar[] buffer = new char[reader.getMaxStringLength()];\n\t\tfor (int i = 1; i < itemCount; i++) {\n\t\t\tint offset = reader.getItem(i);\n\t\t\tif (offset >= 10) {\n\t\t\t\tint itemTag = reader.readByte(offset - 1);\n\t\t\t\tif (itemTag == ConstantPoolConstants.STRING) {\n\t\t\t\t\tString string = reader.readUTF8(offset, buffer);\n\t\t\t\t\tstringSet.add(string);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tStringDefinitionsProperty.set(this, stringSet);\n\t\treturn stringSet;\n\t}\n\n\t@Override\n\tdefault void acceptIfJvmClass(@Nonnull Consumer action) {\n\t\taction.accept(this);\n\t}\n\n\t@Override\n\tdefault void acceptIfAndroidClass(@Nonnull Consumer action) {\n\t\t// no-op\n\t}\n\n\t@Override\n\tdefault boolean testIfJvmClass(@Nonnull Predicate predicate) {\n\t\treturn predicate.test(this);\n\t}\n\n\t@Override\n\tdefault boolean testIfAndroidClass(@Nonnull Predicate predicate) {\n\t\treturn false;\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault JvmClassInfo asJvmClass() {\n\t\treturn this;\n\t}\n\n\t@Nonnull\n\t@Override\n\tdefault AndroidClassInfo asAndroidClass() {\n\t\tthrow new IllegalStateException(\"JVM class cannot be cast to Android class\");\n\t}\n\n\t@Override\n\tdefault boolean isJvmClass() {\n\t\treturn true;\n\t}\n\n\t@Override\n\tdefault boolean isAndroidClass() {\n\t\treturn false;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/ModulesFileInfo.java",
"content": "package software.coley.recaf.info;\n\n/**\n * Outline of a JVM modules file.\n * This file is found at {@code %JAVA%/lib/modules}.\n *\n * @author Matt Coley\n */\npublic interface ModulesFileInfo extends FileInfo {\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/Named.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport net.greypanther.natsort.CaseInsensitiveSimpleNaturalComparator;\nimport software.coley.recaf.util.StringUtil;\n\nimport java.util.Comparator;\nimport java.util.Objects;\n\n/**\n * Outline of a type that can be identified by name.\n *\n * @author Matt Coley\n */\npublic interface Named {\n\t/**\n\t * Comparator for {@link String} items.\n\t * First compares case-insensitively with natural ordering, then falls back to case-sensitive comparison.\n\t */\n\tComparator STRING_COMPARATOR = (a, b) -> {\n\t\t// Fallback to natural string comparison, first case-insensitive but then case-sensitive to differentiate.\n\t\tint cmp = CaseInsensitiveSimpleNaturalComparator.getInstance().compare(a, b);\n\t\tif (cmp == 0)\n\t\t\tcmp = a.compareTo(b);\n\t\treturn cmp;\n\t};\n\n\t/**\n\t * Comparator for {@link Named} items.\n\t * First compares case-insensitively with natural ordering, then falls back to case-sensitive comparison.\n\t *\n\t * @see #STRING_COMPARATOR\n\t */\n\tComparator NAMED_COMPARATOR = (o1, o2) -> {\n\t\tString a = o1.getName();\n\t\tString b = o2.getName();\n\t\treturn STRING_COMPARATOR.compare(a, b);\n\t};\n\n\t/**\n\t * Comparator for {@link String} items whose content represent file paths.\n\t */\n\t@SuppressWarnings(\"StringEquality\")\n\tComparator STRING_PATH_COMPARATOR = (a, b) -> {\n\t\t// Get parent directory path for each item.\n\t\tString directoryPathA = StringUtil.cutOffAtLast(a, '/');\n\t\tString directoryPathB = StringUtil.cutOffAtLast(b, '/');\n\t\tif (!Objects.equals(directoryPathA, directoryPathB)) {\n\t\t\t// The directory path is the input path (same reference) if there is no '/'.\n\t\t\t// We always want root paths to be shown first since we group them in a container directory anyways.\n\t\t\tif (directoryPathA == a && directoryPathB != b)\n\t\t\t\treturn -1;\n\t\t\tif (directoryPathA != a && directoryPathB == b)\n\t\t\t\treturn 1;\n\n\t\t\t// We want subdirectories to be shown first over files in the directory.\n\t\t\t// The top-level directory being an empty string is an edge case.\n\t\t\tif (directoryPathA.isEmpty())\n\t\t\t\treturn -1;\n\t\t\telse if (directoryPathB.isEmpty())\n\t\t\t\treturn 1;\n\n\t\t\t// If both paths have the same number of separators, then we can do a normal string comparison on the directory paths.\n\t\t\t// If they have different numbers of separators, then we want to check if one is a parent of the other (or vice versa).\n\t\t\tint sectionCountA = StringUtil.count('/', directoryPathA);\n\t\t\tint sectionCountB = StringUtil.count('/', directoryPathB);\n\t\t\tif (sectionCountA == sectionCountB) {\n\t\t\t\t// Compare directories as paths.\n\t\t\t\tint cmp = STRING_COMPARATOR.compare(directoryPathA, directoryPathB);\n\t\t\t\tif (cmp != 0)\n\t\t\t\t\treturn cmp;\n\t\t\t} else {\n\t\t\t\t// Check for parent-child relationship between the directory paths. The parent directory should be shown first.\n\t\t\t\tif (directoryPathB.startsWith(directoryPathA))\n\t\t\t\t\treturn 1;\n\t\t\t\telse if (directoryPathA.startsWith(directoryPathB))\n\t\t\t\t\treturn -1;\n\t\t\t}\n\t\t}\n\n\t\treturn STRING_COMPARATOR.compare(a, b);\n\t};\n\n\t/**\n\t * Comparator for {@link Named} items whose names represent file paths.\n\t *\n\t * @see #STRING_PATH_COMPARATOR\n\t */\n\tComparator NAMED_PATH_COMPARATOR = (o1, o2) -> {\n\t\tString a = o1.getName();\n\t\tString b = o2.getName();\n\t\treturn STRING_PATH_COMPARATOR.compare(a, b);\n\t};\n\n\t/**\n\t * @return Identifying name.\n\t */\n\t@Nonnull\n\tString getName();\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/NativeLibraryFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\n\n/**\n * Outline of a native library or application file.\n *\n * @author Matt Coley\n */\npublic interface NativeLibraryFileInfo extends FileInfo {\n\t@Nonnull\n\t@Override\n\tdefault NativeLibraryFileInfo asNativeLibraryFile() {\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault boolean isNativeLibraryFile() {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/StubClassInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.annotation.Nullable;\nimport org.objectweb.asm.ClassReader;\nimport software.coley.recaf.info.annotation.AnnotationInfo;\nimport software.coley.recaf.info.annotation.TypeAnnotationInfo;\nimport software.coley.recaf.info.member.FieldMember;\nimport software.coley.recaf.info.member.MethodMember;\nimport software.coley.recaf.info.properties.Property;\nimport software.coley.recaf.util.ExcludeFromJacocoGeneratedReport;\nimport software.coley.recaf.util.JavaVersion;\n\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Map;\nimport java.util.function.Consumer;\nimport java.util.function.Predicate;\n\n/**\n * Stub implementation of {@link ClassInfo}.\n *\n * @author Matt Coley\n */\n@ExcludeFromJacocoGeneratedReport(justification = \"Stub/placeholder type\")\npublic class StubClassInfo implements ClassInfo {\n\tprivate final String name;\n\tprivate final List fields;\n\tprivate final List methods;\n\n\t/**\n\t * @param name\n\t * \t\tClass name.\n\t */\n\tpublic StubClassInfo(@Nonnull String name) {\n\t\tthis(name, Collections.emptyList(), Collections.emptyList());\n\t}\n\n\t/**\n\t * @param name\n\t * \t\tClass name.\n\t * @param fields\n\t * \t\tFields to include.\n\t * @param methods\n\t * \t\tMethods to include.\n\t */\n\tpublic StubClassInfo(@Nonnull String name,\n\t @Nonnull List fields,\n\t @Nonnull List methods) {\n\t\tthis.name = name;\n\t\tthis.fields = fields;\n\t\tthis.methods = methods;\n\t}\n\n\t@Override\n\tpublic int getAccess() {\n\t\treturn 0;\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic String getSourceFileName() {\n\t\treturn null;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getInterfaces() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic String getSuperName() {\n\t\treturn \"java/lang/Object\";\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic String getSignature() {\n\t\treturn null;\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic String getOuterClassName() {\n\t\treturn null;\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic String getOuterMethodName() {\n\t\treturn null;\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic String getOuterMethodDescriptor() {\n\t\treturn null;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getOuterClassBreadcrumbs() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getInnerClasses() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getFields() {\n\t\treturn fields;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getMethods() {\n\t\treturn methods;\n\t}\n\n\t@Override\n\tpublic void acceptIfJvmClass(@Nonnull Consumer action) {\n\t\t// no-op\n\t}\n\n\t@Override\n\tpublic void acceptIfAndroidClass(@Nonnull Consumer action) {\n\t\t// no-op\n\t}\n\n\t@Override\n\tpublic boolean testIfJvmClass(@Nonnull Predicate predicate) {\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic boolean testIfAndroidClass(@Nonnull Predicate predicate) {\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic boolean isJvmClass() {\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic boolean isAndroidClass() {\n\t\treturn false;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getName() {\n\t\treturn name;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getAnnotations() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getTypeAnnotations() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Override\n\tpublic void setProperty(Property property) {\n\t\t// no-op\n\t}\n\n\t@Override\n\tpublic void removeProperty(String key) {\n\t\t// no-op\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Map> getProperties() {\n\t\treturn Collections.emptyMap();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic JvmClassInfo asJvmClass() {\n\t\treturn new Jvm(name);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic AndroidClassInfo asAndroidClass() {\n\t\treturn new Android(name);\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null || getClass() != o.getClass()) return false;\n\n\t\tStubClassInfo that = (StubClassInfo) o;\n\n\t\treturn name.equals(that.name);\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\treturn name.hashCode();\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn name;\n\t}\n\n\tprivate static class Android extends StubClassInfo implements AndroidClassInfo {\n\t\tpublic Android(@Nonnull String name) {\n\t\t\tsuper(name);\n\t\t}\n\n\t\t@Nonnull\n\t\t@Override\n\t\tpublic AndroidClassInfo asAndroidClass() {\n\t\t\treturn this;\n\t\t}\n\t}\n\n\tprivate static class Jvm extends StubClassInfo implements JvmClassInfo {\n\t\tpublic Jvm(@Nonnull String name) {\n\t\t\tsuper(name);\n\t\t}\n\n\t\t@Nonnull\n\t\t@Override\n\t\tpublic JvmClassInfo asJvmClass() {\n\t\t\treturn this;\n\t\t}\n\n\t\t@Override\n\t\tpublic int getVersion() {\n\t\t\treturn JavaVersion.VERSION_OFFSET + JavaVersion.get();\n\t\t}\n\n\t\t@Nonnull\n\t\t@Override\n\t\tpublic byte[] getBytecode() {\n\t\t\treturn new byte[0];\n\t\t}\n\n\t\t@Nonnull\n\t\t@Override\n\t\tpublic ClassReader getClassReader() {\n\t\t\tthrow new IllegalStateException(\"Cannot read from stub class!\");\n\t\t}\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/StubFieldMember.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.annotation.Nullable;\nimport software.coley.recaf.info.member.FieldMember;\nimport software.coley.recaf.util.ExcludeFromJacocoGeneratedReport;\n\n/**\n * Stub implementation of {@link FieldMember}.\n *\n * @author Matt Coley\n */\n@ExcludeFromJacocoGeneratedReport(justification = \"Stub/placeholder type\")\npublic class StubFieldMember extends StubMember implements FieldMember {\n\t/**\n\t * @param name\n\t * \t\tField name.\n\t * @param desc\n\t * \t\tField descriptor.\n\t * @param access\n\t * \t\tField access flags.\n\t */\n\tpublic StubFieldMember(@Nonnull String name, @Nonnull String desc, int access) {\n\t\tsuper(name, desc, access);\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic Object getDefaultValue() {\n\t\treturn null;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn getDescriptor() + ' ' + getName();\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/StubFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.properties.Property;\nimport software.coley.recaf.util.ExcludeFromJacocoGeneratedReport;\nimport software.coley.recaf.util.StringUtil;\n\nimport java.nio.charset.Charset;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Collections;\nimport java.util.Map;\n\n/**\n * Stub implementation of {@link FileInfo}.\n *\n * @author Matt Coley\n */\n@ExcludeFromJacocoGeneratedReport(justification = \"Stub/placeholder type\")\npublic class StubFileInfo implements FileInfo {\n\tprivate final String name;\n\n\t/**\n\t * @param name\n\t * \t\tFile name.\n\t */\n\tpublic StubFileInfo(@Nonnull String name) {\n\t\tthis.name = name;\n\t}\n\n\t/**\n\t * @param text\n\t * \t\tText to assign.\n\t *\n\t * @return This file, with text content.\n\t */\n\t@Nonnull\n\tpublic TextFileInfo withText(@Nonnull String text) {\n\t\treturn withText(StandardCharsets.ISO_8859_1, text);\n\t}\n\n\t/**\n\t * @param charset\n\t * \t\tCharset of text.\n\t * @param text\n\t * \t\tText to assign.\n\t *\n\t * @return This file, with text content.\n\t */\n\t@Nonnull\n\tpublic TextFileInfo withText(@Nonnull Charset charset, @Nonnull String text) {\n\t\treturn new StubTextFileInfo(name, charset, text);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic byte[] getRawContent() {\n\t\treturn new byte[0];\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getName() {\n\t\treturn name;\n\t}\n\n\t@Override\n\tpublic void setProperty(Property property) {\n\t\t// no-op\n\t}\n\n\t@Override\n\tpublic void removeProperty(String key) {\n\t\t// no-op\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic Map> getProperties() {\n\t\treturn Collections.emptyMap();\n\t}\n\n\t@Override\n\tpublic boolean equals(Object o) {\n\t\tif (this == o) return true;\n\t\tif (o == null) return false;\n\t\tif (o instanceof FileInfo other) {\n\t\t\treturn name.equals(other.getName());\n\t\t}\n\t\treturn false;\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\treturn name.hashCode();\n\t}\n\n\tprivate static class StubTextFileInfo extends StubFileInfo implements TextFileInfo {\n\t\tprivate final String text;\n\t\tprivate final Charset charset;\n\n\t\t/**\n\t\t * @param name\n\t\t * \t\tFile name.\n\t\t * @param charset\n\t\t * \t\tCharset of text.\n\t\t * @param text\n\t\t * \t\tText content.\n\t\t */\n\t\tpublic StubTextFileInfo(@Nonnull String name, @Nonnull Charset charset, @Nonnull String text) {\n\t\t\tsuper(name);\n\n\t\t\tthis.text = text;\n\t\t\tthis.charset = charset;\n\t\t}\n\n\t\t@Nonnull\n\t\t@Override\n\t\tpublic String getText() {\n\t\t\treturn text;\n\t\t}\n\n\t\t@Nonnull\n\t\t@Override\n\t\tpublic String[] getTextLines() {\n\t\t\treturn StringUtil.splitNewline(text);\n\t\t}\n\n\t\t@Nonnull\n\t\t@Override\n\t\tpublic Charset getCharset() {\n\t\t\treturn charset;\n\t\t}\n\n\t\t@Override\n\t\tpublic boolean equals(Object o) {\n\t\t\tif (this == o) return true;\n\t\t\tif (o == null) return false;\n\t\t\tif (!super.equals(o)) return false;\n\t\t\tif (o instanceof TextFileInfo other) {\n\t\t\t\treturn (text.equals(other.getText()));\n\t\t\t}\n\t\t\treturn false;\n\t\t}\n\n\t\t@Override\n\t\tpublic int hashCode() {\n\t\t\tint result = super.hashCode();\n\t\t\tresult = 31 * result + text.hashCode();\n\t\t\treturn result;\n\t\t}\n\n\t\t@Override\n\t\tpublic String toString() {\n\t\t\treturn getName() + \" : <\" + text + \">\";\n\t\t}\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/StubMember.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.annotation.Nullable;\nimport software.coley.recaf.info.annotation.AnnotationInfo;\nimport software.coley.recaf.info.annotation.TypeAnnotationInfo;\nimport software.coley.recaf.info.member.ClassMember;\nimport software.coley.recaf.info.properties.Property;\nimport software.coley.recaf.util.ExcludeFromJacocoGeneratedReport;\n\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Map;\n\n/**\n * Stub implementation of {@link ClassMember}.\n *\n * @author Matt Coley\n */\n@ExcludeFromJacocoGeneratedReport(justification = \"Stub/placeholder type\")\npublic abstract class StubMember implements ClassMember {\n\tprivate final String name;\n\tprivate final String desc;\n\tprivate final int access;\n\n\t/**\n\t * @param name Member name.\n\t * @param desc Member descriptor.\n\t * @param access Member access flags.\n\t */\n\tpublic StubMember(@Nonnull String name, @Nonnull String desc, int access) {\n\t\tthis.name = name;\n\t\tthis.desc = desc;\n\t\tthis.access = access;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getName() {\n\t\treturn name;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic String getDescriptor() {\n\t\treturn desc;\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic String getSignature() {\n\t\treturn null;\n\t}\n\n\t@Override\n\tpublic int getAccess() {\n\t\treturn access;\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getAnnotations() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getTypeAnnotations() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Override\n\tpublic void setProperty(Property property) {}\n\n\t@Override\n\tpublic void removeProperty(String key) {}\n\n\t@Nonnull\n\t@Override\n\tpublic Map> getProperties() {\n\t\treturn Collections.emptyMap();\n\t}\n\n\t@Override\n\tpublic final boolean equals(Object o) {\n\t\tif (!(o instanceof StubMember that)) return false;\n\n\t\treturn access == that.access\n\t\t\t\t&& name.equals(that.name)\n\t\t\t\t&& desc.equals(that.desc);\n\t}\n\n\t@Override\n\tpublic int hashCode() {\n\t\tint result = name.hashCode();\n\t\tresult = 31 * result + desc.hashCode();\n\t\tresult = 31 * result + access;\n\t\treturn result;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/StubMethodMember.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport jakarta.annotation.Nullable;\nimport software.coley.recaf.info.annotation.AnnotationElement;\nimport software.coley.recaf.info.member.LocalVariable;\nimport software.coley.recaf.info.member.MethodMember;\nimport software.coley.recaf.util.ExcludeFromJacocoGeneratedReport;\n\nimport java.util.Collections;\nimport java.util.List;\n\n/**\n * Stub implementation of {@link MethodMember}.\n *\n * @author Matt Coley\n */\n@ExcludeFromJacocoGeneratedReport(justification = \"Stub/placeholder type\")\npublic class StubMethodMember extends StubMember implements MethodMember {\n\t/**\n\t * @param name\n\t * \t\tMethod name.\n\t * @param desc\n\t * \t\tMethod descriptor.\n\t * @param access\n\t * \t\tMethod access flags.\n\t */\n\tpublic StubMethodMember(@Nonnull String name, @Nonnull String desc, int access) {\n\t\tsuper(name, desc, access);\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getThrownTypes() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Nonnull\n\t@Override\n\tpublic List getLocalVariables() {\n\t\treturn Collections.emptyList();\n\t}\n\n\t@Nullable\n\t@Override\n\tpublic AnnotationElement getAnnotationDefault() {\n\t\treturn null;\n\t}\n\n\t@Override\n\tpublic String toString() {\n\t\treturn getName() + getDescriptor();\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/TextFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.builder.TextFileInfoBuilder;\n\nimport java.nio.charset.Charset;\n\n/**\n * Outline of a text file.\n *\n * @author Matt Coley\n */\npublic interface TextFileInfo extends FileInfo {\n\t/**\n\t * @return New builder wrapping this file information.\n\t */\n\t@Nonnull\n\tdefault TextFileInfoBuilder toTextBuilder() {\n\t\treturn new TextFileInfoBuilder(this);\n\t}\n\n\t/**\n\t * @return The {@link #getRawContent()} as text.\n\t */\n\t@Nonnull\n\tString getText();\n\n\t/**\n\t * @return The {@link #getText() text content} split into lines.\n\t */\n\t@Nonnull\n\tString[] getTextLines();\n\n\t/**\n\t * @return The charset used to encode {@link #getText() the text content}.\n\t */\n\t@Nonnull\n\tCharset getCharset();\n\n\t@Nonnull\n\t@Override\n\tdefault TextFileInfo asTextFile() {\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault boolean isTextFile() {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/VideoFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\n\n/**\n * Outline of a video file.\n *\n * @author Matt Coley\n */\npublic interface VideoFileInfo extends FileInfo {\n\t@Nonnull\n\t@Override\n\tdefault VideoFileInfo asVideoFile() {\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault boolean isVideoFile() {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/WarFileInfo.java",
"content": "package software.coley.recaf.info;\n\n/**\n * Outline of a WAR file container.\n *\n * @author Matt Coley\n */\npublic interface WarFileInfo extends ZipFileInfo {\n\t/**\n\t * WAR files prefix their class names with this.\n\t */\n\tString WAR_CLASS_PREFIX = \"WEB-INF/classes/\";\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/ZipFileInfo.java",
"content": "package software.coley.recaf.info;\n\nimport jakarta.annotation.Nonnull;\n\n/**\n * Outline of a ZIP file container.\n *\n * @author Matt Coley\n * @see JarFileInfo\n * @see WarFileInfo\n * @see JModFileInfo\n * @see ApkFileInfo\n */\npublic interface ZipFileInfo extends FileInfo {\n\t@Nonnull\n\t@Override\n\tdefault ZipFileInfo asZipFile() {\n\t\treturn this;\n\t}\n\n\t@Override\n\tdefault boolean isZipFile() {\n\t\treturn true;\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/annotation/Annotated.java",
"content": "package software.coley.recaf.info.annotation;\n\nimport jakarta.annotation.Nonnull;\nimport software.coley.recaf.info.ClassInfo;\nimport software.coley.recaf.info.member.ClassMember;\n\nimport java.util.List;\nimport java.util.stream.Stream;\n\n/**\n * Outline of an annotated class or member.\n *\n * @author Matt Coley\n * @see ClassInfo\n * @see ClassMember\n */\npublic interface Annotated {\n\t/**\n\t * @return List of declared annotations.\n\t */\n\t@Nonnull\n\tList getAnnotations();\n\n\t/**\n\t * @return List of type annotations.\n\t */\n\t@Nonnull\n\tList getTypeAnnotations();\n\n\t/**\n\t * @return Stream of declared annotations.\n\t */\n\t@Nonnull\n\tdefault Stream annotationStream() {\n\t\treturn Stream.of(this).flatMap(self -> self.getAnnotations().stream());\n\t}\n\n\t/**\n\t * @return Stream of type annotations.\n\t */\n\t@Nonnull\n\tdefault Stream typeAnnotationStream() {\n\t\treturn Stream.of(this).flatMap(self -> self.getAnnotations().stream());\n\t}\n\n\t/**\n\t * @return Stream of both normal and type anotations.\n\t */\n\t@Nonnull\n\tdefault Stream allAnnotationsStream() {\n\t\treturn Stream.concat(annotationStream(), typeAnnotationStream());\n\t}\n}\n"
},
{
"path": "recaf-core/src/main/java/software/coley/recaf/info/annotation/AnnotationArrayReference.java",
"content": "package software.coley.recaf.info.annotation;\n\nimport jakarta.annotation.Nonnull;\n\nimport java.util.List;\n\n/**\n * Outline of a potential value for {@link AnnotationElement#getElementValue()}.\n *\n * @author Matt Coley\n */\npublic interface AnnotationArrayReference {\n\t/**\n\t * @return List of values.\n\t */\n\t@Nonnull\n\tList