Astro Integration System (#2820)

* update examples

* add initial integrations

* update tests

* update astro

* update ci

* get final tests working

* update injectelement todo

* update ben code review

* respond to final code review feedback

4 files changed, 59 insertions, 0 deletions

diff --git a/packages/integrations/turbolinks/client.js b/packages/integrations/turbolinks/client.js
new file mode 100644
index 000000000..6dde8c193
--- /dev/null
+++ b/packages/integrations/turbolinks/client.js
@@ -0,0 +1,2 @@
+import Turbolinks from 'turbolinks';
+export { Turbolinks };
diff --git a/packages/integrations/turbolinks/package.json b/packages/integrations/turbolinks/package.json
new file mode 100644
index 000000000..99834fe77
--- /dev/null
+++ b/packages/integrations/turbolinks/package.json
@@ -0,0 +1,32 @@
+{
+  "name": "@astrojs/turbolinks",
+  "description": "Turbolinks + Astro Integrations",
+  "version": "0.0.1",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "author": "withastro",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/withastro/astro.git",
+    "directory": "packages/integrations/turbolinks"
+  },
+  "bugs": "https://github.com/withastro/astro/issues",
+  "homepage": "https://astro.build",
+  "exports": {
+    ".": "./dist/index.js",
+    "./client.js": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "astro-scripts build \"src/**/*.ts\" && tsc",
+    "dev": "astro-scripts dev \"src/**/*.ts\""
+  },
+  "dependencies": {
+    "turbolinks": "^5.2.0"
+  },
+  "devDependencies": {
+    "astro": "workspace:*",
+    "astro-scripts": "workspace:*"
+  }
+}
diff --git a/packages/integrations/turbolinks/src/index.ts b/packages/integrations/turbolinks/src/index.ts
new file mode 100644
index 000000000..3299736ba
--- /dev/null
+++ b/packages/integrations/turbolinks/src/index.ts
@@ -0,0 +1,15 @@
+import type { AstroIntegration } from 'astro';
+
+export default function createPlugin(): AstroIntegration {
+	return {
+		name: '@astrojs/turbolinks',
+		hooks: {
+			'astro:config:setup': ({ injectScript }) => {
+				// This gets injected into the user's page, so we need to re-export Turbolinks
+				// from our own package so that package managers like pnpm don't get mad and
+				// can follow the import correctly.
+				injectScript('page', `import {Turbolinks} from "@astrojs/turbolinks/client.js"; Turbolinks.start();`);
+			},
+		},
+	};
+}
diff --git a/packages/integrations/turbolinks/tsconfig.json b/packages/integrations/turbolinks/tsconfig.json
new file mode 100644
index 000000000..44baf375c
--- /dev/null
+++ b/packages/integrations/turbolinks/tsconfig.json
@@ -0,0 +1,10 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "allowJs": true,
+    "module": "ES2020",
+    "outDir": "./dist",
+    "target": "ES2020"
+  }
+}