[ { "path": ".devcontainer/Dockerfile", "content": "# See comments in devcontainer.json for details of setting the playwright tag.\nARG PLAYWRIGHT_TAG=\"v1.51.1-jammy\"\nFROM mcr.microsoft.com/playwright:${PLAYWRIGHT_TAG}\n\nWORKDIR /app\n" }, { "path": ".devcontainer/devcontainer.json", "content": "// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:\n// https://github.com/microsoft/vscode-dev-containers/tree/v0.191.1/containers/typescript-node\n{\n \"name\": \"Node.js & Playwright\",\n \"build\": {\n \"dockerfile\": \"Dockerfile\",\n // Change to pick a different tag, see https://mcr.microsoft.com/en-us/product/playwright/tags\n //\n // IMPORTANT: The playwright image version must match @playwright/test version from package.json.\n // Otherwise it will not work, the test version will look for the browser versions which it won't\n // find on the image.\n //\n // pick '...-arm64' version if running on Apple Silicon.\n \"args\": {\n \"PLAYWRIGHT_TAG\": \"v1.51.1-jammy\"\n }\n },\n // Add the IDs of extensions you want installed when the container is created.\n \"customizations\": {\n \"vscode\": {\n \"extensions\": [\"dbaeumer.vscode-eslint\"]\n }\n },\n // Use 'forwardPorts' to make a list of ports inside the container available locally.\n \"forwardPorts\": [9000],\n // Use 'postCreateCommand' to run commands after the container is created.\n \"postCreateCommand\": \"yarn install && yarn build\"\n}\n" }, { "path": ".eslintignore", "content": "dist/\nnode_modules/\n" }, { "path": ".eslintrc.js", "content": "module.exports = {\n env: {\n browser: true,\n es2021: true\n },\n extends: [\"eslint:recommended\"],\n overrides: [\n {\n env: {\n node: true\n },\n files: [\".eslintrc.{js,cjs}\"],\n parserOptions: {\n sourceType: \"script\"\n }\n }\n ],\n parserOptions: {\n ecmaVersion: \"latest\",\n sourceType: \"module\"\n },\n rules: {\n \"comma-dangle\": \"error\",\n \"curly\": [\"error\", \"multi-line\"],\n \"getter-return\": \"off\",\n \"no-console\": \"off\",\n \"no-duplicate-imports\": [\"error\"],\n \"no-multi-spaces\": [\"error\", { \"exceptions\": { \"VariableDeclarator\": true }}],\n \"no-multiple-empty-lines\": [\"error\", { \"max\": 2 }],\n \"no-self-assign\": [\"error\", { \"props\": false }],\n \"no-trailing-spaces\": [\"error\"],\n \"no-unused-vars\": [\"error\", { argsIgnorePattern: \"_*\" }],\n \"no-useless-escape\": \"off\",\n \"no-var\": [\"error\"],\n \"prefer-const\": [\"error\"],\n \"semi\": [\"error\", \"never\"]\n },\n globals: {\n test: true,\n setup: true\n }\n}\n" }, { "path": ".github/scripts/publish-dev-build", "content": "#!/usr/bin/env bash\nset -eux\n\nDEV_BUILD_REPO_NAME=\"hotwired/dev-builds\"\nDEV_BUILD_ORIGIN_URL=\"https://${1}@github.com/${DEV_BUILD_REPO_NAME}.git\"\nBUILD_PATH=\"$HOME/publish-dev-build\"\n\nmkdir \"$BUILD_PATH\"\n\ncd \"$GITHUB_WORKSPACE\"\npackage_name=\"$(jq -r .name package.json)\"\npackage_files=( dist package.json )\ntag=\"${package_name}/${GITHUB_SHA:0:7}\"\n\nname=\"$(git log -n 1 --format=format:%cn)\"\nemail=\"$(git log -n 1 --format=format:%ce)\"\nsubject=\"$(git log -n 1 --format=format:%s)\"\ndate=\"$(git log -n 1 --format=format:%ai)\"\nurl=\"https://github.com/${GITHUB_REPOSITORY}/tree/${GITHUB_SHA}\"\nmessage=\"$tag $subject\"$'\\n\\n'\"$url\"\n\ncp -R \"${package_files[@]}\" \"$BUILD_PATH\"\n\ncd \"$BUILD_PATH\"\ngit init .\ngit remote add origin \"$DEV_BUILD_ORIGIN_URL\"\ngit symbolic-ref HEAD refs/heads/publish-dev-build\ngit add \"${package_files[@]}\"\n\nGIT_AUTHOR_DATE=\"$date\" GIT_COMMITTER_DATE=\"$date\" \\\nGIT_AUTHOR_NAME=\"$name\" GIT_COMMITTER_NAME=\"$name\" \\\nGIT_AUTHOR_EMAIL=\"$email\" GIT_COMMITTER_EMAIL=\"$email\" \\\n git commit -m \"$message\"\n\ngit tag \"$tag\"\n[ \"$GITHUB_REF\" != \"refs/heads/main\" ] || git tag -f \"${package_name}/latest\"\ngit push -f --tags\n\necho done\n" }, { "path": ".github/workflows/ci.yml", "content": "name: CI\n\non: [push, pull_request]\n\njobs:\n build:\n\n runs-on: ubuntu-22.04\n\n steps:\n - uses: actions/checkout@v3\n - uses: actions/setup-node@v3\n with:\n node-version: '22'\n cache: 'yarn'\n - run: yarn install --frozen-lockfile\n - run: yarn run playwright install --with-deps\n - run: yarn build\n\n - name: Set Chrome Version\n run: |\n CHROMEVER=\"$(chromedriver --version | cut -d' ' -f2)\"\n echo \"Actions ChromeDriver is $CHROMEVER\"\n echo \"CHROMEVER=${CHROMEVER}\" >> $GITHUB_ENV\n\n - name: Lint\n run: yarn lint\n\n - name: Unit Test\n run: yarn test:unit\n\n - name: Chrome Test\n run: yarn test:browser --project=chrome\n\n - name: Firefox Test\n run: yarn test:browser --project=firefox\n\n - uses: actions/upload-artifact@v4\n with:\n name: turbo-dist\n path: dist/*\n" }, { "path": ".github/workflows/dev-builds.yml", "content": "name: dev-builds\n\non:\n workflow_dispatch:\n push:\n branches:\n - main\n - 'builds/**'\n\njobs:\n build:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - uses: actions/setup-node@v3\n with:\n node-version: '22'\n cache: 'yarn'\n\n - run: yarn install --frozen-lockfile\n - run: yarn build\n\n - name: Publish dev build\n run: .github/scripts/publish-dev-build '${{ secrets.DEV_BUILD_GITHUB_TOKEN }}'\n" }, { "path": ".gitignore", "content": "/dist\n/node_modules\n/test-results\n*.log\npackage-lock.json\n" }, { "path": ".prettierignore", "content": "dist/\nnode_modules/\n" }, { "path": ".prettierrc.json", "content": "{\n \"singleQuote\": false,\n \"printWidth\": 120,\n \"semi\": false,\n \"trailingComma\" : \"none\"\n}\n" }, { "path": ".vscode/launch.json", "content": "{\n // Use IntelliSense to learn about possible attributes.\n // Hover to view descriptions of existing attributes.\n // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387\n \"version\": \"0.2.0\",\n \"configurations\": [\n {\n \"type\": \"node\",\n \"request\": \"launch\",\n \"name\": \"Turbo: Debug browser tests\",\n \"cwd\": \"${workspaceFolder}\",\n \"port\": 9229,\n \"outputCapture\": \"std\",\n \"internalConsoleOptions\": \"openOnSessionStart\",\n \"runtimeExecutable\": \"yarn\",\n \"runtimeArgs\": [\"test\"]\n }\n ]\n}\n" }, { "path": ".vscode/tasks.json", "content": "{\n // See https://go.microsoft.com/fwlink/?LinkId=733558\n // for the documentation about the tasks.json format\n \"version\": \"2.0.0\",\n \"tasks\": [\n {\n \"label\": \"Turbo: Build dist directory\",\n \"type\": \"shell\",\n \"command\": \"yarn build\",\n \"group\": {\n \"kind\": \"build\",\n \"isDefault\": true\n }\n },\n {\n \"label\": \"Turbo: Run tests\",\n \"type\": \"shell\",\n \"dependsOn\": \"Turbo: Build dist directory\",\n \"command\": \"yarn test\",\n \"group\": {\n \"kind\": \"test\",\n \"isDefault\": true\n }\n },\n {\n \"label\": \"Turbo: Start dev server\",\n \"type\": \"shell\",\n \"dependsOn\": \"Turbo: Build dist directory\",\n \"command\": \"yarn start\",\n \"problemMatcher\": []\n }\n ]\n}\n" }, { "path": "CHANGELOG.md", "content": "# Changelog\n\nPlease see [our GitHub \"Releases\" page](https://github.com/hotwired/turbo/releases).\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as\ncontributors and maintainers pledge to making participation in our project and\nour community a harassment-free experience for everyone, regardless of age, body\nsize, disability, ethnicity, gender identity and expression, level of experience,\nnationality, personal appearance, race, religion, or sexual identity and\norientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment\ninclude:\n\n* Using welcoming and inclusive language\n* Being respectful of differing viewpoints and experiences\n* Gracefully accepting constructive criticism\n* Focusing on what is best for the community\n* Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n* The use of sexualized language or imagery and unwelcome sexual attention or\nadvances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or electronic\n address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable\nbehavior and are expected to take appropriate and fair corrective action in\nresponse to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or\nreject comments, commits, code, wiki edits, issues, and other contributions\nthat are not aligned to this Code of Conduct, or to ban temporarily or\npermanently any contributor for other behaviors that they deem inappropriate,\nthreatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces\nwhen an individual is representing the project or its community. Examples of\nrepresenting a project or community include using an official project e-mail\naddress, posting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event. Representation of a project may be\nfurther defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported by contacting one of the project maintainers listed below. All\ncomplaints will be reviewed and investigated and will result in a response that\nis deemed necessary and appropriate to the circumstances. The project team is\nobligated to maintain confidentiality with regard to the reporter of an incident.\nFurther details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good\nfaith may face temporary or permanent repercussions as determined by other\nmembers of the project's leadership.\n\n## Project Maintainers\n\n* Sam Stephenson <>\n* Javan Makhmali <>\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,\navailable at [http://contributor-covenant.org/version/1/4][version]\n\n[homepage]: http://contributor-covenant.org\n[version]: http://contributor-covenant.org/version/1/4/\n" }, { "path": "CONTRIBUTING.md", "content": "[![Version](https://img.shields.io/npm/v/@hotwired/turbo)](https://www.npmjs.com/package/@hotwired/turbo)\n[![License](https://img.shields.io/github/license/hotwired/turbo)](https://github.com/hotwired/turbo)\n\n# Contributing\n\nNote that we have a [code of conduct](https://github.com/hotwired/turbo/blob/main/CODE_OF_CONDUCT.md). Please follow it in your interactions with this project.\n\n## Sending a Pull Request\n\nThe core team is monitoring for pull requests. We will review your pull request and either merge it, request changes to it, or close it with an explanation.\n\nBefore submitting a pull request, please:\n\n1. Fork the repository and create your branch.\n2. Follow the setup instructions in this file.\n3. If you’re fixing a bug or adding code that should be tested, add tests!\n4. Ensure the test suite passes.\n\n## Developing locally\n\nFirst, clone the `hotwired/turbo` repository and install dependencies:\n\n```bash\ngit clone https://github.com/hotwired/turbo.git\n```\n\n```bash\ncd turbo\nyarn install\n```\n\nThen create a branch for your changes:\n\n```bash\ngit checkout -b \n```\n\n### Testing\n\nTests are run through `yarn` using [Web Test Runner](https://modern-web.dev/docs/test-runner/overview/) with [Playwright](https://github.com/microsoft/playwright) for browser testing. Browser and runtime configuration can be found in [`web-test-runner.config.mjs`](./web-test-runner.config.mjs) and [`playwright.config.js`](./playwright.config.js).\n\nTo begin testing, install the browser drivers:\n\n```bash\nyarn playwright install --with-deps\n```\n\nThen build the source. Because tests are run against the compiled source (and are themselves compiled) be sure to run `yarn build` prior to testing. Alternatively, you can run `yarn watch` to build and watch for changes.\n\n```bash\nyarn build\n```\n\n### Running the test suite\n\nThe test suite can be run with `yarn`, using the test commands defined in [`package.json`](./package.json). To run all tests in all configured browsers:\n\n```bash\nyarn test\n```\n\nTo run just the unit or browser tests:\n\n```bash\nyarn test:unit\nyarn test:browser\n```\n\nBy default, tests are run in \"headless\" mode against all configured browsers (currently `chrome` and `firefox`). Use the `--headed` flag to run in normal mode. Use the `--project` flag to run against a particular browser.\n\n```bash\nyarn test:browser --project=firefox\nyarn test:browser --project=chrome\nyarn test:browser --project=chrome --headed\n```\n\n### Running a single test\n\nTo run a single test file, pass its path as an argument. To run a particular test case, append its starting line number after a colon.\n\n```bash\nyarn test:browser src/tests/functional/drive_tests.js\nyarn test:browser src/tests/functional/drive_tests.js:11\nyarn test:browser src/tests/functional/drive_tests.js:11 --project=chrome\n```\n\n### Running the local web server\n\nBecause tests are running headless in browsers, debugging can be difficult. Sometimes the simplest thing to do is load the test fixtures into the browser and navigate manually. To make this easier, a local web server is included.\n\nTo run the web server, ensure the source is built and start the server with `yarn`:\n\n```bash\nyarn build\nyarn start\n```\n\nThe web server is available on port 9000, serving from the project root. Fixture files are accessible by path. For example, the file at `src/tests/fixtures/rendering.html` will be accessible at .\n" }, { "path": "MIT-LICENSE", "content": "Copyright (c) 37signals\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n\"Software\"), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\nLIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\nWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "README.md", "content": "# Turbo\n\nTurbo uses complementary techniques to dramatically reduce the amount of custom JavaScript that most web applications will need to write:\n\n* Turbo Drive accelerates links and form submissions by negating the need for full page reloads.\n* Turbo Frames decompose pages into independent contexts, which scope navigation and can be lazily loaded.\n* Turbo Streams deliver page changes over WebSocket or in response to form submissions using just HTML and a set of CRUD-like actions.\n* Turbo Native lets your majestic monolith form the center of your native iOS and Android apps, with seamless transitions between web and native sections.\n\nIt's all done by sending HTML over the wire. And for those instances when that's not enough, you can reach for the other side of Hotwire, and finish the job with [Stimulus](https://github.com/hotwired/stimulus).\n\nRead more on [turbo.hotwired.dev](https://turbo.hotwired.dev).\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n© 2026 37signals LLC.\n" }, { "path": "package.json", "content": "{\n \"name\": \"@hotwired/turbo\",\n \"version\": \"8.0.23\",\n \"description\": \"The speed of a single-page web application without having to write any JavaScript\",\n \"module\": \"dist/turbo.es2017-esm.js\",\n \"main\": \"dist/turbo.es2017-umd.js\",\n \"files\": [\n \"dist/*.js\",\n \"dist/*.js.map\"\n ],\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/hotwired/turbo.git\"\n },\n \"keywords\": [\n \"hotwire\",\n \"turbo\",\n \"browser\",\n \"pushstate\"\n ],\n \"author\": \"37signals LLC\",\n \"contributors\": [\n \"Jeffrey Hardy \",\n \"Javan Makhmali \",\n \"Sam Stephenson \"\n ],\n \"license\": \"MIT\",\n \"bugs\": {\n \"url\": \"https://github.com/hotwired/turbo/issues\"\n },\n \"homepage\": \"https://turbo.hotwired.dev\",\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"devDependencies\": {\n \"@open-wc/testing\": \"^3.1.7\",\n \"@playwright/test\": \"~1.51.1\",\n \"@rollup/plugin-node-resolve\": \"13.1.3\",\n \"@web/dev-server-esbuild\": \"^0.3.3\",\n \"@web/test-runner\": \"^0.15.0\",\n \"@web/test-runner-playwright\": \"^0.9.0\",\n \"arg\": \"^5.0.1\",\n \"body-parser\": \"^1.20.1\",\n \"eslint\": \"^8.13.0\",\n \"express\": \"^4.18.2\",\n \"idiomorph\": \"~0.7.4\",\n \"multer\": \"^2.0.2\",\n \"rollup\": \"^2.35.1\"\n },\n \"scripts\": {\n \"clean\": \"rm -fr dist\",\n \"clean:win\": \"rmdir /s /q dist\",\n \"build\": \"yarn install && rollup -c\",\n \"build:win\": \"yarn install && rollup -c\",\n \"watch\": \"rollup -wc\",\n \"start\": \"node src/tests/server.mjs\",\n \"test\": \"yarn test:unit && yarn test:browser\",\n \"test:browser\": \"playwright test\",\n \"test:unit\": \"NODE_OPTIONS=--inspect web-test-runner\",\n \"test:unit:win\": \"SET NODE_OPTIONS=--inspect & web-test-runner\",\n \"release\": \"yarn build && yarn publish\",\n \"lint\": \"eslint . --ext .js\"\n },\n \"engines\": {\n \"node\": \">= 18\"\n }\n}\n" }, { "path": "playwright.config.js", "content": "import { devices } from \"@playwright/test\"\n\nconst config = {\n projects: [\n {\n name: \"chrome\",\n use: {\n ...devices[\"Desktop Chrome\"],\n contextOptions: {\n timeout: 10000\n },\n hasTouch: true\n }\n },\n {\n name: \"firefox\",\n use: {\n ...devices[\"Desktop Firefox\"],\n contextOptions: {\n timeout: 10000\n },\n hasTouch: true\n }\n }\n ],\n timeout: 10000,\n browserStartTimeout: 10000,\n retries: 2,\n testDir: \"./src/tests/\",\n testMatch: /(functional|integration)\\/.*_tests\\.js/,\n webServer: {\n command: \"yarn start\",\n url: \"http://localhost:9000/src/tests/fixtures/test.js\",\n timeout: 10000,\n // eslint-disable-next-line no-undef\n reuseExistingServer: !process.env.CI\n },\n use: {\n baseURL: \"http://localhost:9000/\"\n }\n}\n\nexport default config\n" }, { "path": "rollup.config.js", "content": "import resolve from \"@rollup/plugin-node-resolve\"\n\nimport { version } from \"./package.json\"\nconst year = new Date().getFullYear()\nconst banner = `/*!\\nTurbo ${version}\\nCopyright © ${year} 37signals LLC\\n */`\n\nexport default [\n {\n input: \"src/index.js\",\n output: [\n {\n name: \"Turbo\",\n file: \"dist/turbo.es2017-umd.js\",\n format: \"umd\",\n banner\n },\n {\n file: \"dist/turbo.es2017-esm.js\",\n format: \"esm\",\n banner\n }\n ],\n plugins: [resolve()],\n watch: {\n include: \"src/**\"\n }\n }\n]\n" }, { "path": "src/core/bardo.js", "content": "export class Bardo {\n static async preservingPermanentElements(delegate, permanentElementMap, callback) {\n const bardo = new this(delegate, permanentElementMap)\n bardo.enter()\n await callback()\n bardo.leave()\n }\n\n constructor(delegate, permanentElementMap) {\n this.delegate = delegate\n this.permanentElementMap = permanentElementMap\n }\n\n enter() {\n for (const id in this.permanentElementMap) {\n const [currentPermanentElement, newPermanentElement] = this.permanentElementMap[id]\n this.delegate.enteringBardo(currentPermanentElement, newPermanentElement)\n this.replaceNewPermanentElementWithPlaceholder(newPermanentElement)\n }\n }\n\n leave() {\n for (const id in this.permanentElementMap) {\n const [currentPermanentElement] = this.permanentElementMap[id]\n this.replaceCurrentPermanentElementWithClone(currentPermanentElement)\n this.replacePlaceholderWithPermanentElement(currentPermanentElement)\n this.delegate.leavingBardo(currentPermanentElement)\n }\n }\n\n replaceNewPermanentElementWithPlaceholder(permanentElement) {\n const placeholder = createPlaceholderForPermanentElement(permanentElement)\n permanentElement.replaceWith(placeholder)\n }\n\n replaceCurrentPermanentElementWithClone(permanentElement) {\n const clone = permanentElement.cloneNode(true)\n permanentElement.replaceWith(clone)\n }\n\n replacePlaceholderWithPermanentElement(permanentElement) {\n const placeholder = this.getPlaceholderById(permanentElement.id)\n placeholder?.replaceWith(permanentElement)\n }\n\n getPlaceholderById(id) {\n return this.placeholders.find((element) => element.content == id)\n }\n\n get placeholders() {\n return [...document.querySelectorAll(\"meta[name=turbo-permanent-placeholder][content]\")]\n }\n}\n\nfunction createPlaceholderForPermanentElement(permanentElement) {\n const element = document.createElement(\"meta\")\n element.setAttribute(\"name\", \"turbo-permanent-placeholder\")\n element.setAttribute(\"content\", permanentElement.id)\n return element\n}\n" }, { "path": "src/core/cache.js", "content": "import { setMetaContent } from \"../util\"\n\nexport class Cache {\n constructor(session) {\n this.session = session\n }\n\n clear() {\n this.session.clearCache()\n }\n\n resetCacheControl() {\n this.#setCacheControl(\"\")\n }\n\n exemptPageFromCache() {\n this.#setCacheControl(\"no-cache\")\n }\n\n exemptPageFromPreview() {\n this.#setCacheControl(\"no-preview\")\n }\n\n #setCacheControl(value) {\n setMetaContent(\"turbo-cache-control\", value)\n }\n}\n" }, { "path": "src/core/config/drive.js", "content": "export const drive = {\n enabled: true,\n progressBarDelay: 500,\n unvisitableExtensions: new Set(\n [\n \".7z\", \".aac\", \".apk\", \".avi\", \".bmp\", \".bz2\", \".css\", \".csv\", \".deb\", \".dmg\", \".doc\",\n \".docx\", \".exe\", \".gif\", \".gz\", \".heic\", \".heif\", \".ico\", \".iso\", \".jpeg\", \".jpg\",\n \".js\", \".json\", \".m4a\", \".mkv\", \".mov\", \".mp3\", \".mp4\", \".mpeg\", \".mpg\", \".msi\",\n \".ogg\", \".ogv\", \".pdf\", \".pkg\", \".png\", \".ppt\", \".pptx\", \".rar\", \".rtf\",\n \".svg\", \".tar\", \".tif\", \".tiff\", \".txt\", \".wav\", \".webm\", \".webp\", \".wma\", \".wmv\",\n \".xls\", \".xlsx\", \".xml\", \".zip\"\n ]\n )\n}\n" }, { "path": "src/core/config/forms.js", "content": "import { cancelEvent } from \"../../util\"\n\nconst submitter = {\n \"aria-disabled\": {\n beforeSubmit: submitter => {\n submitter.setAttribute(\"aria-disabled\", \"true\")\n submitter.addEventListener(\"click\", cancelEvent)\n },\n\n afterSubmit: submitter => {\n submitter.removeAttribute(\"aria-disabled\")\n submitter.removeEventListener(\"click\", cancelEvent)\n }\n },\n\n \"disabled\": {\n beforeSubmit: submitter => submitter.disabled = true,\n afterSubmit: submitter => submitter.disabled = false\n }\n}\n\nclass Config {\n #submitter = null\n\n constructor(config) {\n Object.assign(this, config)\n }\n\n get submitter() {\n return this.#submitter\n }\n\n set submitter(value) {\n this.#submitter = submitter[value] || value\n }\n}\n\nexport const forms = new Config({\n mode: \"on\",\n submitter: \"disabled\"\n})\n" }, { "path": "src/core/config/index.js", "content": "import { drive } from \"./drive\"\nimport { forms } from \"./forms\"\n\nexport const config = {\n drive,\n forms\n}\n" }, { "path": "src/core/drive/error_renderer.js", "content": "import { activateScriptElement } from \"../../util\"\nimport { Renderer } from \"../renderer\"\n\nexport class ErrorRenderer extends Renderer {\n static renderElement(currentElement, newElement) {\n const { documentElement, body } = document\n\n documentElement.replaceChild(newElement, body)\n }\n\n async render() {\n this.replaceHeadAndBody()\n this.activateScriptElements()\n }\n\n replaceHeadAndBody() {\n const { documentElement, head } = document\n documentElement.replaceChild(this.newHead, head)\n this.renderElement(this.currentElement, this.newElement)\n }\n\n activateScriptElements() {\n for (const replaceableElement of this.scriptElements) {\n const parentNode = replaceableElement.parentNode\n if (parentNode) {\n const element = activateScriptElement(replaceableElement)\n parentNode.replaceChild(element, replaceableElement)\n }\n }\n }\n\n get newHead() {\n return this.newSnapshot.headSnapshot.element\n }\n\n get scriptElements() {\n return document.documentElement.querySelectorAll(\"script\")\n }\n}\n" }, { "path": "src/core/drive/form_submission.js", "content": "import { FetchRequest, FetchMethod, fetchMethodFromString, fetchEnctypeFromString, isSafe } from \"../../http/fetch_request\"\nimport { expandURL } from \"../url\"\nimport { clearBusyState, dispatch, getAttribute, getMetaContent, hasAttribute, markAsBusy } from \"../../util\"\nimport { StreamMessage } from \"../streams/stream_message\"\nimport { prefetchCache } from \"./prefetch_cache\"\nimport { config } from \"../config\"\n\nexport const FormSubmissionState = {\n initialized: \"initialized\",\n requesting: \"requesting\",\n waiting: \"waiting\",\n receiving: \"receiving\",\n stopping: \"stopping\",\n stopped: \"stopped\"\n}\n\nexport const FormEnctype = {\n urlEncoded: \"application/x-www-form-urlencoded\",\n multipart: \"multipart/form-data\",\n plain: \"text/plain\"\n}\n\nexport class FormSubmission {\n state = FormSubmissionState.initialized\n\n static confirmMethod(message) {\n return Promise.resolve(confirm(message))\n }\n\n constructor(delegate, formElement, submitter, mustRedirect = false) {\n const method = getMethod(formElement, submitter)\n const action = getAction(getFormAction(formElement, submitter), method)\n const body = buildFormData(formElement, submitter)\n const enctype = getEnctype(formElement, submitter)\n\n this.delegate = delegate\n this.formElement = formElement\n this.submitter = submitter\n this.fetchRequest = new FetchRequest(this, method, action, body, formElement, enctype)\n this.mustRedirect = mustRedirect\n }\n\n get method() {\n return this.fetchRequest.method\n }\n\n set method(value) {\n this.fetchRequest.method = value\n }\n\n get action() {\n return this.fetchRequest.url.toString()\n }\n\n set action(value) {\n this.fetchRequest.url = expandURL(value)\n }\n\n get body() {\n return this.fetchRequest.body\n }\n\n get enctype() {\n return this.fetchRequest.enctype\n }\n\n get isSafe() {\n return this.fetchRequest.isSafe\n }\n\n get location() {\n return this.fetchRequest.url\n }\n\n // The submission process\n\n async start() {\n const { initialized, requesting } = FormSubmissionState\n const confirmationMessage = getAttribute(\"data-turbo-confirm\", this.submitter, this.formElement)\n\n if (typeof confirmationMessage === \"string\") {\n const confirmMethod = typeof config.forms.confirm === \"function\" ?\n config.forms.confirm :\n FormSubmission.confirmMethod\n\n const answer = await confirmMethod(confirmationMessage, this.formElement, this.submitter)\n if (!answer) {\n return\n }\n }\n\n if (this.state == initialized) {\n this.state = requesting\n return this.fetchRequest.perform()\n }\n }\n\n stop() {\n const { stopping, stopped } = FormSubmissionState\n if (this.state != stopping && this.state != stopped) {\n this.state = stopping\n this.fetchRequest.cancel()\n return true\n }\n }\n\n // Fetch request delegate\n\n prepareRequest(request) {\n if (!request.isSafe) {\n const token = getCookieValue(getMetaContent(\"csrf-param\")) || getMetaContent(\"csrf-token\")\n if (token) {\n request.headers[\"X-CSRF-Token\"] = token\n }\n }\n\n if (this.requestAcceptsTurboStreamResponse(request)) {\n request.acceptResponseType(StreamMessage.contentType)\n }\n }\n\n requestStarted(_request) {\n this.state = FormSubmissionState.waiting\n if (this.submitter) config.forms.submitter.beforeSubmit(this.submitter)\n this.setSubmitsWith()\n markAsBusy(this.formElement)\n dispatch(\"turbo:submit-start\", {\n target: this.formElement,\n detail: { formSubmission: this }\n })\n this.delegate.formSubmissionStarted(this)\n }\n\n requestPreventedHandlingResponse(request, response) {\n prefetchCache.clear()\n\n this.result = { success: response.succeeded, fetchResponse: response }\n }\n\n requestSucceededWithResponse(request, response) {\n if (response.clientError || response.serverError) {\n this.delegate.formSubmissionFailedWithResponse(this, response)\n return\n }\n\n prefetchCache.clear()\n\n if (this.requestMustRedirect(request) && responseSucceededWithoutRedirect(response)) {\n const error = new Error(\"Form responses must redirect to another location\")\n this.delegate.formSubmissionErrored(this, error)\n } else {\n this.state = FormSubmissionState.receiving\n this.result = { success: true, fetchResponse: response }\n this.delegate.formSubmissionSucceededWithResponse(this, response)\n }\n }\n\n requestFailedWithResponse(request, response) {\n this.result = { success: false, fetchResponse: response }\n this.delegate.formSubmissionFailedWithResponse(this, response)\n }\n\n requestErrored(request, error) {\n this.result = { success: false, error }\n this.delegate.formSubmissionErrored(this, error)\n }\n\n requestFinished(_request) {\n this.state = FormSubmissionState.stopped\n if (this.submitter) config.forms.submitter.afterSubmit(this.submitter)\n this.resetSubmitterText()\n clearBusyState(this.formElement)\n dispatch(\"turbo:submit-end\", {\n target: this.formElement,\n detail: { formSubmission: this, ...this.result }\n })\n this.delegate.formSubmissionFinished(this)\n }\n\n // Private\n\n setSubmitsWith() {\n if (!this.submitter || !this.submitsWith) return\n\n if (this.submitter.matches(\"button\")) {\n this.originalSubmitText = this.submitter.innerHTML\n this.submitter.innerHTML = this.submitsWith\n } else if (this.submitter.matches(\"input\")) {\n const input = this.submitter\n this.originalSubmitText = input.value\n input.value = this.submitsWith\n }\n }\n\n resetSubmitterText() {\n if (!this.submitter || !this.originalSubmitText) return\n\n if (this.submitter.matches(\"button\")) {\n this.submitter.innerHTML = this.originalSubmitText\n } else if (this.submitter.matches(\"input\")) {\n const input = this.submitter\n input.value = this.originalSubmitText\n }\n }\n\n requestMustRedirect(request) {\n return !request.isSafe && this.mustRedirect\n }\n\n requestAcceptsTurboStreamResponse(request) {\n return !request.isSafe || hasAttribute(\"data-turbo-stream\", this.submitter, this.formElement)\n }\n\n get submitsWith() {\n return this.submitter?.getAttribute(\"data-turbo-submits-with\")\n }\n}\n\nfunction buildFormData(formElement, submitter) {\n const formData = new FormData(formElement)\n const name = submitter?.getAttribute(\"name\")\n const value = submitter?.getAttribute(\"value\")\n\n if (name) {\n formData.append(name, value || \"\")\n }\n\n return formData\n}\n\nfunction getCookieValue(cookieName) {\n if (cookieName != null) {\n const cookies = document.cookie ? document.cookie.split(\"; \") : []\n const cookie = cookies.find((cookie) => cookie.startsWith(cookieName))\n if (cookie) {\n const value = cookie.split(\"=\").slice(1).join(\"=\")\n return value ? decodeURIComponent(value) : undefined\n }\n }\n}\n\nfunction responseSucceededWithoutRedirect(response) {\n return response.statusCode == 200 && !response.redirected\n}\n\nfunction getFormAction(formElement, submitter) {\n const formElementAction = typeof formElement.action === \"string\" ? formElement.action : null\n\n if (submitter?.hasAttribute(\"formaction\")) {\n return submitter.getAttribute(\"formaction\") || \"\"\n } else {\n return formElement.getAttribute(\"action\") || formElementAction || \"\"\n }\n}\n\nfunction getAction(formAction, fetchMethod) {\n const action = expandURL(formAction)\n\n if (isSafe(fetchMethod)) {\n action.search = \"\"\n }\n\n return action\n}\n\nfunction getMethod(formElement, submitter) {\n const method = submitter?.getAttribute(\"formmethod\") || formElement.getAttribute(\"method\") || \"\"\n return fetchMethodFromString(method.toLowerCase()) || FetchMethod.get\n}\n\nfunction getEnctype(formElement, submitter) {\n return fetchEnctypeFromString(submitter?.getAttribute(\"formenctype\") || formElement.enctype)\n}\n" }, { "path": "src/core/drive/head_snapshot.js", "content": "import { elementIsStylesheet } from \"../../util\"\nimport { Snapshot } from \"../snapshot\"\n\nexport class HeadSnapshot extends Snapshot {\n detailsByOuterHTML = this.children\n .filter((element) => !elementIsNoscript(element))\n .map((element) => elementWithoutNonce(element))\n .reduce((result, element) => {\n const { outerHTML } = element\n const details =\n outerHTML in result\n ? result[outerHTML]\n : {\n type: elementType(element),\n tracked: elementIsTracked(element),\n elements: []\n }\n return {\n ...result,\n [outerHTML]: {\n ...details,\n elements: [...details.elements, element]\n }\n }\n }, {})\n\n get trackedElementSignature() {\n return Object.keys(this.detailsByOuterHTML)\n .filter((outerHTML) => this.detailsByOuterHTML[outerHTML].tracked)\n .join(\"\")\n }\n\n getScriptElementsNotInSnapshot(snapshot) {\n return this.getElementsMatchingTypeNotInSnapshot(\"script\", snapshot)\n }\n\n getStylesheetElementsNotInSnapshot(snapshot) {\n return this.getElementsMatchingTypeNotInSnapshot(\"stylesheet\", snapshot)\n }\n\n getElementsMatchingTypeNotInSnapshot(matchedType, snapshot) {\n return Object.keys(this.detailsByOuterHTML)\n .filter((outerHTML) => !(outerHTML in snapshot.detailsByOuterHTML))\n .map((outerHTML) => this.detailsByOuterHTML[outerHTML])\n .filter(({ type }) => type == matchedType)\n .map(({ elements: [element] }) => element)\n }\n\n get provisionalElements() {\n return Object.keys(this.detailsByOuterHTML).reduce((result, outerHTML) => {\n const { type, tracked, elements } = this.detailsByOuterHTML[outerHTML]\n if (type == null && !tracked) {\n return [...result, ...elements]\n } else if (elements.length > 1) {\n return [...result, ...elements.slice(1)]\n } else {\n return result\n }\n }, [])\n }\n\n getMetaValue(name) {\n const element = this.findMetaElementByName(name)\n return element ? element.getAttribute(\"content\") : null\n }\n\n findMetaElementByName(name) {\n return Object.keys(this.detailsByOuterHTML).reduce((result, outerHTML) => {\n const {\n elements: [element]\n } = this.detailsByOuterHTML[outerHTML]\n return elementIsMetaElementWithName(element, name) ? element : result\n }, undefined | undefined)\n }\n}\n\nfunction elementType(element) {\n if (elementIsScript(element)) {\n return \"script\"\n } else if (elementIsStylesheet(element)) {\n return \"stylesheet\"\n }\n}\n\nfunction elementIsTracked(element) {\n return element.getAttribute(\"data-turbo-track\") == \"reload\"\n}\n\nfunction elementIsScript(element) {\n const tagName = element.localName\n return tagName == \"script\"\n}\n\nfunction elementIsNoscript(element) {\n const tagName = element.localName\n return tagName == \"noscript\"\n}\n\nfunction elementIsMetaElementWithName(element, name) {\n const tagName = element.localName\n return tagName == \"meta\" && element.getAttribute(\"name\") == name\n}\n\nfunction elementWithoutNonce(element) {\n if (element.hasAttribute(\"nonce\")) {\n element.setAttribute(\"nonce\", \"\")\n }\n\n return element\n}\n" }, { "path": "src/core/drive/history.js", "content": "import { uuid } from \"../../util\"\n\nexport class History {\n location\n restorationIdentifier = uuid()\n restorationData = {}\n started = false\n currentIndex = 0\n\n constructor(delegate) {\n this.delegate = delegate\n }\n\n start() {\n if (!this.started) {\n addEventListener(\"popstate\", this.onPopState, false)\n this.currentIndex = history.state?.turbo?.restorationIndex || 0\n this.started = true\n this.replace(new URL(window.location.href))\n }\n }\n\n stop() {\n if (this.started) {\n removeEventListener(\"popstate\", this.onPopState, false)\n this.started = false\n }\n }\n\n push(location, restorationIdentifier) {\n this.update(history.pushState, location, restorationIdentifier)\n }\n\n replace(location, restorationIdentifier) {\n this.update(history.replaceState, location, restorationIdentifier)\n }\n\n update(method, location, restorationIdentifier = uuid()) {\n if (method === history.pushState) ++this.currentIndex\n\n const state = { turbo: { restorationIdentifier, restorationIndex: this.currentIndex } }\n method.call(history, state, \"\", location.href)\n this.location = location\n this.restorationIdentifier = restorationIdentifier\n }\n\n // Restoration data\n\n getRestorationDataForIdentifier(restorationIdentifier) {\n return this.restorationData[restorationIdentifier] || {}\n }\n\n updateRestorationData(additionalData) {\n const { restorationIdentifier } = this\n const restorationData = this.restorationData[restorationIdentifier]\n this.restorationData[restorationIdentifier] = {\n ...restorationData,\n ...additionalData\n }\n }\n\n // Scroll restoration\n\n assumeControlOfScrollRestoration() {\n if (!this.previousScrollRestoration) {\n this.previousScrollRestoration = history.scrollRestoration ?? \"auto\"\n history.scrollRestoration = \"manual\"\n }\n }\n\n relinquishControlOfScrollRestoration() {\n if (this.previousScrollRestoration) {\n history.scrollRestoration = this.previousScrollRestoration\n delete this.previousScrollRestoration\n }\n }\n\n // Event handlers\n\n onPopState = (event) => {\n const { turbo } = event.state || {}\n this.location = new URL(window.location.href)\n\n if (turbo) {\n const { restorationIdentifier, restorationIndex } = turbo\n this.restorationIdentifier = restorationIdentifier\n const direction = restorationIndex > this.currentIndex ? \"forward\" : \"back\"\n this.delegate.historyPoppedToLocationWithRestorationIdentifierAndDirection(this.location, restorationIdentifier, direction)\n this.currentIndex = restorationIndex\n } else {\n this.currentIndex++\n this.delegate.historyPoppedWithEmptyState(this.location)\n }\n }\n}\n" }, { "path": "src/core/drive/limited_set.js", "content": "export class LimitedSet extends Set {\n constructor(maxSize) {\n super()\n this.maxSize = maxSize\n }\n\n add(value) {\n if (this.size >= this.maxSize) {\n const iterator = this.values()\n const oldestValue = iterator.next().value\n this.delete(oldestValue)\n }\n super.add(value)\n }\n}\n" }, { "path": "src/core/drive/morphing_page_renderer.js", "content": "import { PageRenderer } from \"./page_renderer\"\nimport { dispatch } from \"../../util\"\nimport { morphElements, shouldRefreshFrameWithMorphing, closestFrameReloadableWithMorphing } from \"../morphing\"\n\nexport class MorphingPageRenderer extends PageRenderer {\n static renderElement(currentElement, newElement) {\n morphElements(currentElement, newElement, {\n callbacks: {\n beforeNodeMorphed: (node, newNode) => {\n if (\n shouldRefreshFrameWithMorphing(node, newNode) &&\n !closestFrameReloadableWithMorphing(node)\n ) {\n node.reload()\n return false\n }\n return true\n }\n }\n })\n\n dispatch(\"turbo:morph\", { detail: { currentElement, newElement } })\n }\n\n async preservingPermanentElements(callback) {\n return await callback()\n }\n\n get renderMethod() {\n return \"morph\"\n }\n\n get shouldAutofocus() {\n return false\n }\n}\n\n" }, { "path": "src/core/drive/navigator.js", "content": "import { getVisitAction } from \"../../util\"\nimport { FormSubmission } from \"./form_submission\"\nimport { expandURL } from \"../url\"\nimport { Visit } from \"./visit\"\nimport { PageSnapshot } from \"./page_snapshot\"\n\nexport class Navigator {\n constructor(delegate) {\n this.delegate = delegate\n }\n\n proposeVisit(location, options = {}) {\n if (this.delegate.allowsVisitingLocationWithAction(location, options.action)) {\n this.delegate.visitProposedToLocation(location, options)\n }\n }\n\n startVisit(locatable, restorationIdentifier, options = {}) {\n this.stop()\n this.currentVisit = new Visit(this, expandURL(locatable), restorationIdentifier, {\n referrer: this.location,\n ...options\n })\n this.currentVisit.start()\n }\n\n submitForm(form, submitter) {\n this.stop()\n this.formSubmission = new FormSubmission(this, form, submitter, true)\n\n this.formSubmission.start()\n }\n\n stop() {\n if (this.formSubmission) {\n this.formSubmission.stop()\n delete this.formSubmission\n }\n\n if (this.currentVisit) {\n this.currentVisit.cancel()\n delete this.currentVisit\n }\n }\n\n get adapter() {\n return this.delegate.adapter\n }\n\n get view() {\n return this.delegate.view\n }\n\n get rootLocation() {\n return this.view.snapshot.rootLocation\n }\n\n get history() {\n return this.delegate.history\n }\n\n // Form submission delegate\n\n formSubmissionStarted(formSubmission) {\n // Not all adapters implement formSubmissionStarted\n if (typeof this.adapter.formSubmissionStarted === \"function\") {\n this.adapter.formSubmissionStarted(formSubmission)\n }\n }\n\n async formSubmissionSucceededWithResponse(formSubmission, fetchResponse) {\n if (formSubmission == this.formSubmission) {\n const responseHTML = await fetchResponse.responseHTML\n if (responseHTML) {\n const shouldCacheSnapshot = formSubmission.isSafe\n if (!shouldCacheSnapshot) {\n this.view.clearSnapshotCache()\n }\n\n const { statusCode, redirected } = fetchResponse\n const action = this.#getActionForFormSubmission(formSubmission, fetchResponse)\n const visitOptions = {\n action,\n shouldCacheSnapshot,\n response: { statusCode, responseHTML, redirected }\n }\n this.proposeVisit(fetchResponse.location, visitOptions)\n }\n }\n }\n\n async formSubmissionFailedWithResponse(formSubmission, fetchResponse) {\n const responseHTML = await fetchResponse.responseHTML\n\n if (responseHTML) {\n const snapshot = PageSnapshot.fromHTMLString(responseHTML)\n if (fetchResponse.serverError) {\n await this.view.renderError(snapshot, this.currentVisit)\n } else {\n await this.view.renderPage(snapshot, false, true, this.currentVisit)\n }\n if (snapshot.refreshScroll !== \"preserve\") {\n this.view.scrollToTop()\n }\n this.view.clearSnapshotCache()\n }\n }\n\n formSubmissionErrored(formSubmission, error) {\n console.error(error)\n }\n\n formSubmissionFinished(formSubmission) {\n // Not all adapters implement formSubmissionFinished\n if (typeof this.adapter.formSubmissionFinished === \"function\") {\n this.adapter.formSubmissionFinished(formSubmission)\n }\n }\n\n // Link prefetching\n\n linkPrefetchingIsEnabledForLocation(location) {\n // Not all adapters implement linkPrefetchingIsEnabledForLocation\n if (typeof this.adapter.linkPrefetchingIsEnabledForLocation === \"function\") {\n return this.adapter.linkPrefetchingIsEnabledForLocation(location)\n }\n\n return true\n }\n\n // Visit delegate\n\n visitStarted(visit) {\n this.delegate.visitStarted(visit)\n }\n\n visitCompleted(visit) {\n this.delegate.visitCompleted(visit)\n delete this.currentVisit\n }\n\n // Same-page links are no longer handled with a Visit.\n // This method is still needed for Turbo Native adapters.\n locationWithActionIsSamePage(location, action) {\n return false\n }\n\n // Visits\n\n get location() {\n return this.history.location\n }\n\n get restorationIdentifier() {\n return this.history.restorationIdentifier\n }\n\n #getActionForFormSubmission(formSubmission, fetchResponse) {\n const { submitter, formElement } = formSubmission\n return getVisitAction(submitter, formElement) || this.#getDefaultAction(fetchResponse)\n }\n\n #getDefaultAction(fetchResponse) {\n const sameLocationRedirect = fetchResponse.redirected && fetchResponse.location.href === this.location?.href\n return sameLocationRedirect ? \"replace\" : \"advance\"\n }\n}\n" }, { "path": "src/core/drive/page_renderer.js", "content": "import { activateScriptElement, elementIsStylesheet, waitForLoad } from \"../../util\"\nimport { Renderer } from \"../renderer\"\n\nexport class PageRenderer extends Renderer {\n static renderElement(currentElement, newElement) {\n if (document.body && newElement instanceof HTMLBodyElement) {\n document.body.replaceWith(newElement)\n } else {\n document.documentElement.appendChild(newElement)\n }\n }\n\n get shouldRender() {\n return this.newSnapshot.isVisitable && this.trackedElementsAreIdentical\n }\n\n get reloadReason() {\n if (!this.newSnapshot.isVisitable) {\n return {\n reason: \"turbo_visit_control_is_reload\"\n }\n }\n\n if (!this.trackedElementsAreIdentical) {\n return {\n reason: \"tracked_element_mismatch\"\n }\n }\n }\n\n async prepareToRender() {\n this.#setLanguage()\n await this.mergeHead()\n }\n\n async render() {\n if (this.willRender) {\n await this.replaceBody()\n }\n }\n\n finishRendering() {\n super.finishRendering()\n if (!this.isPreview) {\n this.focusFirstAutofocusableElement()\n }\n }\n\n get currentHeadSnapshot() {\n return this.currentSnapshot.headSnapshot\n }\n\n get newHeadSnapshot() {\n return this.newSnapshot.headSnapshot\n }\n\n get newElement() {\n return this.newSnapshot.element\n }\n\n #setLanguage() {\n const { documentElement } = this.currentSnapshot\n const { dir, lang } = this.newSnapshot\n\n if (lang) {\n documentElement.setAttribute(\"lang\", lang)\n } else {\n documentElement.removeAttribute(\"lang\")\n }\n if (dir) {\n documentElement.setAttribute(\"dir\", dir)\n } else {\n documentElement.removeAttribute(\"dir\")\n }\n }\n\n async mergeHead() {\n const mergedHeadElements = this.mergeProvisionalElements()\n const newStylesheetElements = this.copyNewHeadStylesheetElements()\n this.copyNewHeadScriptElements()\n\n await mergedHeadElements\n await newStylesheetElements\n\n if (this.willRender) {\n this.removeUnusedDynamicStylesheetElements()\n }\n }\n\n async replaceBody() {\n await this.preservingPermanentElements(async () => {\n this.activateNewBody()\n await this.assignNewBody()\n })\n }\n\n get trackedElementsAreIdentical() {\n return this.currentHeadSnapshot.trackedElementSignature == this.newHeadSnapshot.trackedElementSignature\n }\n\n async copyNewHeadStylesheetElements() {\n const loadingElements = []\n\n for (const element of this.newHeadStylesheetElements) {\n loadingElements.push(waitForLoad(element))\n\n document.head.appendChild(element)\n }\n\n await Promise.all(loadingElements)\n }\n\n copyNewHeadScriptElements() {\n for (const element of this.newHeadScriptElements) {\n document.head.appendChild(activateScriptElement(element))\n }\n }\n\n removeUnusedDynamicStylesheetElements() {\n for (const element of this.unusedDynamicStylesheetElements) {\n document.head.removeChild(element)\n }\n }\n\n async mergeProvisionalElements() {\n const newHeadElements = [...this.newHeadProvisionalElements]\n\n for (const element of this.currentHeadProvisionalElements) {\n if (!this.isCurrentElementInElementList(element, newHeadElements)) {\n document.head.removeChild(element)\n }\n }\n\n for (const element of newHeadElements) {\n document.head.appendChild(element)\n }\n }\n\n isCurrentElementInElementList(element, elementList) {\n for (const [index, newElement] of elementList.entries()) {\n // if title element...\n if (element.tagName == \"TITLE\") {\n if (newElement.tagName != \"TITLE\") {\n continue\n }\n if (element.innerHTML == newElement.innerHTML) {\n elementList.splice(index, 1)\n return true\n }\n }\n\n // if any other element...\n if (newElement.isEqualNode(element)) {\n elementList.splice(index, 1)\n return true\n }\n }\n\n return false\n }\n\n removeCurrentHeadProvisionalElements() {\n for (const element of this.currentHeadProvisionalElements) {\n document.head.removeChild(element)\n }\n }\n\n copyNewHeadProvisionalElements() {\n for (const element of this.newHeadProvisionalElements) {\n document.head.appendChild(element)\n }\n }\n\n activateNewBody() {\n document.adoptNode(this.newElement)\n this.deactivateNoscriptStylesheetElements()\n this.activateNewBodyScriptElements()\n }\n\n deactivateNoscriptStylesheetElements() {\n for (const noscriptElement of this.newElement.querySelectorAll(\"noscript\")) {\n for (const child of [...noscriptElement.children]) {\n if (elementIsStylesheet(child)) {\n child.remove()\n }\n }\n }\n }\n\n activateNewBodyScriptElements() {\n for (const inertScriptElement of this.newBodyScriptElements) {\n const activatedScriptElement = activateScriptElement(inertScriptElement)\n inertScriptElement.replaceWith(activatedScriptElement)\n }\n }\n\n async assignNewBody() {\n await this.renderElement(this.currentElement, this.newElement)\n }\n\n get unusedDynamicStylesheetElements() {\n return this.oldHeadStylesheetElements.filter((element) => {\n return element.getAttribute(\"data-turbo-track\") === \"dynamic\"\n })\n }\n\n get oldHeadStylesheetElements() {\n return this.currentHeadSnapshot.getStylesheetElementsNotInSnapshot(this.newHeadSnapshot)\n }\n\n get newHeadStylesheetElements() {\n return this.newHeadSnapshot.getStylesheetElementsNotInSnapshot(this.currentHeadSnapshot)\n }\n\n get newHeadScriptElements() {\n return this.newHeadSnapshot.getScriptElementsNotInSnapshot(this.currentHeadSnapshot)\n }\n\n get currentHeadProvisionalElements() {\n return this.currentHeadSnapshot.provisionalElements\n }\n\n get newHeadProvisionalElements() {\n return this.newHeadSnapshot.provisionalElements\n }\n\n get newBodyScriptElements() {\n return this.newElement.querySelectorAll(\"script\")\n }\n}\n" }, { "path": "src/core/drive/page_snapshot.js", "content": "import { elementIsStylesheet, parseHTMLDocument } from \"../../util\"\nimport { Snapshot } from \"../snapshot\"\nimport { expandURL } from \"../url\"\nimport { HeadSnapshot } from \"./head_snapshot\"\n\nexport class PageSnapshot extends Snapshot {\n static fromHTMLString(html = \"\") {\n return this.fromDocument(parseHTMLDocument(html))\n }\n\n static fromElement(element) {\n return this.fromDocument(element.ownerDocument)\n }\n\n static fromDocument({ documentElement, body, head }) {\n return new this(documentElement, body, new HeadSnapshot(head))\n }\n\n constructor(documentElement, body, headSnapshot) {\n super(body)\n this.documentElement = documentElement\n this.headSnapshot = headSnapshot\n }\n\n clone() {\n const clonedElement = this.element.cloneNode(true)\n\n const selectElements = this.element.querySelectorAll(\"select\")\n const clonedSelectElements = clonedElement.querySelectorAll(\"select\")\n\n for (const [index, source] of selectElements.entries()) {\n const clone = clonedSelectElements[index]\n for (const option of clone.selectedOptions) option.selected = false\n for (const option of source.selectedOptions) clone.options[option.index].selected = true\n }\n\n for (const clonedPasswordInput of clonedElement.querySelectorAll('input[type=\"password\"]')) {\n clonedPasswordInput.value = \"\"\n }\n\n for (const clonedNoscriptElement of clonedElement.querySelectorAll(\"noscript\")) {\n for (const child of [...clonedNoscriptElement.children]) {\n if (elementIsStylesheet(child)) {\n child.remove()\n }\n }\n }\n\n return new PageSnapshot(this.documentElement, clonedElement, this.headSnapshot)\n }\n\n get lang() {\n return this.documentElement.getAttribute(\"lang\")\n }\n\n get dir() {\n return this.documentElement.getAttribute(\"dir\")\n }\n\n get headElement() {\n return this.headSnapshot.element\n }\n\n get rootLocation() {\n const root = this.getSetting(\"root\") ?? \"/\"\n return expandURL(root)\n }\n\n get cacheControlValue() {\n return this.getSetting(\"cache-control\")\n }\n\n get isPreviewable() {\n return this.cacheControlValue != \"no-preview\"\n }\n\n get isCacheable() {\n return this.cacheControlValue != \"no-cache\"\n }\n\n get isVisitable() {\n return this.getSetting(\"visit-control\") != \"reload\"\n }\n\n get prefersViewTransitions() {\n const viewTransitionEnabled = this.getSetting(\"view-transition\") === \"true\" || this.headSnapshot.getMetaValue(\"view-transition\") === \"same-origin\"\n return viewTransitionEnabled && !window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n }\n\n get refreshMethod() {\n return this.getSetting(\"refresh-method\")\n }\n\n get refreshScroll() {\n return this.getSetting(\"refresh-scroll\")\n }\n\n // Private\n\n getSetting(name) {\n return this.headSnapshot.getMetaValue(`turbo-${name}`)\n }\n}\n" }, { "path": "src/core/drive/page_view.js", "content": "import { nextEventLoopTick } from \"../../util\"\nimport { View } from \"../view\"\nimport { ErrorRenderer } from \"./error_renderer\"\nimport { MorphingPageRenderer } from \"./morphing_page_renderer\"\nimport { PageRenderer } from \"./page_renderer\"\nimport { PageSnapshot } from \"./page_snapshot\"\nimport { SnapshotCache } from \"./snapshot_cache\"\n\nexport class PageView extends View {\n snapshotCache = new SnapshotCache(10)\n lastRenderedLocation = new URL(location.href)\n forceReloaded = false\n\n shouldTransitionTo(newSnapshot) {\n return this.snapshot.prefersViewTransitions && newSnapshot.prefersViewTransitions\n }\n\n renderPage(snapshot, isPreview = false, willRender = true, visit) {\n const shouldMorphPage = this.isPageRefresh(visit) && (visit?.refresh?.method || this.snapshot.refreshMethod) === \"morph\"\n const rendererClass = shouldMorphPage ? MorphingPageRenderer : PageRenderer\n\n const renderer = new rendererClass(this.snapshot, snapshot, isPreview, willRender)\n\n if (!renderer.shouldRender) {\n this.forceReloaded = true\n } else {\n visit?.changeHistory()\n }\n\n return this.render(renderer)\n }\n\n renderError(snapshot, visit) {\n visit?.changeHistory()\n const renderer = new ErrorRenderer(this.snapshot, snapshot, false)\n return this.render(renderer)\n }\n\n clearSnapshotCache() {\n this.snapshotCache.clear()\n }\n\n async cacheSnapshot(snapshot = this.snapshot) {\n if (snapshot.isCacheable) {\n this.delegate.viewWillCacheSnapshot()\n const { lastRenderedLocation: location } = this\n await nextEventLoopTick()\n const cachedSnapshot = snapshot.clone()\n this.snapshotCache.put(location, cachedSnapshot)\n return cachedSnapshot\n }\n }\n\n getCachedSnapshotForLocation(location) {\n return this.snapshotCache.get(location)\n }\n\n isPageRefresh(visit) {\n return !visit || (this.lastRenderedLocation.pathname === visit.location.pathname && visit.action === \"replace\")\n }\n\n shouldPreserveScrollPosition(visit) {\n return this.isPageRefresh(visit) && (visit?.refresh?.scroll || this.snapshot.refreshScroll) === \"preserve\"\n }\n\n get snapshot() {\n return PageSnapshot.fromElement(this.element)\n }\n}\n" }, { "path": "src/core/drive/prefetch_cache.js", "content": "import { LRUCache } from \"../lru_cache\"\nimport { toCacheKey } from \"../url\"\n\nconst PREFETCH_DELAY = 100\n\nclass PrefetchCache extends LRUCache {\n #prefetchTimeout = null\n #maxAges = {}\n\n constructor(size = 1, prefetchDelay = PREFETCH_DELAY) {\n super(size, toCacheKey)\n this.prefetchDelay = prefetchDelay\n }\n\n putLater(url, request, ttl) {\n this.#prefetchTimeout = setTimeout(() => {\n request.perform()\n this.put(url, request, ttl)\n this.#prefetchTimeout = null\n }, this.prefetchDelay)\n }\n\n put(url, request, ttl = cacheTtl) {\n super.put(url, request)\n this.#maxAges[toCacheKey(url)] = new Date(new Date().getTime() + ttl)\n }\n\n clear() {\n super.clear()\n if (this.#prefetchTimeout) clearTimeout(this.#prefetchTimeout)\n }\n\n evict(key) {\n super.evict(key)\n delete this.#maxAges[key]\n }\n\n has(key) {\n if (super.has(key)) {\n const maxAge = this.#maxAges[toCacheKey(key)]\n\n return maxAge && maxAge > Date.now()\n } else {\n return false\n }\n }\n}\n\nexport const cacheTtl = 10 * 1000\nexport const prefetchCache = new PrefetchCache()\n" }, { "path": "src/core/drive/preloader.js", "content": "import { PageSnapshot } from \"./page_snapshot\"\nimport { FetchMethod, FetchRequest } from \"../../http/fetch_request\"\n\nexport class Preloader {\n selector = \"a[data-turbo-preload]\"\n\n constructor(delegate, snapshotCache) {\n this.delegate = delegate\n this.snapshotCache = snapshotCache\n }\n\n start() {\n if (document.readyState === \"loading\") {\n document.addEventListener(\"DOMContentLoaded\", this.#preloadAll)\n } else {\n this.preloadOnLoadLinksForView(document.body)\n }\n }\n\n stop() {\n document.removeEventListener(\"DOMContentLoaded\", this.#preloadAll)\n }\n\n preloadOnLoadLinksForView(element) {\n for (const link of element.querySelectorAll(this.selector)) {\n if (this.delegate.shouldPreloadLink(link)) {\n this.preloadURL(link)\n }\n }\n }\n\n async preloadURL(link) {\n const location = new URL(link.href)\n\n if (this.snapshotCache.has(location)) {\n return\n }\n\n const fetchRequest = new FetchRequest(this, FetchMethod.get, location, new URLSearchParams(), link)\n await fetchRequest.perform()\n }\n\n // Fetch request delegate\n\n prepareRequest(fetchRequest) {\n fetchRequest.headers[\"X-Sec-Purpose\"] = \"prefetch\"\n }\n\n async requestSucceededWithResponse(fetchRequest, fetchResponse) {\n try {\n const responseHTML = await fetchResponse.responseHTML\n const snapshot = PageSnapshot.fromHTMLString(responseHTML)\n\n this.snapshotCache.put(fetchRequest.url, snapshot)\n } catch (_) {\n // If we cannot preload that is ok!\n }\n }\n\n requestStarted(fetchRequest) {}\n\n requestErrored(fetchRequest) {}\n\n requestFinished(fetchRequest) {}\n\n requestPreventedHandlingResponse(fetchRequest, fetchResponse) {}\n\n requestFailedWithResponse(fetchRequest, fetchResponse) {}\n\n #preloadAll = () => {\n this.preloadOnLoadLinksForView(document.body)\n }\n}\n" }, { "path": "src/core/drive/progress_bar.js", "content": "import { unindent, getCspNonce } from \"../../util\"\n\nexport const ProgressBarID = \"turbo-progress-bar\"\n\nexport class ProgressBar {\n static animationDuration = 300 /*ms*/\n\n static get defaultCSS() {\n return unindent`\n .turbo-progress-bar {\n position: fixed;\n display: block;\n top: 0;\n left: 0;\n height: 3px;\n background: #0076ff;\n z-index: 2147483647;\n transition:\n width ${ProgressBar.animationDuration}ms ease-out,\n opacity ${ProgressBar.animationDuration / 2}ms ${ProgressBar.animationDuration / 2}ms ease-in;\n transform: translate3d(0, 0, 0);\n }\n `\n }\n\n hiding = false\n value = 0\n visible = false\n\n constructor() {\n this.stylesheetElement = this.createStylesheetElement()\n this.progressElement = this.createProgressElement()\n this.installStylesheetElement()\n this.setValue(0)\n }\n\n show() {\n if (!this.visible) {\n this.visible = true\n this.installProgressElement()\n this.startTrickling()\n }\n }\n\n hide() {\n if (this.visible && !this.hiding) {\n this.hiding = true\n this.fadeProgressElement(() => {\n this.uninstallProgressElement()\n this.stopTrickling()\n this.visible = false\n this.hiding = false\n })\n }\n }\n\n setValue(value) {\n this.value = value\n this.refresh()\n }\n\n // Private\n\n installStylesheetElement() {\n document.head.insertBefore(this.stylesheetElement, document.head.firstChild)\n }\n\n installProgressElement() {\n this.progressElement.style.width = \"0\"\n this.progressElement.style.opacity = \"1\"\n document.documentElement.insertBefore(this.progressElement, document.body)\n this.refresh()\n }\n\n fadeProgressElement(callback) {\n this.progressElement.style.opacity = \"0\"\n setTimeout(callback, ProgressBar.animationDuration * 1.5)\n }\n\n uninstallProgressElement() {\n if (this.progressElement.parentNode) {\n document.documentElement.removeChild(this.progressElement)\n }\n }\n\n startTrickling() {\n if (!this.trickleInterval) {\n this.trickleInterval = window.setInterval(this.trickle, ProgressBar.animationDuration)\n }\n }\n\n stopTrickling() {\n window.clearInterval(this.trickleInterval)\n delete this.trickleInterval\n }\n\n trickle = () => {\n this.setValue(this.value + Math.random() / 100)\n }\n\n refresh() {\n requestAnimationFrame(() => {\n this.progressElement.style.width = `${10 + this.value * 90}%`\n })\n }\n\n createStylesheetElement() {\n const element = document.createElement(\"style\")\n element.type = \"text/css\"\n element.textContent = ProgressBar.defaultCSS\n const cspNonce = getCspNonce()\n if (cspNonce) {\n element.nonce = cspNonce\n }\n return element\n }\n\n createProgressElement() {\n const element = document.createElement(\"div\")\n element.className = \"turbo-progress-bar\"\n return element\n }\n}\n" }, { "path": "src/core/drive/snapshot_cache.js", "content": "import { toCacheKey } from \"../url\"\nimport { LRUCache } from \"../lru_cache\"\n\nexport class SnapshotCache extends LRUCache {\n constructor(size) {\n super(size, toCacheKey)\n }\n\n get snapshots() {\n return this.entries\n }\n}\n" }, { "path": "src/core/drive/view_transitioner.js", "content": "export class ViewTransitioner {\n #viewTransitionStarted = false\n #lastOperation = Promise.resolve()\n\n renderChange(useViewTransition, render) {\n if (useViewTransition && this.viewTransitionsAvailable && !this.#viewTransitionStarted) {\n this.#viewTransitionStarted = true\n this.#lastOperation = this.#lastOperation.then(async () => {\n await document.startViewTransition(render).finished\n })\n } else {\n this.#lastOperation = this.#lastOperation.then(render)\n }\n\n return this.#lastOperation\n }\n\n get viewTransitionsAvailable() {\n return document.startViewTransition\n }\n}\n" }, { "path": "src/core/drive/visit.js", "content": "import { FetchMethod, FetchRequest } from \"../../http/fetch_request\"\nimport { getAnchor } from \"../url\"\nimport { PageSnapshot } from \"./page_snapshot\"\nimport { getHistoryMethodForAction, uuid } from \"../../util\"\nimport { StreamMessage } from \"../streams/stream_message\"\nimport { ViewTransitioner } from \"./view_transitioner\"\n\nconst defaultOptions = {\n action: \"advance\",\n historyChanged: false,\n visitCachedSnapshot: () => {},\n willRender: true,\n updateHistory: true,\n shouldCacheSnapshot: true,\n acceptsStreamResponse: false,\n refresh: {}\n}\n\nexport const TimingMetric = {\n visitStart: \"visitStart\",\n requestStart: \"requestStart\",\n requestEnd: \"requestEnd\",\n visitEnd: \"visitEnd\"\n}\n\nexport const VisitState = {\n initialized: \"initialized\",\n started: \"started\",\n canceled: \"canceled\",\n failed: \"failed\",\n completed: \"completed\"\n}\n\nexport const SystemStatusCode = {\n networkFailure: 0,\n timeoutFailure: -1,\n contentTypeMismatch: -2\n}\n\nexport const Direction = {\n advance: \"forward\",\n restore: \"back\",\n replace: \"none\"\n}\n\nexport class Visit {\n identifier = uuid() // Required by turbo-ios\n timingMetrics = {}\n\n followedRedirect = false\n historyChanged = false\n scrolled = false\n shouldCacheSnapshot = true\n acceptsStreamResponse = false\n snapshotCached = false\n state = VisitState.initialized\n viewTransitioner = new ViewTransitioner()\n\n constructor(delegate, location, restorationIdentifier, options = {}) {\n this.delegate = delegate\n this.location = location\n this.restorationIdentifier = restorationIdentifier || uuid()\n\n const {\n action,\n historyChanged,\n referrer,\n snapshot,\n snapshotHTML,\n response,\n visitCachedSnapshot,\n willRender,\n updateHistory,\n shouldCacheSnapshot,\n acceptsStreamResponse,\n direction,\n refresh\n } = {\n ...defaultOptions,\n ...options\n }\n this.action = action\n this.historyChanged = historyChanged\n this.referrer = referrer\n this.snapshot = snapshot\n this.snapshotHTML = snapshotHTML\n this.response = response\n this.isPageRefresh = this.view.isPageRefresh(this)\n this.visitCachedSnapshot = visitCachedSnapshot\n this.willRender = willRender\n this.updateHistory = updateHistory\n this.scrolled = !willRender\n this.shouldCacheSnapshot = shouldCacheSnapshot\n this.acceptsStreamResponse = acceptsStreamResponse\n this.direction = direction || Direction[action]\n this.refresh = refresh\n }\n\n get adapter() {\n return this.delegate.adapter\n }\n\n get view() {\n return this.delegate.view\n }\n\n get history() {\n return this.delegate.history\n }\n\n get restorationData() {\n return this.history.getRestorationDataForIdentifier(this.restorationIdentifier)\n }\n\n start() {\n if (this.state == VisitState.initialized) {\n this.recordTimingMetric(TimingMetric.visitStart)\n this.state = VisitState.started\n this.adapter.visitStarted(this)\n this.delegate.visitStarted(this)\n }\n }\n\n cancel() {\n if (this.state == VisitState.started) {\n if (this.request) {\n this.request.cancel()\n }\n this.cancelRender()\n this.state = VisitState.canceled\n }\n }\n\n complete() {\n if (this.state == VisitState.started) {\n this.recordTimingMetric(TimingMetric.visitEnd)\n this.adapter.visitCompleted(this)\n this.state = VisitState.completed\n this.followRedirect()\n\n if (!this.followedRedirect) {\n this.delegate.visitCompleted(this)\n }\n }\n }\n\n fail() {\n if (this.state == VisitState.started) {\n this.state = VisitState.failed\n this.adapter.visitFailed(this)\n this.delegate.visitCompleted(this)\n }\n }\n\n changeHistory() {\n if (!this.historyChanged && this.updateHistory) {\n const actionForHistory = this.location.href === this.referrer?.href ? \"replace\" : this.action\n const method = getHistoryMethodForAction(actionForHistory)\n this.history.update(method, this.location, this.restorationIdentifier)\n this.historyChanged = true\n }\n }\n\n issueRequest() {\n if (this.hasPreloadedResponse()) {\n this.simulateRequest()\n } else if (this.shouldIssueRequest() && !this.request) {\n this.request = new FetchRequest(this, FetchMethod.get, this.location)\n this.request.perform()\n }\n }\n\n simulateRequest() {\n if (this.response) {\n this.startRequest()\n this.recordResponse()\n this.finishRequest()\n }\n }\n\n startRequest() {\n this.recordTimingMetric(TimingMetric.requestStart)\n this.adapter.visitRequestStarted(this)\n }\n\n recordResponse(response = this.response) {\n this.response = response\n if (response) {\n const { statusCode } = response\n if (isSuccessful(statusCode)) {\n this.adapter.visitRequestCompleted(this)\n } else {\n this.adapter.visitRequestFailedWithStatusCode(this, statusCode)\n }\n }\n }\n\n finishRequest() {\n this.recordTimingMetric(TimingMetric.requestEnd)\n this.adapter.visitRequestFinished(this)\n }\n\n loadResponse() {\n if (this.response) {\n const { statusCode, responseHTML } = this.response\n this.render(async () => {\n if (this.shouldCacheSnapshot) this.cacheSnapshot()\n if (this.view.renderPromise) await this.view.renderPromise\n\n if (isSuccessful(statusCode) && responseHTML != null) {\n const snapshot = PageSnapshot.fromHTMLString(responseHTML)\n await this.renderPageSnapshot(snapshot, false)\n\n this.adapter.visitRendered(this)\n this.complete()\n } else {\n await this.view.renderError(PageSnapshot.fromHTMLString(responseHTML), this)\n this.adapter.visitRendered(this)\n this.fail()\n }\n })\n }\n }\n\n getCachedSnapshot() {\n const snapshot = this.view.getCachedSnapshotForLocation(this.location) || this.getPreloadedSnapshot()\n\n if (snapshot && (!getAnchor(this.location) || snapshot.hasAnchor(getAnchor(this.location)))) {\n if (this.action == \"restore\" || snapshot.isPreviewable) {\n return snapshot\n }\n }\n }\n\n getPreloadedSnapshot() {\n if (this.snapshotHTML) {\n return PageSnapshot.fromHTMLString(this.snapshotHTML)\n }\n }\n\n hasCachedSnapshot() {\n return this.getCachedSnapshot() != null\n }\n\n loadCachedSnapshot() {\n const snapshot = this.getCachedSnapshot()\n if (snapshot) {\n const isPreview = this.shouldIssueRequest()\n this.render(async () => {\n this.cacheSnapshot()\n if (this.isPageRefresh) {\n this.adapter.visitRendered(this)\n } else {\n if (this.view.renderPromise) await this.view.renderPromise\n\n await this.renderPageSnapshot(snapshot, isPreview)\n\n this.adapter.visitRendered(this)\n if (!isPreview) {\n this.complete()\n }\n }\n })\n }\n }\n\n followRedirect() {\n if (this.redirectedToLocation && !this.followedRedirect && this.response?.redirected) {\n this.adapter.visitProposedToLocation(this.redirectedToLocation, {\n action: \"replace\",\n response: this.response,\n shouldCacheSnapshot: false,\n willRender: false\n })\n this.followedRedirect = true\n }\n }\n\n // Fetch request delegate\n\n prepareRequest(request) {\n if (this.acceptsStreamResponse) {\n request.acceptResponseType(StreamMessage.contentType)\n }\n }\n\n requestStarted() {\n this.startRequest()\n }\n\n requestPreventedHandlingResponse(_request, _response) {}\n\n async requestSucceededWithResponse(request, response) {\n const responseHTML = await response.responseHTML\n const { redirected, statusCode } = response\n if (responseHTML == undefined) {\n this.recordResponse({\n statusCode: SystemStatusCode.contentTypeMismatch,\n redirected\n })\n } else {\n this.redirectedToLocation = response.redirected ? response.location : undefined\n this.recordResponse({ statusCode: statusCode, responseHTML, redirected })\n }\n }\n\n async requestFailedWithResponse(request, response) {\n const responseHTML = await response.responseHTML\n const { redirected, statusCode } = response\n if (responseHTML == undefined) {\n this.recordResponse({\n statusCode: SystemStatusCode.contentTypeMismatch,\n redirected\n })\n } else {\n this.recordResponse({ statusCode: statusCode, responseHTML, redirected })\n }\n }\n\n requestErrored(_request, _error) {\n this.recordResponse({\n statusCode: SystemStatusCode.networkFailure,\n redirected: false\n })\n }\n\n requestFinished() {\n this.finishRequest()\n }\n\n // Scrolling\n\n performScroll() {\n if (!this.scrolled && !this.view.forceReloaded && !this.view.shouldPreserveScrollPosition(this)) {\n if (this.action == \"restore\") {\n this.scrollToRestoredPosition() || this.scrollToAnchor() || this.view.scrollToTop()\n } else {\n this.scrollToAnchor() || this.view.scrollToTop()\n }\n\n this.scrolled = true\n }\n }\n\n scrollToRestoredPosition() {\n const { scrollPosition } = this.restorationData\n if (scrollPosition) {\n this.view.scrollToPosition(scrollPosition)\n return true\n }\n }\n\n scrollToAnchor() {\n const anchor = getAnchor(this.location)\n if (anchor != null) {\n this.view.scrollToAnchor(anchor)\n return true\n }\n }\n\n // Instrumentation\n\n recordTimingMetric(metric) {\n this.timingMetrics[metric] = new Date().getTime()\n }\n\n getTimingMetrics() {\n return { ...this.timingMetrics }\n }\n\n // Private\n\n hasPreloadedResponse() {\n return typeof this.response == \"object\"\n }\n\n shouldIssueRequest() {\n if (this.action == \"restore\") {\n return !this.hasCachedSnapshot()\n } else {\n return this.willRender\n }\n }\n\n cacheSnapshot() {\n if (!this.snapshotCached) {\n this.view.cacheSnapshot(this.snapshot).then((snapshot) => snapshot && this.visitCachedSnapshot(snapshot))\n this.snapshotCached = true\n }\n }\n\n async render(callback) {\n this.cancelRender()\n await new Promise((resolve) => {\n this.frame =\n document.visibilityState === \"hidden\" ? setTimeout(() => resolve(), 0) : requestAnimationFrame(() => resolve())\n })\n await callback()\n delete this.frame\n }\n\n async renderPageSnapshot(snapshot, isPreview) {\n await this.viewTransitioner.renderChange(this.view.shouldTransitionTo(snapshot), async () => {\n await this.view.renderPage(snapshot, isPreview, this.willRender, this)\n this.performScroll()\n })\n }\n\n cancelRender() {\n if (this.frame) {\n cancelAnimationFrame(this.frame)\n delete this.frame\n }\n }\n}\n\nfunction isSuccessful(statusCode) {\n return statusCode >= 200 && statusCode < 300\n}\n" }, { "path": "src/core/errors.js", "content": "export class TurboFrameMissingError extends Error {}\n" }, { "path": "src/core/frames/frame_controller.js", "content": "import { FrameElement, FrameLoadingStyle } from \"../../elements/frame_element\"\nimport { FetchMethod, FetchRequest } from \"../../http/fetch_request\"\nimport { FetchResponse } from \"../../http/fetch_response\"\nimport { AppearanceObserver } from \"../../observers/appearance_observer\"\nimport {\n clearBusyState,\n dispatch,\n getAttribute,\n parseHTMLDocument,\n markAsBusy,\n uuid,\n getHistoryMethodForAction,\n getVisitAction\n} from \"../../util\"\nimport { FormSubmission } from \"../drive/form_submission\"\nimport { Snapshot } from \"../snapshot\"\nimport { getAction, expandURL, urlsAreEqual, locationIsVisitable } from \"../url\"\nimport { FormSubmitObserver } from \"../../observers/form_submit_observer\"\nimport { FrameView } from \"./frame_view\"\nimport { LinkInterceptor } from \"./link_interceptor\"\nimport { FormLinkClickObserver } from \"../../observers/form_link_click_observer\"\nimport { FrameRenderer } from \"./frame_renderer\"\nimport { MorphingFrameRenderer } from \"./morphing_frame_renderer\"\nimport { session } from \"../index\"\nimport { StreamMessage } from \"../streams/stream_message\"\nimport { PageSnapshot } from \"../drive/page_snapshot\"\nimport { TurboFrameMissingError } from \"../errors\"\n\nexport class FrameController {\n fetchResponseLoaded = (_fetchResponse) => Promise.resolve()\n #currentFetchRequest = null\n #resolveVisitPromise = () => {}\n #connected = false\n #hasBeenLoaded = false\n #ignoredAttributes = new Set()\n #shouldMorphFrame = false\n action = null\n\n constructor(element) {\n this.element = element\n this.view = new FrameView(this, this.element)\n this.appearanceObserver = new AppearanceObserver(this, this.element)\n this.formLinkClickObserver = new FormLinkClickObserver(this, this.element)\n this.linkInterceptor = new LinkInterceptor(this, this.element)\n this.restorationIdentifier = uuid()\n this.formSubmitObserver = new FormSubmitObserver(this, this.element)\n }\n\n // Frame delegate\n\n connect() {\n if (!this.#connected) {\n this.#connected = true\n if (this.loadingStyle == FrameLoadingStyle.lazy) {\n this.appearanceObserver.start()\n } else {\n this.#loadSourceURL()\n }\n this.formLinkClickObserver.start()\n this.linkInterceptor.start()\n this.formSubmitObserver.start()\n }\n }\n\n disconnect() {\n if (this.#connected) {\n this.#connected = false\n this.appearanceObserver.stop()\n this.formLinkClickObserver.stop()\n this.linkInterceptor.stop()\n this.formSubmitObserver.stop()\n\n if (!this.element.hasAttribute(\"recurse\")) {\n this.#currentFetchRequest?.cancel()\n }\n }\n }\n\n disabledChanged() {\n if (this.disabled) {\n this.#currentFetchRequest?.cancel()\n } else if (this.loadingStyle == FrameLoadingStyle.eager) {\n this.#loadSourceURL()\n }\n }\n\n sourceURLChanged() {\n if (this.#isIgnoringChangesTo(\"src\")) return\n\n if (!this.sourceURL) {\n this.#currentFetchRequest?.cancel()\n }\n\n if (this.element.isConnected) {\n this.complete = false\n }\n\n if (this.loadingStyle == FrameLoadingStyle.eager || this.#hasBeenLoaded) {\n this.#loadSourceURL()\n }\n }\n\n sourceURLReloaded() {\n const { refresh, src } = this.element\n\n this.#shouldMorphFrame = src && refresh === \"morph\"\n\n this.element.removeAttribute(\"complete\")\n this.element.src = null\n this.element.src = src\n return this.element.loaded\n }\n\n loadingStyleChanged() {\n if (this.loadingStyle == FrameLoadingStyle.lazy) {\n this.appearanceObserver.start()\n } else {\n this.appearanceObserver.stop()\n this.#loadSourceURL()\n }\n }\n\n async #loadSourceURL() {\n if (this.enabled && this.isActive && !this.complete && this.sourceURL) {\n this.element.loaded = this.#visit(expandURL(this.sourceURL))\n this.appearanceObserver.stop()\n await this.element.loaded\n this.#hasBeenLoaded = true\n }\n }\n\n async loadResponse(fetchResponse) {\n if (fetchResponse.redirected || (fetchResponse.succeeded && fetchResponse.isHTML)) {\n this.sourceURL = fetchResponse.response.url\n }\n\n try {\n const html = await fetchResponse.responseHTML\n if (html) {\n const document = parseHTMLDocument(html)\n const pageSnapshot = PageSnapshot.fromDocument(document)\n\n if (pageSnapshot.isVisitable) {\n await this.#loadFrameResponse(fetchResponse, document)\n } else {\n await this.#handleUnvisitableFrameResponse(fetchResponse)\n }\n }\n } finally {\n this.#shouldMorphFrame = false\n this.fetchResponseLoaded = () => Promise.resolve()\n }\n }\n\n // Appearance observer delegate\n\n elementAppearedInViewport(element) {\n this.proposeVisitIfNavigatedWithAction(element, getVisitAction(element))\n this.#loadSourceURL()\n }\n\n // Form link click observer delegate\n\n willSubmitFormLinkToLocation(link) {\n return this.#shouldInterceptNavigation(link)\n }\n\n submittedFormLinkToLocation(link, _location, form) {\n const frame = this.#findFrameElement(link)\n if (frame) form.setAttribute(\"data-turbo-frame\", frame.id)\n }\n\n // Link interceptor delegate\n\n shouldInterceptLinkClick(element, _location, _event) {\n return this.#shouldInterceptNavigation(element)\n }\n\n linkClickIntercepted(element, location) {\n this.#navigateFrame(element, location)\n }\n\n // Form submit observer delegate\n\n willSubmitForm(element, submitter) {\n return element.closest(\"turbo-frame\") == this.element && this.#shouldInterceptNavigation(element, submitter)\n }\n\n formSubmitted(element, submitter) {\n if (this.formSubmission) {\n this.formSubmission.stop()\n }\n\n this.formSubmission = new FormSubmission(this, element, submitter)\n\n const { fetchRequest } = this.formSubmission\n const frame = this.#findFrameElement(element, submitter)\n\n this.prepareRequest(fetchRequest, frame)\n this.formSubmission.start()\n }\n\n // Fetch request delegate\n\n prepareRequest(request, frame = this) {\n request.headers[\"Turbo-Frame\"] = frame.id\n\n if (this.currentNavigationElement?.hasAttribute(\"data-turbo-stream\")) {\n request.acceptResponseType(StreamMessage.contentType)\n }\n }\n\n requestStarted(_request) {\n markAsBusy(this.element)\n }\n\n requestPreventedHandlingResponse(_request, _response) {\n this.#resolveVisitPromise()\n }\n\n async requestSucceededWithResponse(request, response) {\n await this.loadResponse(response)\n this.#resolveVisitPromise()\n }\n\n async requestFailedWithResponse(request, response) {\n await this.loadResponse(response)\n this.#resolveVisitPromise()\n }\n\n requestErrored(request, error) {\n console.error(error)\n this.#resolveVisitPromise()\n }\n\n requestFinished(_request) {\n clearBusyState(this.element)\n }\n\n // Form submission delegate\n\n formSubmissionStarted({ formElement }) {\n markAsBusy(formElement, this.#findFrameElement(formElement))\n }\n\n formSubmissionSucceededWithResponse(formSubmission, response) {\n const frame = this.#findFrameElement(formSubmission.formElement, formSubmission.submitter)\n\n frame.delegate.proposeVisitIfNavigatedWithAction(frame, getVisitAction(formSubmission.submitter, formSubmission.formElement, frame))\n frame.delegate.loadResponse(response)\n\n if (!formSubmission.isSafe) {\n session.clearCache()\n }\n }\n\n formSubmissionFailedWithResponse(formSubmission, fetchResponse) {\n this.element.delegate.loadResponse(fetchResponse)\n session.clearCache()\n }\n\n formSubmissionErrored(formSubmission, error) {\n console.error(error)\n }\n\n formSubmissionFinished({ formElement }) {\n clearBusyState(formElement, this.#findFrameElement(formElement))\n }\n\n // View delegate\n\n allowsImmediateRender({ element: newFrame }, options) {\n const event = dispatch(\"turbo:before-frame-render\", {\n target: this.element,\n detail: { newFrame, ...options },\n cancelable: true\n })\n\n const {\n defaultPrevented,\n detail: { render }\n } = event\n\n if (this.view.renderer && render) {\n this.view.renderer.renderElement = render\n }\n\n return !defaultPrevented\n }\n\n viewRenderedSnapshot(_snapshot, _isPreview, _renderMethod) {}\n\n preloadOnLoadLinksForView(element) {\n session.preloadOnLoadLinksForView(element)\n }\n\n viewInvalidated() {}\n\n // Frame renderer delegate\n\n willRenderFrame(currentElement, _newElement) {\n this.previousFrameElement = currentElement.cloneNode(true)\n }\n\n visitCachedSnapshot = ({ element }) => {\n const frame = element.querySelector(\"#\" + this.element.id)\n\n if (frame && this.previousFrameElement) {\n frame.replaceChildren(...this.previousFrameElement.children)\n }\n\n delete this.previousFrameElement\n }\n\n // Private\n\n async #loadFrameResponse(fetchResponse, document) {\n const newFrameElement = await this.extractForeignFrameElement(document.body)\n const rendererClass = this.#shouldMorphFrame ? MorphingFrameRenderer : FrameRenderer\n\n if (newFrameElement) {\n const snapshot = new Snapshot(newFrameElement)\n const renderer = new rendererClass(this, this.view.snapshot, snapshot, false, false)\n if (this.view.renderPromise) await this.view.renderPromise\n this.changeHistory()\n\n await this.view.render(renderer)\n this.complete = true\n session.frameRendered(fetchResponse, this.element)\n session.frameLoaded(this.element)\n await this.fetchResponseLoaded(fetchResponse)\n } else if (this.#willHandleFrameMissingFromResponse(fetchResponse)) {\n this.#handleFrameMissingFromResponse(fetchResponse)\n }\n }\n\n async #visit(url) {\n const request = new FetchRequest(this, FetchMethod.get, url, new URLSearchParams(), this.element)\n\n this.#currentFetchRequest?.cancel()\n this.#currentFetchRequest = request\n\n return new Promise((resolve) => {\n this.#resolveVisitPromise = () => {\n this.#resolveVisitPromise = () => {}\n this.#currentFetchRequest = null\n resolve()\n }\n request.perform()\n })\n }\n\n #navigateFrame(element, url, submitter) {\n const frame = this.#findFrameElement(element, submitter)\n\n frame.delegate.proposeVisitIfNavigatedWithAction(frame, getVisitAction(submitter, element, frame))\n\n this.#withCurrentNavigationElement(element, () => {\n frame.src = url\n })\n }\n\n proposeVisitIfNavigatedWithAction(frame, action = null) {\n this.action = action\n\n if (this.action) {\n const pageSnapshot = PageSnapshot.fromElement(frame).clone()\n const { visitCachedSnapshot } = frame.delegate\n\n frame.delegate.fetchResponseLoaded = async (fetchResponse) => {\n if (frame.src) {\n const { statusCode, redirected } = fetchResponse\n const responseHTML = await fetchResponse.responseHTML\n const response = { statusCode, redirected, responseHTML }\n const options = {\n response,\n visitCachedSnapshot,\n willRender: false,\n updateHistory: false,\n restorationIdentifier: this.restorationIdentifier,\n snapshot: pageSnapshot\n }\n\n if (this.action) options.action = this.action\n\n session.visit(frame.src, options)\n }\n }\n }\n }\n\n changeHistory() {\n if (this.action) {\n const method = getHistoryMethodForAction(this.action)\n session.history.update(method, expandURL(this.element.src || \"\"), this.restorationIdentifier)\n }\n }\n\n async #handleUnvisitableFrameResponse(fetchResponse) {\n console.warn(\n `The response (${fetchResponse.statusCode}) from is performing a full page visit due to turbo-visit-control.`\n )\n\n await this.#visitResponse(fetchResponse.response)\n }\n\n #willHandleFrameMissingFromResponse(fetchResponse) {\n this.element.setAttribute(\"complete\", \"\")\n\n const response = fetchResponse.response\n const visit = async (url, options) => {\n if (url instanceof Response) {\n this.#visitResponse(url)\n } else {\n session.visit(url, options)\n }\n }\n\n const event = dispatch(\"turbo:frame-missing\", {\n target: this.element,\n detail: { response, visit },\n cancelable: true\n })\n\n return !event.defaultPrevented\n }\n\n #handleFrameMissingFromResponse(fetchResponse) {\n this.view.missing()\n this.#throwFrameMissingError(fetchResponse)\n }\n\n #throwFrameMissingError(fetchResponse) {\n const message = `The response (${fetchResponse.statusCode}) did not contain the expected and will be ignored. To perform a full page visit instead, set turbo-visit-control to reload.`\n throw new TurboFrameMissingError(message)\n }\n\n async #visitResponse(response) {\n const wrapped = new FetchResponse(response)\n const responseHTML = await wrapped.responseHTML\n const { location, redirected, statusCode } = wrapped\n\n return session.visit(location, { response: { redirected, statusCode, responseHTML } })\n }\n\n #findFrameElement(element, submitter) {\n const id = getAttribute(\"data-turbo-frame\", submitter, element) || this.element.getAttribute(\"target\")\n const target = this.#getFrameElementById(id)\n\n return target instanceof FrameElement ? target : this.element\n }\n\n async extractForeignFrameElement(container) {\n let element\n const id = CSS.escape(this.id)\n\n try {\n element = activateElement(container.querySelector(`turbo-frame#${id}`), this.sourceURL)\n if (element) {\n return element\n }\n\n element = activateElement(container.querySelector(`turbo-frame[src][recurse~=${id}]`), this.sourceURL)\n if (element) {\n await element.loaded\n return await this.extractForeignFrameElement(element)\n }\n } catch (error) {\n console.error(error)\n return new FrameElement()\n }\n\n return null\n }\n\n #formActionIsVisitable(form, submitter) {\n const action = getAction(form, submitter)\n\n return locationIsVisitable(expandURL(action), this.rootLocation)\n }\n\n #shouldInterceptNavigation(element, submitter) {\n const id = getAttribute(\"data-turbo-frame\", submitter, element) || this.element.getAttribute(\"target\")\n\n if (element instanceof HTMLFormElement && !this.#formActionIsVisitable(element, submitter)) {\n return false\n }\n\n if (!this.enabled || id == \"_top\") {\n return false\n }\n\n if (id) {\n const frameElement = this.#getFrameElementById(id)\n if (frameElement) {\n return !frameElement.disabled\n } else if (id == \"_parent\") {\n return false\n }\n }\n\n if (!session.elementIsNavigatable(element)) {\n return false\n }\n\n if (submitter && !session.elementIsNavigatable(submitter)) {\n return false\n }\n\n return true\n }\n\n // Computed properties\n\n get id() {\n return this.element.id\n }\n\n get disabled() {\n return this.element.disabled\n }\n\n get enabled() {\n return !this.disabled\n }\n\n get sourceURL() {\n if (this.element.src) {\n return this.element.src\n }\n }\n\n set sourceURL(sourceURL) {\n this.#ignoringChangesToAttribute(\"src\", () => {\n this.element.src = sourceURL ?? null\n })\n }\n\n get loadingStyle() {\n return this.element.loading\n }\n\n get isLoading() {\n return this.formSubmission !== undefined || this.#resolveVisitPromise() !== undefined\n }\n\n get complete() {\n return this.element.hasAttribute(\"complete\")\n }\n\n set complete(value) {\n if (value) {\n this.element.setAttribute(\"complete\", \"\")\n } else {\n this.element.removeAttribute(\"complete\")\n }\n }\n\n get isActive() {\n return this.element.isActive && this.#connected\n }\n\n get rootLocation() {\n const meta = this.element.ownerDocument.querySelector(`meta[name=\"turbo-root\"]`)\n const root = meta?.content ?? \"/\"\n return expandURL(root)\n }\n\n #isIgnoringChangesTo(attributeName) {\n return this.#ignoredAttributes.has(attributeName)\n }\n\n #ignoringChangesToAttribute(attributeName, callback) {\n this.#ignoredAttributes.add(attributeName)\n callback()\n this.#ignoredAttributes.delete(attributeName)\n }\n\n #withCurrentNavigationElement(element, callback) {\n this.currentNavigationElement = element\n callback()\n delete this.currentNavigationElement\n }\n\n #getFrameElementById(id) {\n if (id != null) {\n const element = id === \"_parent\" ?\n this.element.parentElement.closest(\"turbo-frame\") :\n document.getElementById(id)\n if (element instanceof FrameElement) {\n return element\n }\n }\n }\n}\n\nfunction activateElement(element, currentURL) {\n if (element) {\n const src = element.getAttribute(\"src\")\n if (src != null && currentURL != null && urlsAreEqual(src, currentURL)) {\n throw new Error(`Matching element has a source URL which references itself`)\n }\n if (element.ownerDocument !== document) {\n element = document.importNode(element, true)\n }\n\n if (element instanceof FrameElement) {\n element.connectedCallback()\n element.disconnectedCallback()\n return element\n }\n }\n}\n" }, { "path": "src/core/frames/frame_redirector.js", "content": "import { FormSubmitObserver } from \"../../observers/form_submit_observer\"\nimport { FrameElement } from \"../../elements/frame_element\"\nimport { LinkInterceptor } from \"./link_interceptor\"\nimport { expandURL, getAction, locationIsVisitable } from \"../url\"\n\nexport class FrameRedirector {\n constructor(session, element) {\n this.session = session\n this.element = element\n this.linkInterceptor = new LinkInterceptor(this, element)\n this.formSubmitObserver = new FormSubmitObserver(this, element)\n }\n\n start() {\n this.linkInterceptor.start()\n this.formSubmitObserver.start()\n }\n\n stop() {\n this.linkInterceptor.stop()\n this.formSubmitObserver.stop()\n }\n\n // Link interceptor delegate\n\n shouldInterceptLinkClick(element, _location, _event) {\n return this.#shouldRedirect(element)\n }\n\n linkClickIntercepted(element, url, event) {\n const frame = this.#findFrameElement(element)\n if (frame) {\n frame.delegate.linkClickIntercepted(element, url, event)\n }\n }\n\n // Form submit observer delegate\n\n willSubmitForm(element, submitter) {\n return (\n element.closest(\"turbo-frame\") == null &&\n this.#shouldSubmit(element, submitter) &&\n this.#shouldRedirect(element, submitter)\n )\n }\n\n formSubmitted(element, submitter) {\n const frame = this.#findFrameElement(element, submitter)\n if (frame) {\n frame.delegate.formSubmitted(element, submitter)\n }\n }\n\n #shouldSubmit(form, submitter) {\n const action = getAction(form, submitter)\n const meta = this.element.ownerDocument.querySelector(`meta[name=\"turbo-root\"]`)\n const rootLocation = expandURL(meta?.content ?? \"/\")\n\n return this.#shouldRedirect(form, submitter) && locationIsVisitable(action, rootLocation)\n }\n\n #shouldRedirect(element, submitter) {\n const isNavigatable =\n element instanceof HTMLFormElement\n ? this.session.submissionIsNavigatable(element, submitter)\n : this.session.elementIsNavigatable(element)\n\n if (isNavigatable) {\n const frame = this.#findFrameElement(element, submitter)\n return frame ? frame != element.closest(\"turbo-frame\") : false\n } else {\n return false\n }\n }\n\n #findFrameElement(element, submitter) {\n const id = submitter?.getAttribute(\"data-turbo-frame\") || element.getAttribute(\"data-turbo-frame\")\n if (id && id != \"_top\") {\n const frame = this.element.querySelector(`#${id}:not([disabled])`)\n if (frame instanceof FrameElement) {\n return frame\n }\n }\n }\n}\n" }, { "path": "src/core/frames/frame_renderer.js", "content": "import { activateScriptElement, nextRepaint } from \"../../util\"\nimport { Renderer } from \"../renderer\"\n\nexport class FrameRenderer extends Renderer {\n static renderElement(currentElement, newElement) {\n const destinationRange = document.createRange()\n destinationRange.selectNodeContents(currentElement)\n destinationRange.deleteContents()\n\n const frameElement = newElement\n const sourceRange = frameElement.ownerDocument?.createRange()\n if (sourceRange) {\n sourceRange.selectNodeContents(frameElement)\n currentElement.appendChild(sourceRange.extractContents())\n }\n }\n\n constructor(delegate, currentSnapshot, newSnapshot, renderElement, isPreview, willRender = true) {\n super(currentSnapshot, newSnapshot, renderElement, isPreview, willRender)\n this.delegate = delegate\n }\n\n get shouldRender() {\n return true\n }\n\n async render() {\n await nextRepaint()\n this.preservingPermanentElements(() => {\n this.loadFrameElement()\n })\n this.scrollFrameIntoView()\n await nextRepaint()\n this.focusFirstAutofocusableElement()\n await nextRepaint()\n this.activateScriptElements()\n }\n\n loadFrameElement() {\n this.delegate.willRenderFrame(this.currentElement, this.newElement)\n this.renderElement(this.currentElement, this.newElement)\n }\n\n scrollFrameIntoView() {\n if (this.currentElement.autoscroll || this.newElement.autoscroll) {\n const element = this.currentElement.firstElementChild\n const block = readScrollLogicalPosition(this.currentElement.getAttribute(\"data-autoscroll-block\"), \"end\")\n const behavior = readScrollBehavior(this.currentElement.getAttribute(\"data-autoscroll-behavior\"), \"auto\")\n\n if (element) {\n element.scrollIntoView({ block, behavior })\n return true\n }\n }\n return false\n }\n\n activateScriptElements() {\n for (const inertScriptElement of this.newScriptElements) {\n const activatedScriptElement = activateScriptElement(inertScriptElement)\n inertScriptElement.replaceWith(activatedScriptElement)\n }\n }\n\n get newScriptElements() {\n return this.currentElement.querySelectorAll(\"script\")\n }\n}\n\nfunction readScrollLogicalPosition(value, defaultValue) {\n if (value == \"end\" || value == \"start\" || value == \"center\" || value == \"nearest\") {\n return value\n } else {\n return defaultValue\n }\n}\n\nfunction readScrollBehavior(value, defaultValue) {\n if (value == \"auto\" || value == \"smooth\") {\n return value\n } else {\n return defaultValue\n }\n}\n" }, { "path": "src/core/frames/frame_view.js", "content": "import { Snapshot } from \"../snapshot\"\nimport { View } from \"../view\"\n\nexport class FrameView extends View {\n missing() {\n this.element.innerHTML = `Content missing`\n }\n\n get snapshot() {\n return new Snapshot(this.element)\n }\n}\n" }, { "path": "src/core/frames/link_interceptor.js", "content": "import { findLinkFromClickTarget } from \"../../util\"\n\nexport class LinkInterceptor {\n constructor(delegate, element) {\n this.delegate = delegate\n this.element = element\n }\n\n start() {\n this.element.addEventListener(\"click\", this.clickBubbled)\n document.addEventListener(\"turbo:click\", this.linkClicked)\n document.addEventListener(\"turbo:before-visit\", this.willVisit)\n }\n\n stop() {\n this.element.removeEventListener(\"click\", this.clickBubbled)\n document.removeEventListener(\"turbo:click\", this.linkClicked)\n document.removeEventListener(\"turbo:before-visit\", this.willVisit)\n }\n\n clickBubbled = (event) => {\n if (this.clickEventIsSignificant(event)) {\n this.clickEvent = event\n } else {\n delete this.clickEvent\n }\n }\n\n linkClicked = (event) => {\n if (this.clickEvent && this.clickEventIsSignificant(event)) {\n if (this.delegate.shouldInterceptLinkClick(event.target, event.detail.url, event.detail.originalEvent)) {\n this.clickEvent.preventDefault()\n event.preventDefault()\n this.delegate.linkClickIntercepted(event.target, event.detail.url, event.detail.originalEvent)\n }\n }\n delete this.clickEvent\n }\n\n willVisit = (_event) => {\n delete this.clickEvent\n }\n\n clickEventIsSignificant(event) {\n const target = event.composed ? event.target?.parentElement : event.target\n const element = findLinkFromClickTarget(target) || target\n\n return element instanceof Element && element.closest(\"turbo-frame, html\") == this.element\n }\n}\n" }, { "path": "src/core/frames/morphing_frame_renderer.js", "content": "import { FrameRenderer } from \"./frame_renderer\"\nimport { morphChildren, shouldRefreshFrameWithMorphing, closestFrameReloadableWithMorphing } from \"../morphing\"\nimport { dispatch } from \"../../util\"\n\nexport class MorphingFrameRenderer extends FrameRenderer {\n static renderElement(currentElement, newElement) {\n dispatch(\"turbo:before-frame-morph\", {\n target: currentElement,\n detail: { currentElement, newElement }\n })\n\n morphChildren(currentElement, newElement, {\n callbacks: {\n beforeNodeMorphed: (node, newNode) => {\n if (\n shouldRefreshFrameWithMorphing(node, newNode) &&\n closestFrameReloadableWithMorphing(node) === currentElement\n ) {\n node.reload()\n return false\n }\n return true\n }\n }\n })\n }\n\n async preservingPermanentElements(callback) {\n return await callback()\n }\n}\n\n" }, { "path": "src/core/index.js", "content": "import { Session } from \"./session\"\nimport { PageRenderer } from \"./drive/page_renderer\"\nimport { PageSnapshot } from \"./drive/page_snapshot\"\nimport { FrameRenderer } from \"./frames/frame_renderer\"\nimport { fetch, recentRequests } from \"../http/fetch\"\nimport { config } from \"./config\"\nimport { MorphingPageRenderer } from \"./drive/morphing_page_renderer\"\nimport { MorphingFrameRenderer } from \"./frames/morphing_frame_renderer\"\n\nexport { morphChildren, morphElements } from \"./morphing\"\nexport { PageRenderer, PageSnapshot, FrameRenderer, fetch, config }\n\nconst session = new Session(recentRequests)\n\n// Rename `navigator` to avoid shadowing `window.navigator`\nconst { cache, navigator: sessionNavigator } = session\nexport { session, cache, sessionNavigator as navigator }\n\n/**\n * Starts the main session.\n * This initialises any necessary observers such as those to monitor\n * link interactions.\n */\nexport function start() {\n session.start()\n}\n\n/**\n * Registers an adapter for the main session.\n *\n * @param adapter Adapter to register\n */\nexport function registerAdapter(adapter) {\n session.registerAdapter(adapter)\n}\n\n/**\n * Performs an application visit to the given location.\n *\n * @param location Location to visit (a URL or path)\n * @param options Options to apply\n * @param options.action Type of history navigation to apply (\"restore\",\n * \"replace\" or \"advance\")\n * @param options.historyChanged Specifies whether the browser history has\n * already been changed for this visit or not\n * @param options.referrer Specifies the referrer of this visit such that\n * navigations to the same page will not result in a new history entry.\n * @param options.snapshotHTML Cached snapshot to render\n * @param options.response Response of the specified location\n */\nexport function visit(location, options) {\n session.visit(location, options)\n}\n\n/**\n * Connects a stream source to the main session.\n *\n * @param source Stream source to connect\n */\nexport function connectStreamSource(source) {\n session.connectStreamSource(source)\n}\n\n/**\n * Disconnects a stream source from the main session.\n *\n * @param source Stream source to disconnect\n */\nexport function disconnectStreamSource(source) {\n session.disconnectStreamSource(source)\n}\n\n/**\n * Renders a stream message to the main session by appending it to the\n * current document.\n *\n * @param message Message to render\n */\nexport function renderStreamMessage(message) {\n session.renderStreamMessage(message)\n}\n\n/**\n * Sets the delay after which the progress bar will appear during navigation.\n *\n * The progress bar appears after 500ms by default.\n *\n * Note that this method has no effect when used with the iOS or Android\n * adapters.\n *\n * @param delay Time to delay in milliseconds\n */\nexport function setProgressBarDelay(delay) {\n console.warn(\n \"Please replace `Turbo.setProgressBarDelay(delay)` with `Turbo.config.drive.progressBarDelay = delay`. The top-level function is deprecated and will be removed in a future version of Turbo.`\"\n )\n config.drive.progressBarDelay = delay\n}\n\nexport function setConfirmMethod(confirmMethod) {\n console.warn(\n \"Please replace `Turbo.setConfirmMethod(confirmMethod)` with `Turbo.config.forms.confirm = confirmMethod`. The top-level function is deprecated and will be removed in a future version of Turbo.`\"\n )\n config.forms.confirm = confirmMethod\n}\n\nexport function setFormMode(mode) {\n console.warn(\n \"Please replace `Turbo.setFormMode(mode)` with `Turbo.config.forms.mode = mode`. The top-level function is deprecated and will be removed in a future version of Turbo.`\"\n )\n config.forms.mode = mode\n}\n\n/**\n * Morph the state of the currentBody based on the attributes and contents of\n * the newBody. Morphing body elements may dispatch turbo:morph,\n * turbo:before-morph-element, turbo:before-morph-attribute, and\n * turbo:morph-element events.\n *\n * @param currentBody HTMLBodyElement destination of morphing changes\n * @param newBody HTMLBodyElement source of morphing changes\n */\nexport function morphBodyElements(currentBody, newBody) {\n MorphingPageRenderer.renderElement(currentBody, newBody)\n}\n\n/**\n * Morph the child elements of the currentFrame based on the child elements of\n * the newFrame. Morphing turbo-frame elements may dispatch turbo:before-frame-morph,\n * turbo:before-morph-element, turbo:before-morph-attribute, and\n * turbo:morph-element events.\n *\n * @param currentFrame FrameElement destination of morphing children changes\n * @param newFrame FrameElement source of morphing children changes\n */\nexport function morphTurboFrameElements(currentFrame, newFrame) {\n MorphingFrameRenderer.renderElement(currentFrame, newFrame)\n}\n" }, { "path": "src/core/lru_cache.js", "content": "const identity = key => key\n\nexport class LRUCache {\n keys = []\n entries = {}\n #toCacheKey\n\n constructor(size, toCacheKey = identity) {\n this.size = size\n this.#toCacheKey = toCacheKey\n }\n\n has(key) {\n return this.#toCacheKey(key) in this.entries\n }\n\n get(key) {\n if (this.has(key)) {\n const entry = this.read(key)\n this.touch(key)\n return entry\n }\n }\n\n put(key, entry) {\n this.write(key, entry)\n this.touch(key)\n return entry\n }\n\n clear() {\n for (const key of Object.keys(this.entries)) {\n this.evict(key)\n }\n }\n\n // Private\n\n read(key) {\n return this.entries[this.#toCacheKey(key)]\n }\n\n write(key, entry) {\n this.entries[this.#toCacheKey(key)] = entry\n }\n\n touch(key) {\n key = this.#toCacheKey(key)\n const index = this.keys.indexOf(key)\n if (index > -1) this.keys.splice(index, 1)\n this.keys.unshift(key)\n this.trim()\n }\n\n trim() {\n for (const key of this.keys.splice(this.size)) {\n this.evict(key)\n }\n }\n\n evict(key) {\n delete this.entries[key]\n }\n}\n" }, { "path": "src/core/morphing.js", "content": "import { Idiomorph } from \"idiomorph\"\nimport { FrameElement } from \"../elements/frame_element\"\nimport { dispatch } from \"../util\"\nimport { urlsAreEqual } from \"./url\"\n\n/**\n * Morph the state of the currentElement based on the attributes and contents of\n * the newElement. Morphing may dispatch turbo:before-morph-element,\n * turbo:before-morph-attribute, and turbo:morph-element events.\n *\n * @param currentElement Element destination of morphing changes\n * @param newElement Element source of morphing changes\n */\nexport function morphElements(currentElement, newElement, { callbacks, ...options } = {}) {\n Idiomorph.morph(currentElement, newElement, {\n ...options,\n callbacks: new DefaultIdiomorphCallbacks(callbacks)\n })\n}\n\n/**\n * Morph the child elements of the currentElement based on the child elements of\n * the newElement. Morphing children may dispatch turbo:before-morph-element,\n * turbo:before-morph-attribute, and turbo:morph-element events.\n *\n * @param currentElement Element destination of morphing children changes\n * @param newElement Element source of morphing children changes\n */\nexport function morphChildren(currentElement, newElement, options = {}) {\n morphElements(currentElement, newElement.childNodes, {\n ...options,\n morphStyle: \"innerHTML\"\n })\n}\n\nexport function shouldRefreshFrameWithMorphing(currentFrame, newFrame) {\n return currentFrame instanceof FrameElement &&\n currentFrame.shouldReloadWithMorph && (!newFrame || areFramesCompatibleForRefreshing(currentFrame, newFrame)) &&\n !currentFrame.closest(\"[data-turbo-permanent]\")\n}\n\nfunction areFramesCompatibleForRefreshing(currentFrame, newFrame) {\n // newFrame cannot yet be an instance of FrameElement because custom\n // elements don't get initialized until they're attached to the DOM, so\n // test its Element#nodeName instead\n return newFrame instanceof Element && newFrame.nodeName === \"TURBO-FRAME\" && currentFrame.id === newFrame.id &&\n (!newFrame.getAttribute(\"src\") || urlsAreEqual(currentFrame.src, newFrame.getAttribute(\"src\")))\n}\n\nexport function closestFrameReloadableWithMorphing(node) {\n return node.parentElement.closest(\"turbo-frame[src][refresh=morph]\")\n}\n\nclass DefaultIdiomorphCallbacks {\n #beforeNodeMorphed\n\n constructor({ beforeNodeMorphed } = {}) {\n this.#beforeNodeMorphed = beforeNodeMorphed || (() => true)\n }\n\n beforeNodeAdded = (node) => {\n return !(node.id && node.hasAttribute(\"data-turbo-permanent\") && document.getElementById(node.id))\n }\n\n beforeNodeMorphed = (currentElement, newElement) => {\n if (currentElement instanceof Element) {\n if (!currentElement.hasAttribute(\"data-turbo-permanent\") && this.#beforeNodeMorphed(currentElement, newElement)) {\n const event = dispatch(\"turbo:before-morph-element\", {\n cancelable: true,\n target: currentElement,\n detail: { currentElement, newElement }\n })\n\n return !event.defaultPrevented\n } else {\n return false\n }\n }\n }\n\n beforeAttributeUpdated = (attributeName, target, mutationType) => {\n const event = dispatch(\"turbo:before-morph-attribute\", {\n cancelable: true,\n target,\n detail: { attributeName, mutationType }\n })\n\n return !event.defaultPrevented\n }\n\n beforeNodeRemoved = (node) => {\n return this.beforeNodeMorphed(node)\n }\n\n afterNodeMorphed = (currentElement, newElement) => {\n if (currentElement instanceof Element) {\n dispatch(\"turbo:morph-element\", {\n target: currentElement,\n detail: { currentElement, newElement }\n })\n }\n }\n}\n" }, { "path": "src/core/native/browser_adapter.js", "content": "import { ProgressBar } from \"../drive/progress_bar\"\nimport { SystemStatusCode } from \"../drive/visit\"\nimport { uuid, dispatch } from \"../../util\"\nimport { locationIsVisitable } from \"../url\"\n\nexport class BrowserAdapter {\n progressBar = new ProgressBar()\n\n constructor(session) {\n this.session = session\n }\n\n visitProposedToLocation(location, options) {\n if (locationIsVisitable(location, this.navigator.rootLocation)) {\n this.navigator.startVisit(location, options?.restorationIdentifier || uuid(), options)\n } else {\n window.location.href = location.toString()\n }\n }\n\n visitStarted(visit) {\n this.location = visit.location\n this.redirectedToLocation = null\n\n visit.loadCachedSnapshot()\n visit.issueRequest()\n }\n\n visitRequestStarted(visit) {\n this.progressBar.setValue(0)\n if (visit.hasCachedSnapshot() || visit.action != \"restore\") {\n this.showVisitProgressBarAfterDelay()\n } else {\n this.showProgressBar()\n }\n }\n\n visitRequestCompleted(visit) {\n visit.loadResponse()\n\n if (visit.response.redirected) {\n this.redirectedToLocation = visit.redirectedToLocation\n }\n }\n\n visitRequestFailedWithStatusCode(visit, statusCode) {\n switch (statusCode) {\n case SystemStatusCode.networkFailure:\n case SystemStatusCode.timeoutFailure:\n case SystemStatusCode.contentTypeMismatch:\n return this.reload({\n reason: \"request_failed\",\n context: {\n statusCode\n }\n })\n default:\n return visit.loadResponse()\n }\n }\n\n visitRequestFinished(_visit) {}\n\n visitCompleted(_visit) {\n this.progressBar.setValue(1)\n this.hideVisitProgressBar()\n }\n\n pageInvalidated(reason) {\n this.reload(reason)\n }\n\n visitFailed(_visit) {\n this.progressBar.setValue(1)\n this.hideVisitProgressBar()\n }\n\n visitRendered(_visit) {}\n\n // Link prefetching\n\n linkPrefetchingIsEnabledForLocation(location) {\n return true\n }\n\n // Form Submission Delegate\n\n formSubmissionStarted(_formSubmission) {\n this.progressBar.setValue(0)\n this.showFormProgressBarAfterDelay()\n }\n\n formSubmissionFinished(_formSubmission) {\n this.progressBar.setValue(1)\n this.hideFormProgressBar()\n }\n\n // Private\n\n showVisitProgressBarAfterDelay() {\n this.visitProgressBarTimeout = window.setTimeout(this.showProgressBar, this.session.progressBarDelay)\n }\n\n hideVisitProgressBar() {\n this.progressBar.hide()\n if (this.visitProgressBarTimeout != null) {\n window.clearTimeout(this.visitProgressBarTimeout)\n delete this.visitProgressBarTimeout\n }\n }\n\n showFormProgressBarAfterDelay() {\n if (this.formProgressBarTimeout == null) {\n this.formProgressBarTimeout = window.setTimeout(this.showProgressBar, this.session.progressBarDelay)\n }\n }\n\n hideFormProgressBar() {\n this.progressBar.hide()\n if (this.formProgressBarTimeout != null) {\n window.clearTimeout(this.formProgressBarTimeout)\n delete this.formProgressBarTimeout\n }\n }\n\n showProgressBar = () => {\n this.progressBar.show()\n }\n\n reload(reason) {\n dispatch(\"turbo:reload\", { detail: reason })\n\n window.location.href = (this.redirectedToLocation || this.location)?.toString() || window.location.href\n }\n\n get navigator() {\n return this.session.navigator\n }\n}\n" }, { "path": "src/core/renderer.js", "content": "import { Bardo } from \"./bardo\"\n\nexport class Renderer {\n #activeElement = null\n\n static renderElement(currentElement, newElement) {\n // Abstract method\n }\n\n constructor(currentSnapshot, newSnapshot, isPreview, willRender = true) {\n this.currentSnapshot = currentSnapshot\n this.newSnapshot = newSnapshot\n this.isPreview = isPreview\n this.willRender = willRender\n this.renderElement = this.constructor.renderElement\n this.promise = new Promise((resolve, reject) => (this.resolvingFunctions = { resolve, reject }))\n }\n\n get shouldRender() {\n return true\n }\n\n get shouldAutofocus() {\n return true\n }\n\n get reloadReason() {\n return\n }\n\n prepareToRender() {\n return\n }\n\n render() {\n // Abstract method\n }\n\n finishRendering() {\n if (this.resolvingFunctions) {\n this.resolvingFunctions.resolve()\n delete this.resolvingFunctions\n }\n }\n\n async preservingPermanentElements(callback) {\n await Bardo.preservingPermanentElements(this, this.permanentElementMap, callback)\n }\n\n focusFirstAutofocusableElement() {\n if (this.shouldAutofocus) {\n const element = this.connectedSnapshot.firstAutofocusableElement\n if (element) {\n element.focus()\n }\n }\n }\n\n // Bardo delegate\n\n enteringBardo(currentPermanentElement) {\n if (this.#activeElement) return\n\n if (currentPermanentElement.contains(this.currentSnapshot.activeElement)) {\n this.#activeElement = this.currentSnapshot.activeElement\n }\n }\n\n leavingBardo(currentPermanentElement) {\n if (currentPermanentElement.contains(this.#activeElement) && this.#activeElement instanceof HTMLElement) {\n this.#activeElement.focus()\n\n this.#activeElement = null\n }\n }\n\n get connectedSnapshot() {\n return this.newSnapshot.isConnected ? this.newSnapshot : this.currentSnapshot\n }\n\n get currentElement() {\n return this.currentSnapshot.element\n }\n\n get newElement() {\n return this.newSnapshot.element\n }\n\n get permanentElementMap() {\n return this.currentSnapshot.getPermanentElementMapForSnapshot(this.newSnapshot)\n }\n\n get renderMethod() {\n return \"replace\"\n }\n}\n" }, { "path": "src/core/session.js", "content": "import { BrowserAdapter } from \"./native/browser_adapter\"\nimport { CacheObserver } from \"../observers/cache_observer\"\nimport { FormSubmitObserver } from \"../observers/form_submit_observer\"\nimport { FrameRedirector } from \"./frames/frame_redirector\"\nimport { History } from \"./drive/history\"\nimport { LinkPrefetchObserver } from \"../observers/link_prefetch_observer\"\nimport { LinkClickObserver } from \"../observers/link_click_observer\"\nimport { FormLinkClickObserver } from \"../observers/form_link_click_observer\"\nimport { getAction, expandURL, locationIsVisitable } from \"./url\"\nimport { Navigator } from \"./drive/navigator\"\nimport { PageObserver } from \"../observers/page_observer\"\nimport { ScrollObserver } from \"../observers/scroll_observer\"\nimport { StreamMessage } from \"./streams/stream_message\"\nimport { StreamMessageRenderer } from \"./streams/stream_message_renderer\"\nimport { StreamObserver } from \"../observers/stream_observer\"\nimport { clearBusyState, dispatch, findClosestRecursively, getVisitAction, markAsBusy, debounce } from \"../util\"\nimport { PageView } from \"./drive/page_view\"\nimport { FrameElement } from \"../elements/frame_element\"\nimport { Preloader } from \"./drive/preloader\"\nimport { Cache } from \"./cache\"\nimport { config } from \"./config\"\n\nexport class Session {\n navigator = new Navigator(this)\n history = new History(this)\n view = new PageView(this, document.documentElement)\n adapter = new BrowserAdapter(this)\n\n pageObserver = new PageObserver(this)\n cacheObserver = new CacheObserver()\n linkPrefetchObserver = new LinkPrefetchObserver(this, document)\n linkClickObserver = new LinkClickObserver(this, window)\n formSubmitObserver = new FormSubmitObserver(this, document)\n scrollObserver = new ScrollObserver(this)\n streamObserver = new StreamObserver(this)\n formLinkClickObserver = new FormLinkClickObserver(this, document.documentElement)\n frameRedirector = new FrameRedirector(this, document.documentElement)\n streamMessageRenderer = new StreamMessageRenderer()\n cache = new Cache(this)\n\n enabled = true\n started = false\n #pageRefreshDebouncePeriod = 150\n\n constructor(recentRequests) {\n this.recentRequests = recentRequests\n this.preloader = new Preloader(this, this.view.snapshotCache)\n this.debouncedRefresh = this.refresh\n this.pageRefreshDebouncePeriod = this.pageRefreshDebouncePeriod\n }\n\n start() {\n if (!this.started) {\n this.pageObserver.start()\n this.cacheObserver.start()\n this.linkPrefetchObserver.start()\n this.formLinkClickObserver.start()\n this.linkClickObserver.start()\n this.formSubmitObserver.start()\n this.scrollObserver.start()\n this.streamObserver.start()\n this.frameRedirector.start()\n this.history.start()\n this.preloader.start()\n this.started = true\n this.enabled = true\n }\n }\n\n disable() {\n this.enabled = false\n }\n\n stop() {\n if (this.started) {\n this.pageObserver.stop()\n this.cacheObserver.stop()\n this.linkPrefetchObserver.stop()\n this.formLinkClickObserver.stop()\n this.linkClickObserver.stop()\n this.formSubmitObserver.stop()\n this.scrollObserver.stop()\n this.streamObserver.stop()\n this.frameRedirector.stop()\n this.history.stop()\n this.preloader.stop()\n this.started = false\n }\n }\n\n registerAdapter(adapter) {\n this.adapter = adapter\n }\n\n visit(location, options = {}) {\n const frameElement = options.frame ? document.getElementById(options.frame) : null\n\n if (frameElement instanceof FrameElement) {\n const action = options.action || getVisitAction(frameElement)\n\n frameElement.delegate.proposeVisitIfNavigatedWithAction(frameElement, action)\n frameElement.src = location.toString()\n } else {\n this.navigator.proposeVisit(expandURL(location), options)\n }\n }\n\n refresh(url, options = {}) {\n options = typeof options === \"string\" ? { requestId: options } : options\n\n const { method, requestId, scroll } = options\n const isRecentRequest = requestId && this.recentRequests.has(requestId)\n const isCurrentUrl = url === document.baseURI\n if (!isRecentRequest && !this.navigator.currentVisit && isCurrentUrl) {\n this.visit(url, { action: \"replace\", shouldCacheSnapshot: false, refresh: { method, scroll } })\n }\n }\n\n connectStreamSource(source) {\n this.streamObserver.connectStreamSource(source)\n }\n\n disconnectStreamSource(source) {\n this.streamObserver.disconnectStreamSource(source)\n }\n\n renderStreamMessage(message) {\n this.streamMessageRenderer.render(StreamMessage.wrap(message))\n }\n\n clearCache() {\n this.view.clearSnapshotCache()\n }\n\n setProgressBarDelay(delay) {\n console.warn(\n \"Please replace `session.setProgressBarDelay(delay)` with `session.progressBarDelay = delay`. The function is deprecated and will be removed in a future version of Turbo.`\"\n )\n\n this.progressBarDelay = delay\n }\n\n set progressBarDelay(delay) {\n config.drive.progressBarDelay = delay\n }\n\n get progressBarDelay() {\n return config.drive.progressBarDelay\n }\n\n set drive(value) {\n config.drive.enabled = value\n }\n\n get drive() {\n return config.drive.enabled\n }\n\n set formMode(value) {\n config.forms.mode = value\n }\n\n get formMode() {\n return config.forms.mode\n }\n\n get location() {\n return this.history.location\n }\n\n get restorationIdentifier() {\n return this.history.restorationIdentifier\n }\n\n get pageRefreshDebouncePeriod() {\n return this.#pageRefreshDebouncePeriod\n }\n\n set pageRefreshDebouncePeriod(value) {\n this.refresh = debounce(this.debouncedRefresh.bind(this), value)\n this.#pageRefreshDebouncePeriod = value\n }\n\n // Preloader delegate\n\n shouldPreloadLink(element) {\n const isUnsafe = element.hasAttribute(\"data-turbo-method\")\n const isStream = element.hasAttribute(\"data-turbo-stream\")\n const frameTarget = element.getAttribute(\"data-turbo-frame\")\n const frame = frameTarget == \"_top\" ?\n null :\n document.getElementById(frameTarget) || findClosestRecursively(element, \"turbo-frame:not([disabled])\")\n\n if (isUnsafe || isStream || frame instanceof FrameElement) {\n return false\n } else {\n const location = new URL(element.href)\n\n return this.elementIsNavigatable(element) && locationIsVisitable(location, this.snapshot.rootLocation)\n }\n }\n\n // History delegate\n\n historyPoppedToLocationWithRestorationIdentifierAndDirection(location, restorationIdentifier, direction) {\n if (this.enabled) {\n this.navigator.startVisit(location, restorationIdentifier, {\n action: \"restore\",\n historyChanged: true,\n direction\n })\n } else {\n this.adapter.pageInvalidated({\n reason: \"turbo_disabled\"\n })\n }\n }\n\n historyPoppedWithEmptyState(location) {\n this.history.replace(location)\n this.view.lastRenderedLocation = location\n this.view.cacheSnapshot()\n }\n\n // Scroll observer delegate\n\n scrollPositionChanged(position) {\n this.history.updateRestorationData({ scrollPosition: position })\n }\n\n // Form click observer delegate\n\n willSubmitFormLinkToLocation(link, location) {\n return this.elementIsNavigatable(link) && locationIsVisitable(location, this.snapshot.rootLocation)\n }\n\n submittedFormLinkToLocation() {}\n\n // Link hover observer delegate\n\n canPrefetchRequestToLocation(link, location) {\n return (\n this.elementIsNavigatable(link) &&\n locationIsVisitable(location, this.snapshot.rootLocation) &&\n this.navigator.linkPrefetchingIsEnabledForLocation(location)\n )\n }\n\n // Link click observer delegate\n\n willFollowLinkToLocation(link, location, event) {\n return (\n this.elementIsNavigatable(link) &&\n locationIsVisitable(location, this.snapshot.rootLocation) &&\n this.applicationAllowsFollowingLinkToLocation(link, location, event)\n )\n }\n\n followedLinkToLocation(link, location) {\n const action = this.getActionForLink(link)\n const acceptsStreamResponse = link.hasAttribute(\"data-turbo-stream\")\n\n this.visit(location.href, { action, acceptsStreamResponse })\n }\n\n // Navigator delegate\n\n allowsVisitingLocationWithAction(location, action) {\n return this.applicationAllowsVisitingLocation(location)\n }\n\n visitProposedToLocation(location, options) {\n extendURLWithDeprecatedProperties(location)\n this.adapter.visitProposedToLocation(location, options)\n }\n\n // Visit delegate\n\n visitStarted(visit) {\n if (!visit.acceptsStreamResponse) {\n markAsBusy(document.documentElement)\n this.view.markVisitDirection(visit.direction)\n }\n extendURLWithDeprecatedProperties(visit.location)\n this.notifyApplicationAfterVisitingLocation(visit.location, visit.action)\n }\n\n visitCompleted(visit) {\n this.view.unmarkVisitDirection()\n clearBusyState(document.documentElement)\n this.notifyApplicationAfterPageLoad(visit.getTimingMetrics())\n }\n\n // Form submit observer delegate\n\n willSubmitForm(form, submitter) {\n const action = getAction(form, submitter)\n\n return (\n this.submissionIsNavigatable(form, submitter) &&\n locationIsVisitable(expandURL(action), this.snapshot.rootLocation)\n )\n }\n\n formSubmitted(form, submitter) {\n this.navigator.submitForm(form, submitter)\n }\n\n // Page observer delegate\n\n pageBecameInteractive() {\n this.view.lastRenderedLocation = this.location\n this.notifyApplicationAfterPageLoad()\n }\n\n pageLoaded() {\n this.history.assumeControlOfScrollRestoration()\n }\n\n pageWillUnload() {\n this.history.relinquishControlOfScrollRestoration()\n }\n\n // Stream observer delegate\n\n receivedMessageFromStream(message) {\n this.renderStreamMessage(message)\n }\n\n // Page view delegate\n\n viewWillCacheSnapshot() {\n this.notifyApplicationBeforeCachingSnapshot()\n }\n\n allowsImmediateRender({ element }, options) {\n const event = this.notifyApplicationBeforeRender(element, options)\n const {\n defaultPrevented,\n detail: { render }\n } = event\n\n if (this.view.renderer && render) {\n this.view.renderer.renderElement = render\n }\n\n return !defaultPrevented\n }\n\n viewRenderedSnapshot(_snapshot, _isPreview, renderMethod) {\n this.view.lastRenderedLocation = this.history.location\n this.notifyApplicationAfterRender(renderMethod)\n }\n\n preloadOnLoadLinksForView(element) {\n this.preloader.preloadOnLoadLinksForView(element)\n }\n\n viewInvalidated(reason) {\n this.adapter.pageInvalidated(reason)\n }\n\n // Frame element\n\n frameLoaded(frame) {\n this.notifyApplicationAfterFrameLoad(frame)\n }\n\n frameRendered(fetchResponse, frame) {\n this.notifyApplicationAfterFrameRender(fetchResponse, frame)\n }\n\n // Application events\n\n applicationAllowsFollowingLinkToLocation(link, location, ev) {\n const event = this.notifyApplicationAfterClickingLinkToLocation(link, location, ev)\n return !event.defaultPrevented\n }\n\n applicationAllowsVisitingLocation(location) {\n const event = this.notifyApplicationBeforeVisitingLocation(location)\n return !event.defaultPrevented\n }\n\n notifyApplicationAfterClickingLinkToLocation(link, location, event) {\n return dispatch(\"turbo:click\", {\n target: link,\n detail: { url: location.href, originalEvent: event },\n cancelable: true\n })\n }\n\n notifyApplicationBeforeVisitingLocation(location) {\n return dispatch(\"turbo:before-visit\", {\n detail: { url: location.href },\n cancelable: true\n })\n }\n\n notifyApplicationAfterVisitingLocation(location, action) {\n return dispatch(\"turbo:visit\", { detail: { url: location.href, action } })\n }\n\n notifyApplicationBeforeCachingSnapshot() {\n return dispatch(\"turbo:before-cache\")\n }\n\n notifyApplicationBeforeRender(newBody, options) {\n return dispatch(\"turbo:before-render\", {\n detail: { newBody, ...options },\n cancelable: true\n })\n }\n\n notifyApplicationAfterRender(renderMethod) {\n return dispatch(\"turbo:render\", { detail: { renderMethod } })\n }\n\n notifyApplicationAfterPageLoad(timing = {}) {\n return dispatch(\"turbo:load\", {\n detail: { url: this.location.href, timing }\n })\n }\n\n notifyApplicationAfterFrameLoad(frame) {\n return dispatch(\"turbo:frame-load\", { target: frame })\n }\n\n notifyApplicationAfterFrameRender(fetchResponse, frame) {\n return dispatch(\"turbo:frame-render\", {\n detail: { fetchResponse },\n target: frame,\n cancelable: true\n })\n }\n\n // Helpers\n\n submissionIsNavigatable(form, submitter) {\n if (config.forms.mode == \"off\") {\n return false\n } else {\n const submitterIsNavigatable = submitter ? this.elementIsNavigatable(submitter) : true\n\n if (config.forms.mode == \"optin\") {\n return submitterIsNavigatable && form.closest('[data-turbo=\"true\"]') != null\n } else {\n return submitterIsNavigatable && this.elementIsNavigatable(form)\n }\n }\n }\n\n elementIsNavigatable(element) {\n const container = findClosestRecursively(element, \"[data-turbo]\")\n const withinFrame = findClosestRecursively(element, \"turbo-frame\")\n\n // Check if Drive is enabled on the session or we're within a Frame.\n if (config.drive.enabled || withinFrame) {\n // Element is navigatable by default, unless `data-turbo=\"false\"`.\n if (container) {\n return container.getAttribute(\"data-turbo\") != \"false\"\n } else {\n return true\n }\n } else {\n // Element isn't navigatable by default, unless `data-turbo=\"true\"`.\n if (container) {\n return container.getAttribute(\"data-turbo\") == \"true\"\n } else {\n return false\n }\n }\n }\n\n // Private\n\n getActionForLink(link) {\n return getVisitAction(link) || \"advance\"\n }\n\n get snapshot() {\n return this.view.snapshot\n }\n}\n\n// Older versions of the Turbo Native adapters referenced the\n// `Location#absoluteURL` property in their implementations of\n// the `Adapter#visitProposedToLocation()` and `#visitStarted()`\n// methods. The Location class has since been removed in favor\n// of the DOM URL API, and accordingly all Adapter methods now\n// receive URL objects.\n//\n// We alias #absoluteURL to #toString() here to avoid crashing\n// older adapters which do not expect URL objects. We should\n// consider removing this support at some point in the future.\n\nfunction extendURLWithDeprecatedProperties(url) {\n Object.defineProperties(url, deprecatedLocationPropertyDescriptors)\n}\n\nconst deprecatedLocationPropertyDescriptors = {\n absoluteURL: {\n get() {\n return this.toString()\n }\n }\n}\n" }, { "path": "src/core/snapshot.js", "content": "import { queryAutofocusableElement } from \"../util\"\n\nexport class Snapshot {\n constructor(element) {\n this.element = element\n }\n\n get activeElement() {\n return this.element.ownerDocument.activeElement\n }\n\n get children() {\n return [...this.element.children]\n }\n\n hasAnchor(anchor) {\n return this.getElementForAnchor(anchor) != null\n }\n\n getElementForAnchor(anchor) {\n return anchor ? this.element.querySelector(`[id='${anchor}'], a[name='${anchor}']`) : null\n }\n\n get isConnected() {\n return this.element.isConnected\n }\n\n get firstAutofocusableElement() {\n return queryAutofocusableElement(this.element)\n }\n\n get permanentElements() {\n return queryPermanentElementsAll(this.element)\n }\n\n getPermanentElementById(id) {\n return getPermanentElementById(this.element, id)\n }\n\n getPermanentElementMapForSnapshot(snapshot) {\n const permanentElementMap = {}\n\n for (const currentPermanentElement of this.permanentElements) {\n const { id } = currentPermanentElement\n const newPermanentElement = snapshot.getPermanentElementById(id)\n if (newPermanentElement) {\n permanentElementMap[id] = [currentPermanentElement, newPermanentElement]\n }\n }\n\n return permanentElementMap\n }\n}\n\nexport function getPermanentElementById(node, id) {\n return node.querySelector(`#${id}[data-turbo-permanent]`)\n}\n\nexport function queryPermanentElementsAll(node) {\n return node.querySelectorAll(\"[id][data-turbo-permanent]\")\n}\n" }, { "path": "src/core/streams/stream_actions.js", "content": "import { session } from \"../\"\nimport { morphElements, morphChildren } from \"../morphing\"\n\nexport const StreamActions = {\n after() {\n this.removeDuplicateTargetSiblings()\n this.targetElements.forEach((e) => e.parentElement?.insertBefore(this.templateContent, e.nextSibling))\n },\n\n append() {\n this.removeDuplicateTargetChildren()\n this.targetElements.forEach((e) => e.append(this.templateContent))\n },\n\n before() {\n this.removeDuplicateTargetSiblings()\n this.targetElements.forEach((e) => e.parentElement?.insertBefore(this.templateContent, e))\n },\n\n prepend() {\n this.removeDuplicateTargetChildren()\n this.targetElements.forEach((e) => e.prepend(this.templateContent))\n },\n\n remove() {\n this.targetElements.forEach((e) => e.remove())\n },\n\n replace() {\n const method = this.getAttribute(\"method\")\n\n this.targetElements.forEach((targetElement) => {\n if (method === \"morph\") {\n morphElements(targetElement, this.templateContent)\n } else {\n targetElement.replaceWith(this.templateContent)\n }\n })\n },\n\n update() {\n const method = this.getAttribute(\"method\")\n\n this.targetElements.forEach((targetElement) => {\n if (method === \"morph\") {\n morphChildren(targetElement, this.templateContent)\n } else {\n targetElement.innerHTML = \"\"\n targetElement.append(this.templateContent)\n }\n })\n },\n\n refresh() {\n const method = this.getAttribute(\"method\")\n const requestId = this.requestId\n const scroll = this.getAttribute(\"scroll\")\n\n session.refresh(this.baseURI, { method, requestId, scroll })\n }\n}\n" }, { "path": "src/core/streams/stream_message.js", "content": "import { activateScriptElement, createDocumentFragment } from \"../../util\"\n\nexport class StreamMessage {\n static contentType = \"text/vnd.turbo-stream.html\"\n\n static wrap(message) {\n if (typeof message == \"string\") {\n return new this(createDocumentFragment(message))\n } else {\n return message\n }\n }\n\n constructor(fragment) {\n this.fragment = importStreamElements(fragment)\n }\n}\n\nfunction importStreamElements(fragment) {\n for (const element of fragment.querySelectorAll(\"turbo-stream\")) {\n const streamElement = document.importNode(element, true)\n\n for (const inertScriptElement of streamElement.templateElement.content.querySelectorAll(\"script\")) {\n inertScriptElement.replaceWith(activateScriptElement(inertScriptElement))\n }\n\n element.replaceWith(streamElement)\n }\n\n return fragment\n}\n" }, { "path": "src/core/streams/stream_message_renderer.js", "content": "import { Bardo } from \"../bardo\"\nimport { getPermanentElementById, queryPermanentElementsAll } from \"../snapshot\"\nimport { around, elementIsFocusable, nextRepaint, queryAutofocusableElement, uuid } from \"../../util\"\n\nexport class StreamMessageRenderer {\n render({ fragment }) {\n Bardo.preservingPermanentElements(this, getPermanentElementMapForFragment(fragment), () => {\n withAutofocusFromFragment(fragment, () => {\n withPreservedFocus(() => {\n document.documentElement.appendChild(fragment)\n })\n })\n })\n }\n\n // Bardo delegate\n\n enteringBardo(currentPermanentElement, newPermanentElement) {\n newPermanentElement.replaceWith(currentPermanentElement.cloneNode(true))\n }\n\n leavingBardo() {}\n}\n\nfunction getPermanentElementMapForFragment(fragment) {\n const permanentElementsInDocument = queryPermanentElementsAll(document.documentElement)\n const permanentElementMap = {}\n for (const permanentElementInDocument of permanentElementsInDocument) {\n const { id } = permanentElementInDocument\n\n for (const streamElement of fragment.querySelectorAll(\"turbo-stream\")) {\n const elementInStream = getPermanentElementById(streamElement.templateElement.content, id)\n\n if (elementInStream) {\n permanentElementMap[id] = [permanentElementInDocument, elementInStream]\n }\n }\n }\n\n return permanentElementMap\n}\n\nasync function withAutofocusFromFragment(fragment, callback) {\n const generatedID = `turbo-stream-autofocus-${uuid()}`\n const turboStreams = fragment.querySelectorAll(\"turbo-stream\")\n const elementWithAutofocus = firstAutofocusableElementInStreams(turboStreams)\n let willAutofocusId = null\n\n if (elementWithAutofocus) {\n if (elementWithAutofocus.id) {\n willAutofocusId = elementWithAutofocus.id\n } else {\n willAutofocusId = generatedID\n }\n\n elementWithAutofocus.id = willAutofocusId\n }\n\n callback()\n await nextRepaint()\n\n const hasNoActiveElement = document.activeElement == null || document.activeElement == document.body\n\n if (hasNoActiveElement && willAutofocusId) {\n const elementToAutofocus = document.getElementById(willAutofocusId)\n\n if (elementIsFocusable(elementToAutofocus)) {\n elementToAutofocus.focus()\n }\n if (elementToAutofocus && elementToAutofocus.id == generatedID) {\n elementToAutofocus.removeAttribute(\"id\")\n }\n }\n}\n\nasync function withPreservedFocus(callback) {\n const [activeElementBeforeRender, activeElementAfterRender] = await around(callback, () => document.activeElement)\n\n const restoreFocusTo = activeElementBeforeRender && activeElementBeforeRender.id\n\n if (restoreFocusTo) {\n const elementToFocus = document.getElementById(restoreFocusTo)\n\n if (elementIsFocusable(elementToFocus) && elementToFocus != activeElementAfterRender) {\n elementToFocus.focus()\n }\n }\n}\n\nfunction firstAutofocusableElementInStreams(nodeListOfStreamElements) {\n for (const streamElement of nodeListOfStreamElements) {\n const elementWithAutofocus = queryAutofocusableElement(streamElement.templateElement.content)\n\n if (elementWithAutofocus) return elementWithAutofocus\n }\n\n return null\n}\n" }, { "path": "src/core/url.js", "content": "import { config } from \"./config\"\n\nexport function expandURL(locatable) {\n return new URL(locatable.toString(), document.baseURI)\n}\n\nexport function getAnchor(url) {\n let anchorMatch\n if (url.hash) {\n return url.hash.slice(1)\n // eslint-disable-next-line no-cond-assign\n } else if ((anchorMatch = url.href.match(/#(.*)$/))) {\n return anchorMatch[1]\n }\n}\n\nexport function getAction(form, submitter) {\n const action = submitter?.getAttribute(\"formaction\") || form.getAttribute(\"action\") || form.action\n\n return expandURL(action)\n}\n\nexport function getExtension(url) {\n return (getLastPathComponent(url).match(/\\.[^.]*$/) || [])[0] || \"\"\n}\n\nexport function isPrefixedBy(baseURL, url) {\n const prefix = addTrailingSlash(url.origin + url.pathname)\n return addTrailingSlash(baseURL.href) === prefix || baseURL.href.startsWith(prefix)\n}\n\nexport function locationIsVisitable(location, rootLocation) {\n return isPrefixedBy(location, rootLocation) && !config.drive.unvisitableExtensions.has(getExtension(location))\n}\n\nexport function getLocationForLink(link) {\n return expandURL(link.getAttribute(\"href\") || \"\")\n}\n\nexport function getRequestURL(url) {\n const anchor = getAnchor(url)\n return anchor != null ? url.href.slice(0, -(anchor.length + 1)) : url.href\n}\n\nexport function toCacheKey(url) {\n return getRequestURL(url)\n}\n\nexport function urlsAreEqual(left, right) {\n return expandURL(left).href == expandURL(right).href\n}\n\nfunction getPathComponents(url) {\n return url.pathname.split(\"/\").slice(1)\n}\n\nfunction getLastPathComponent(url) {\n return getPathComponents(url).slice(-1)[0]\n}\n\nfunction addTrailingSlash(value) {\n return value.endsWith(\"/\") ? value : value + \"/\"\n}\n" }, { "path": "src/core/view.js", "content": "import { getAnchor } from \"./url\"\n\nexport class View {\n #resolveRenderPromise = (_value) => {}\n #resolveInterceptionPromise = (_value) => {}\n\n constructor(delegate, element) {\n this.delegate = delegate\n this.element = element\n }\n\n // Scrolling\n\n scrollToAnchor(anchor) {\n const element = this.snapshot.getElementForAnchor(anchor)\n if (element) {\n this.focusElement(element)\n this.scrollToElement(element)\n } else {\n this.scrollToPosition({ x: 0, y: 0 })\n }\n }\n\n scrollToAnchorFromLocation(location) {\n this.scrollToAnchor(getAnchor(location))\n }\n\n scrollToElement(element) {\n element.scrollIntoView()\n }\n\n focusElement(element) {\n if (element instanceof HTMLElement) {\n if (element.hasAttribute(\"tabindex\")) {\n element.focus()\n } else {\n element.setAttribute(\"tabindex\", \"-1\")\n element.focus()\n element.removeAttribute(\"tabindex\")\n }\n }\n }\n\n scrollToPosition({ x, y }) {\n this.scrollRoot.scrollTo(x, y)\n }\n\n scrollToTop() {\n this.scrollToPosition({ x: 0, y: 0 })\n }\n\n get scrollRoot() {\n return window\n }\n\n // Rendering\n\n async render(renderer) {\n const { isPreview, shouldRender, willRender, newSnapshot: snapshot } = renderer\n\n // A workaround to ignore tracked element mismatch reloads when performing\n // a promoted Visit from a frame navigation\n const shouldInvalidate = willRender\n\n if (shouldRender) {\n try {\n this.renderPromise = new Promise((resolve) => (this.#resolveRenderPromise = resolve))\n this.renderer = renderer\n await this.prepareToRenderSnapshot(renderer)\n\n const renderInterception = new Promise((resolve) => (this.#resolveInterceptionPromise = resolve))\n const options = { resume: this.#resolveInterceptionPromise, render: this.renderer.renderElement, renderMethod: this.renderer.renderMethod }\n const immediateRender = this.delegate.allowsImmediateRender(snapshot, options)\n if (!immediateRender) await renderInterception\n\n await this.renderSnapshot(renderer)\n this.delegate.viewRenderedSnapshot(snapshot, isPreview, this.renderer.renderMethod)\n this.delegate.preloadOnLoadLinksForView(this.element)\n this.finishRenderingSnapshot(renderer)\n } finally {\n delete this.renderer\n this.#resolveRenderPromise(undefined)\n delete this.renderPromise\n }\n } else if (shouldInvalidate) {\n this.invalidate(renderer.reloadReason)\n }\n }\n\n invalidate(reason) {\n this.delegate.viewInvalidated(reason)\n }\n\n async prepareToRenderSnapshot(renderer) {\n this.markAsPreview(renderer.isPreview)\n await renderer.prepareToRender()\n }\n\n markAsPreview(isPreview) {\n if (isPreview) {\n this.element.setAttribute(\"data-turbo-preview\", \"\")\n } else {\n this.element.removeAttribute(\"data-turbo-preview\")\n }\n }\n\n markVisitDirection(direction) {\n this.element.setAttribute(\"data-turbo-visit-direction\", direction)\n }\n\n unmarkVisitDirection() {\n this.element.removeAttribute(\"data-turbo-visit-direction\")\n }\n\n async renderSnapshot(renderer) {\n await renderer.render()\n }\n\n finishRenderingSnapshot(renderer) {\n renderer.finishRendering()\n }\n}\n" }, { "path": "src/elements/frame_element.js", "content": "export const FrameLoadingStyle = {\n eager: \"eager\",\n lazy: \"lazy\"\n}\n\n/**\n * Contains a fragment of HTML which is updated based on navigation within\n * it (e.g. via links or form submissions).\n *\n * @customElement turbo-frame\n * @example\n * \n * \n * Show all expanded messages in this frame.\n * \n *\n *
\n * Show response from this form within this frame.\n *
\n * \n */\nexport class FrameElement extends HTMLElement {\n static delegateConstructor = undefined\n\n loaded = Promise.resolve()\n\n static get observedAttributes() {\n return [\"disabled\", \"loading\", \"src\"]\n }\n\n constructor() {\n super()\n this.delegate = new FrameElement.delegateConstructor(this)\n }\n\n connectedCallback() {\n this.delegate.connect()\n }\n\n disconnectedCallback() {\n this.delegate.disconnect()\n }\n\n reload() {\n return this.delegate.sourceURLReloaded()\n }\n\n attributeChangedCallback(name) {\n if (name == \"loading\") {\n this.delegate.loadingStyleChanged()\n } else if (name == \"src\") {\n this.delegate.sourceURLChanged()\n } else if (name == \"disabled\") {\n this.delegate.disabledChanged()\n }\n }\n\n /**\n * Gets the URL to lazily load source HTML from\n */\n get src() {\n return this.getAttribute(\"src\")\n }\n\n /**\n * Sets the URL to lazily load source HTML from\n */\n set src(value) {\n if (value) {\n this.setAttribute(\"src\", value)\n } else {\n this.removeAttribute(\"src\")\n }\n }\n\n /**\n * Gets the refresh mode for the frame.\n */\n get refresh() {\n return this.getAttribute(\"refresh\")\n }\n\n /**\n * Sets the refresh mode for the frame.\n */\n set refresh(value) {\n if (value) {\n this.setAttribute(\"refresh\", value)\n } else {\n this.removeAttribute(\"refresh\")\n }\n }\n\n get shouldReloadWithMorph() {\n return this.src && this.refresh === \"morph\"\n }\n\n /**\n * Determines if the element is loading\n */\n get loading() {\n return frameLoadingStyleFromString(this.getAttribute(\"loading\") || \"\")\n }\n\n /**\n * Sets the value of if the element is loading\n */\n set loading(value) {\n if (value) {\n this.setAttribute(\"loading\", value)\n } else {\n this.removeAttribute(\"loading\")\n }\n }\n\n /**\n * Gets the disabled state of the frame.\n *\n * If disabled, no requests will be intercepted by the frame.\n */\n get disabled() {\n return this.hasAttribute(\"disabled\")\n }\n\n /**\n * Sets the disabled state of the frame.\n *\n * If disabled, no requests will be intercepted by the frame.\n */\n set disabled(value) {\n if (value) {\n this.setAttribute(\"disabled\", \"\")\n } else {\n this.removeAttribute(\"disabled\")\n }\n }\n\n /**\n * Gets the autoscroll state of the frame.\n *\n * If true, the frame will be scrolled into view automatically on update.\n */\n get autoscroll() {\n return this.hasAttribute(\"autoscroll\")\n }\n\n /**\n * Sets the autoscroll state of the frame.\n *\n * If true, the frame will be scrolled into view automatically on update.\n */\n set autoscroll(value) {\n if (value) {\n this.setAttribute(\"autoscroll\", \"\")\n } else {\n this.removeAttribute(\"autoscroll\")\n }\n }\n\n /**\n * Determines if the element has finished loading\n */\n get complete() {\n return !this.delegate.isLoading\n }\n\n /**\n * Gets the active state of the frame.\n *\n * If inactive, source changes will not be observed.\n */\n get isActive() {\n return this.ownerDocument === document && !this.isPreview\n }\n\n /**\n * Sets the active state of the frame.\n *\n * If inactive, source changes will not be observed.\n */\n get isPreview() {\n return this.ownerDocument?.documentElement?.hasAttribute(\"data-turbo-preview\")\n }\n}\n\nfunction frameLoadingStyleFromString(style) {\n switch (style.toLowerCase()) {\n case \"lazy\":\n return FrameLoadingStyle.lazy\n default:\n return FrameLoadingStyle.eager\n }\n}\n" }, { "path": "src/elements/index.js", "content": "import { FrameController } from \"../core/frames/frame_controller\"\nimport { FrameElement } from \"./frame_element\"\nimport { StreamElement } from \"./stream_element\"\nimport { StreamSourceElement } from \"./stream_source_element\"\n\nFrameElement.delegateConstructor = FrameController\n\nexport * from \"./frame_element\"\nexport * from \"./stream_element\"\nexport * from \"./stream_source_element\"\n\nif (customElements.get(\"turbo-frame\") === undefined) {\n customElements.define(\"turbo-frame\", FrameElement)\n}\n\nif (customElements.get(\"turbo-stream\") === undefined) {\n customElements.define(\"turbo-stream\", StreamElement)\n}\n\nif (customElements.get(\"turbo-stream-source\") === undefined) {\n customElements.define(\"turbo-stream-source\", StreamSourceElement)\n}\n" }, { "path": "src/elements/stream_element.js", "content": "import { StreamActions } from \"../core/streams/stream_actions\"\nimport { nextRepaint } from \"../util\"\n\n//