@prismicio/adapter-nuxt 0.0.1

package/dist/plugin.js

@@ -0,0 +1,144 @@
+import { definePlugin } from "@prismicio/plugin-kit";
+import { writeSliceModel, upsertGlobalTypeScriptTypes, renameSlice, deleteSliceDirectory, readSliceModel, readSliceLibrary, writeCustomTypeModel, renameCustomType, deleteCustomTypeDirectory, readCustomTypeModel, readCustomTypeLibrary } from "@prismicio/plugin-kit/fs";
+import { name } from "./package.json.js";
+import { projectInit } from "./hooks/project-init.js";
+import { sliceCreate } from "./hooks/slice-create.js";
+import { rejectIfNecessary } from "./lib/rejectIfNecessary.js";
+import { upsertSliceLibraryIndexFile } from "./lib/upsertSliceLibraryIndexFile.js";
+const plugin = definePlugin({
+  meta: {
+    name
+  },
+  defaultOptions: {
+    format: true,
+    lazyLoadSlices: true
+  },
+  setup({ hook }) {
+    hook("project:init", projectInit);
+    hook("slice:create", sliceCreate);
+    hook("slice:update", async (data, context) => {
+      await writeSliceModel({
+        libraryID: data.libraryID,
+        model: data.model,
+        ...context
+      });
+      await upsertGlobalTypeScriptTypes({
+        filename: context.options.generatedTypesFilePath,
+        format: context.options.format,
+        ...context
+      });
+    });
+    hook("slice:rename", async (data, context) => {
+      await renameSlice({
+        libraryID: data.libraryID,
+        model: data.model,
+        format: context.options.format,
+        ...context
+      });
+      rejectIfNecessary(await Promise.allSettled([
+        upsertSliceLibraryIndexFile({
+          libraryID: data.libraryID,
+          ...context
+        }),
+        upsertGlobalTypeScriptTypes({
+          filename: context.options.generatedTypesFilePath,
+          format: context.options.format,
+          ...context
+        })
+      ]));
+    });
+    hook("slice:delete", async (data, context) => {
+      await deleteSliceDirectory({
+        libraryID: data.libraryID,
+        model: data.model,
+        ...context
+      });
+      rejectIfNecessary(await Promise.allSettled([
+        upsertSliceLibraryIndexFile({
+          libraryID: data.libraryID,
+          ...context
+        }),
+        upsertGlobalTypeScriptTypes({
+          filename: context.options.generatedTypesFilePath,
+          format: context.options.format,
+          ...context
+        })
+      ]));
+    });
+    hook("slice:read", async (data, context) => {
+      return await readSliceModel({
+        libraryID: data.libraryID,
+        sliceID: data.sliceID,
+        ...context
+      });
+    });
+    hook("slice-library:read", async (data, context) => {
+      return await readSliceLibrary({
+        libraryID: data.libraryID,
+        ...context
+      });
+    });
+    hook("custom-type:create", async (data, context) => {
+      await writeCustomTypeModel({
+        model: data.model,
+        format: context.options.format,
+        ...context
+      });
+      await upsertGlobalTypeScriptTypes({
+        filename: context.options.generatedTypesFilePath,
+        format: context.options.format,
+        ...context
+      });
+    });
+    hook("custom-type:update", async (data, context) => {
+      await writeCustomTypeModel({
+        model: data.model,
+        format: context.options.format,
+        ...context
+      });
+      await upsertGlobalTypeScriptTypes({
+        filename: context.options.generatedTypesFilePath,
+        format: context.options.format,
+        ...context
+      });
+    });
+    hook("custom-type:rename", async (data, context) => {
+      await renameCustomType({
+        model: data.model,
+        format: context.options.format,
+        ...context
+      });
+      await upsertGlobalTypeScriptTypes({
+        filename: context.options.generatedTypesFilePath,
+        format: context.options.format,
+        ...context
+      });
+    });
+    hook("custom-type:delete", async (data, context) => {
+      await deleteCustomTypeDirectory({
+        customTypeID: data.model.id,
+        ...context
+      });
+      await upsertGlobalTypeScriptTypes({
+        filename: context.options.generatedTypesFilePath,
+        format: context.options.format,
+        ...context
+      });
+    });
+    hook("custom-type:read", async (data, context) => {
+      return await readCustomTypeModel({
+        customTypeID: data.id,
+        ...context
+      });
+    });
+    hook("custom-type-library:read", async (_data, context) => {
+      return await readCustomTypeLibrary({
+        helpers: context.helpers
+      });
+    });
+  }
+});
+export {
+  plugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["../../src/plugin.ts"],"sourcesContent":["import { definePlugin } from \"@prismicio/plugin-kit\";\nimport {\n\tdeleteCustomTypeDirectory,\n\tdeleteSliceDirectory,\n\treadCustomTypeLibrary,\n\treadCustomTypeModel,\n\treadSliceLibrary,\n\treadSliceModel,\n\trenameCustomType,\n\trenameSlice,\n\tupsertGlobalTypeScriptTypes,\n\twriteCustomTypeModel,\n\twriteSliceModel,\n} from \"@prismicio/plugin-kit/fs\";\n\nimport { name as pkgName } from \"../package.json\";\n\nimport { projectInit } from \"./hooks/project-init\";\nimport { sliceCreate } from \"./hooks/slice-create\";\nimport { rejectIfNecessary } from \"./lib/rejectIfNecessary\";\nimport { upsertSliceLibraryIndexFile } from \"./lib/upsertSliceLibraryIndexFile\";\nimport { PluginOptions } from \"./types\";\n\nexport const plugin = definePlugin<PluginOptions>({\n\tmeta: {\n\t\tname: pkgName,\n\t},\n\tdefaultOptions: {\n\t\tformat: true,\n\t\tlazyLoadSlices: true,\n\t},\n\tsetup({ hook }) {\n\t\t////////////////////////////////////////////////////////////////\n\t\t// project:*\n\t\t////////////////////////////////////////////////////////////////\n\n\t\thook(\"project:init\", projectInit);\n\n\t\t////////////////////////////////////////////////////////////////\n\t\t// slice:*\n\t\t////////////////////////////////////////////////////////////////\n\n\t\thook(\"slice:create\", sliceCreate);\n\t\thook(\"slice:update\", async (data, context) => {\n\t\t\tawait writeSliceModel({\n\t\t\t\tlibraryID: data.libraryID,\n\t\t\t\tmodel: data.model,\n\t\t\t\t...context,\n\t\t\t});\n\n\t\t\tawait upsertGlobalTypeScriptTypes({\n\t\t\t\tfilename: context.options.generatedTypesFilePath,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\t\thook(\"slice:rename\", async (data, context) => {\n\t\t\tawait renameSlice({\n\t\t\t\tlibraryID: data.libraryID,\n\t\t\t\tmodel: data.model,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\n\t\t\trejectIfNecessary(\n\t\t\t\tawait Promise.allSettled([\n\t\t\t\t\tupsertSliceLibraryIndexFile({\n\t\t\t\t\t\tlibraryID: data.libraryID,\n\t\t\t\t\t\t...context,\n\t\t\t\t\t}),\n\t\t\t\t\tupsertGlobalTypeScriptTypes({\n\t\t\t\t\t\tfilename: context.options.generatedTypesFilePath,\n\t\t\t\t\t\tformat: context.options.format,\n\t\t\t\t\t\t...context,\n\t\t\t\t\t}),\n\t\t\t\t]),\n\t\t\t);\n\t\t});\n\t\thook(\"slice:delete\", async (data, context) => {\n\t\t\tawait deleteSliceDirectory({\n\t\t\t\tlibraryID: data.libraryID,\n\t\t\t\tmodel: data.model,\n\t\t\t\t...context,\n\t\t\t});\n\n\t\t\trejectIfNecessary(\n\t\t\t\tawait Promise.allSettled([\n\t\t\t\t\tupsertSliceLibraryIndexFile({\n\t\t\t\t\t\tlibraryID: data.libraryID,\n\t\t\t\t\t\t...context,\n\t\t\t\t\t}),\n\t\t\t\t\tupsertGlobalTypeScriptTypes({\n\t\t\t\t\t\tfilename: context.options.generatedTypesFilePath,\n\t\t\t\t\t\tformat: context.options.format,\n\t\t\t\t\t\t...context,\n\t\t\t\t\t}),\n\t\t\t\t]),\n\t\t\t);\n\t\t});\n\t\thook(\"slice:read\", async (data, context) => {\n\t\t\treturn await readSliceModel({\n\t\t\t\tlibraryID: data.libraryID,\n\t\t\t\tsliceID: data.sliceID,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\n\t\t////////////////////////////////////////////////////////////////\n\t\t// slice-library:*\n\t\t////////////////////////////////////////////////////////////////\n\n\t\thook(\"slice-library:read\", async (data, context) => {\n\t\t\treturn await readSliceLibrary({\n\t\t\t\tlibraryID: data.libraryID,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\n\t\t////////////////////////////////////////////////////////////////\n\t\t// custom-type:*\n\t\t////////////////////////////////////////////////////////////////\n\n\t\thook(\"custom-type:create\", async (data, context) => {\n\t\t\tawait writeCustomTypeModel({\n\t\t\t\tmodel: data.model,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\n\t\t\tawait upsertGlobalTypeScriptTypes({\n\t\t\t\tfilename: context.options.generatedTypesFilePath,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\t\thook(\"custom-type:update\", async (data, context) => {\n\t\t\tawait writeCustomTypeModel({\n\t\t\t\tmodel: data.model,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\n\t\t\tawait upsertGlobalTypeScriptTypes({\n\t\t\t\tfilename: context.options.generatedTypesFilePath,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\t\thook(\"custom-type:rename\", async (data, context) => {\n\t\t\tawait renameCustomType({\n\t\t\t\tmodel: data.model,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\n\t\t\tawait upsertGlobalTypeScriptTypes({\n\t\t\t\tfilename: context.options.generatedTypesFilePath,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\t\thook(\"custom-type:delete\", async (data, context) => {\n\t\t\tawait deleteCustomTypeDirectory({\n\t\t\t\tcustomTypeID: data.model.id,\n\t\t\t\t...context,\n\t\t\t});\n\n\t\t\tawait upsertGlobalTypeScriptTypes({\n\t\t\t\tfilename: context.options.generatedTypesFilePath,\n\t\t\t\tformat: context.options.format,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\t\thook(\"custom-type:read\", async (data, context) => {\n\t\t\treturn await readCustomTypeModel({\n\t\t\t\tcustomTypeID: data.id,\n\t\t\t\t...context,\n\t\t\t});\n\t\t});\n\n\t\t////////////////////////////////////////////////////////////////\n\t\t// custom-type-library:*\n\t\t////////////////////////////////////////////////////////////////\n\n\t\thook(\"custom-type-library:read\", async (_data, context) => {\n\t\t\treturn await readCustomTypeLibrary({\n\t\t\t\thelpers: context.helpers,\n\t\t\t});\n\t\t});\n\t},\n});\n"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+export type PluginOptions = {
+    /**
+     * Determines if generated files should be formatted using Prettier.
+     *
+     * @defaultValue `true`
+     */
+    format?: boolean;
+    /**
+     * Determines if Slice components should be lazy loaded when rendered.
+     *
+     * @defaultValue `true`
+     */
+    lazyLoadSlices?: boolean;
+    /**
+     * Determines if generated files should be written in TypeScript or
+     * JavaScript.
+     *
+     * @defaultValue `true` if the project contains a `tsconfig.json`, `false` otherwise.
+     */
+    typescript?: boolean;
+    /**
+     * The filepath at which generated TypeScript types will be saved.
+     *
+     * @defaultValue `prismicio-types.d.ts`
+     */
+    generatedTypesFilePath?: string;
+    /**
+     * The filepath at which the active Prismic environment is stored as an
+     * environment variable.
+     *
+     * @defaultValue `.env.local`
+     */
+    environmentVariableFilePath?: string;
+};

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@prismicio/adapter-nuxt",
+  "version": "0.0.1",
+  "description": "Prismic adapter for Nuxt.",
+  "keywords": [
+    "typescript",
+    "prismic"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@github.com/prismicio/devtools.git",
+    "directory": "packages/adapter-nuxt"
+  },
+  "license": "Apache-2.0",
+  "author": "Prismic <contact@prismic.io> (https://prismic.io)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "types": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint --max-warnings 0 .",
+    "prepack": "$npm_execpath run build",
+    "depcheck": "depcheck --config=.depcheckrc",
+    "audit": "yarn npm audit --environment production --severity high"
+  },
+  "dependencies": {
+    "@prismicio/plugin-kit": "0.0.1",
+    "common-tags": "1.8.2",
+    "magicast": "0.5.1",
+    "pascal-case": "3.1.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.28.0",
+    "@trivago/prettier-plugin-sort-imports": "6.0.0",
+    "@types/common-tags": "1.8.4",
+    "depcheck": "1.4.7",
+    "eslint": "9.39.1",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-tsdoc": "0.5.0",
+    "nuxt": "4.2.1",
+    "prettier": "3.7.1",
+    "prettier-plugin-jsdoc": "1.7.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.33.0",
+    "vite": "7.2.4",
+    "vite-plugin-sdk": "0.1.5"
+  },
+  "peerDependencies": {
+    "nuxt": "^3.0.0 || ^4.0.0"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,5 @@
+/**
+ * Banner text added to files that should not be edited by users.
+ */
+export const NON_EDITABLE_FILE_BANNER =
+	"// Code generated by Prismic. DO NOT EDIT.";

package/src/hooks/project-init.ts

@@ -0,0 +1,199 @@
+import * as path from "node:path";
+
+import type {
+	ProjectInitHook,
+	ProjectInitHookData,
+	PluginSystemContext,
+} from "@prismicio/plugin-kit";
+import {
+	checkHasProjectFile,
+	deleteProjectFile,
+	readProjectFile,
+	writeProjectFile,
+} from "@prismicio/plugin-kit/fs";
+import { builders, loadFile, writeFile } from "magicast";
+
+import { buildSrcPath } from "../lib/buildSrcPath";
+import { rejectIfNecessary } from "../lib/rejectIfNecessary";
+import type { PluginOptions } from "../types";
+
+const NUXT_PRISMIC = "@nuxtjs/prismic";
+
+type InstallDependenciesArgs = {
+	installDependencies: ProjectInitHookData["installDependencies"];
+};
+
+const installDependencies = async ({
+	installDependencies,
+}: InstallDependenciesArgs) => {
+	await installDependencies({
+		dependencies: {
+			[NUXT_PRISMIC]: "^4.0.0",
+		},
+		dev: true,
+	});
+};
+
+type ConfigurePrismicModuleArgs = PluginSystemContext<PluginOptions>;
+
+const configurePrismicModule = async ({
+	helpers,
+}: ConfigurePrismicModuleArgs) => {
+	let nuxtConfigFilename = "nuxt.config.js";
+
+	if (!(await checkHasProjectFile({ filename: nuxtConfigFilename, helpers }))) {
+		nuxtConfigFilename = "nuxt.config.ts";
+
+		// nuxt.config.* not found
+		if (
+			!(await checkHasProjectFile({ filename: nuxtConfigFilename, helpers }))
+		) {
+			return;
+		}
+	}
+
+	const nuxtConfigPath = helpers.joinPathFromRoot(nuxtConfigFilename);
+
+	const mod = await loadFile(nuxtConfigPath);
+	const config =
+		mod.exports.default.$type === "function-call"
+			? mod.exports.default.$args[0]
+			: mod.exports.default;
+
+	// Register Prismic module
+	let hasInlinedConfiguration = false;
+	const hasPrismicModuleRegistered = (config.modules || []).find(
+		(registration: string | [string, unknown]) => {
+			if (typeof registration === "string") {
+				return registration === NUXT_PRISMIC;
+			} else if (Array.isArray(registration)) {
+				hasInlinedConfiguration = !!registration[1];
+
+				return registration[0] === NUXT_PRISMIC;
+			}
+
+			return false;
+		},
+	);
+
+	if (!hasPrismicModuleRegistered) {
+		config.modules ||= [];
+		config.modules.push(NUXT_PRISMIC);
+	}
+
+	// Append Prismic module configuration
+	if (!hasInlinedConfiguration) {
+		// Import Prismic configuration
+		mod.imports.$add({
+			from: "./prismic.config.json",
+			imported: "apiEndpoint",
+		});
+		mod.imports.$add({
+			from: "./prismic.config.json",
+			imported: "repositoryName",
+		});
+
+		// Add inline configuration
+		config.prismic ||= {};
+		config.prismic.endpoint = builders.raw("apiEndpoint || repositoryName");
+	}
+
+	await writeFile(mod, nuxtConfigPath);
+};
+
+const moveOrDeleteAppVue = async ({
+	helpers,
+	options,
+}: PluginSystemContext<PluginOptions>) => {
+	const filenameAppVue = await buildSrcPath({ filename: "app.vue", helpers });
+
+	// If there's no `app.vue`, there's nothing to do.
+	if (!(await checkHasProjectFile({ filename: filenameAppVue, helpers }))) {
+		return;
+	}
+
+	const filecontentAppVue = await readProjectFile({
+		filename: filenameAppVue,
+		helpers,
+		encoding: "utf-8",
+	});
+
+	// We check for app.vue to contain Nuxt default welcome component to determine
+	// if we need to consider it as the default one or not.
+	if (!filecontentAppVue.includes("<NuxtWelcome")) {
+		return;
+	}
+
+	const filenameIndexVue = await buildSrcPath({
+		filename: path.join("pages/index.vue"),
+		helpers,
+	});
+
+	// If we don't have an `index.vue` we create one with the content of `app.vue`
+	if (!(await checkHasProjectFile({ filename: filenameIndexVue, helpers }))) {
+		await writeProjectFile({
+			filename: filenameIndexVue,
+			contents: filecontentAppVue,
+			format: options.format,
+			helpers,
+		});
+	}
+
+	// Delete `app.vue`
+	await deleteProjectFile({
+		filename: filenameAppVue,
+		helpers,
+	});
+};
+
+const modifyPrismicConfig = async ({
+	helpers,
+	options,
+	actions,
+}: PluginSystemContext<PluginOptions>) => {
+	const hasAppDirectory = await checkHasProjectFile({
+		filename: "app",
+		helpers,
+	});
+	const hasSrcDirectory = await checkHasProjectFile({
+		filename: "src",
+		helpers,
+	});
+	const project = await helpers.getProject();
+
+	// Nest the default Slice Library in the `app` or `src` directory if it
+	// exists and is empty.
+	if (
+		(hasAppDirectory || hasSrcDirectory) &&
+		project.config.libraries &&
+		JSON.stringify(project.config.libraries) === JSON.stringify(["./slices"])
+	) {
+		const sliceLibrary = await actions.readSliceLibrary({
+			libraryID: project.config.libraries[0],
+		});
+
+		if (sliceLibrary.sliceIDs.length < 1) {
+			project.config.libraries = hasAppDirectory
+				? ["./app/slices"]
+				: ["./src/slices"];
+		}
+	}
+
+	await helpers.updatePrismicConfig(project.config, {
+		format: options.format,
+	});
+};
+
+export const projectInit: ProjectInitHook<PluginOptions> = async (
+	{ installDependencies: _installDependencies },
+	context,
+) => {
+	rejectIfNecessary(
+		await Promise.allSettled([
+			installDependencies({ installDependencies: _installDependencies }),
+			configurePrismicModule(context),
+			moveOrDeleteAppVue(context),
+			modifyPrismicConfig(context),
+		]),
+	);
+};

package/src/hooks/slice-create.ts

@@ -0,0 +1,131 @@
+import type {
+	SliceCreateHook,
+	SliceCreateHookData,
+	PluginSystemContext,
+} from "@prismicio/plugin-kit";
+import {
+	upsertGlobalTypeScriptTypes,
+	writeSliceFile,
+	writeSliceModel,
+} from "@prismicio/plugin-kit/fs";
+import { stripIndent } from "common-tags";
+
+import { checkIsTypeScriptProject } from "../lib/checkIsTypeScriptProject";
+import { pascalCase } from "../lib/pascalCase";
+import { rejectIfNecessary } from "../lib/rejectIfNecessary";
+import { upsertSliceLibraryIndexFile } from "../lib/upsertSliceLibraryIndexFile";
+import type { PluginOptions } from "../types";
+
+type CreateComponentFileArgs = {
+	data: SliceCreateHookData;
+} & PluginSystemContext<PluginOptions>;
+
+const createComponentFile = async ({
+	data,
+	helpers,
+	actions,
+	options,
+}: CreateComponentFileArgs) => {
+	const pascalName = pascalCase(data.model.name);
+
+	let contents: string;
+
+	const isTypeScriptProject = await checkIsTypeScriptProject({
+		helpers,
+		options,
+	});
+
+	const placeholderInstructions = `
+		<br />
+		<strong>You can edit this slice directly in your code editor.</strong>
+		<!--
+			💡 Use the Prismic MCP server with your code editor
+			📚 Docs: https://prismic.io/docs/ai#code-with-prismics-mcp-server
+		-->`;
+
+	if (data.componentContents) {
+		contents = data.componentContents;
+	} else if (isTypeScriptProject) {
+		contents = stripIndent`
+			<script setup lang="ts">
+			import type { Content } from "@prismicio/client";
+
+			// The array passed to \`getSliceComponentProps\` is purely optional.
+			// Consider it as a visual hint for you when templating your slice.
+			defineProps(getSliceComponentProps<Content.${pascalName}Slice>(
+				["slice", "index", "slices", "context"]
+			));
+			</script>
+
+			<template>
+				<section
+					:data-slice-type="slice.slice_type"
+					:data-slice-variation="slice.variation"
+				>
+					Placeholder component for ${data.model.id} (variation: {{ slice.variation }}) slices.
+					${placeholderInstructions}
+				</section>
+			</template>
+		`;
+	} else {
+		contents = stripIndent`
+			<script setup>
+			// The array passed to \`getSliceComponentProps\` is purely optional.
+			// Consider it as a visual hint for you when templating your slice.
+			defineProps(getSliceComponentProps(["slice", "index", "slices", "context"]));
+			</script>
+
+			<template>
+				<section
+					:data-slice-type="slice.slice_type"
+					:data-slice-variation="slice.variation"
+				>
+					Placeholder component for {{ model.id }} (variation: {{ slice.variation }}) slices.
+					${placeholderInstructions}
+				</section>
+			</template>
+		`;
+	}
+
+	await writeSliceFile({
+		libraryID: data.libraryID,
+		model: data.model,
+		filename: "index.vue",
+		contents,
+		format: options.format,
+		actions,
+		helpers,
+	});
+};
+
+export const sliceCreate: SliceCreateHook<PluginOptions> = async (
+	data,
+	context,
+) => {
+	rejectIfNecessary(
+		await Promise.allSettled([
+			writeSliceModel({
+				libraryID: data.libraryID,
+				model: data.model,
+				format: context.options.format,
+				helpers: context.helpers,
+			}),
+			createComponentFile({ data, ...context }),
+		]),
+	);
+
+	rejectIfNecessary(
+		await Promise.allSettled([
+			upsertSliceLibraryIndexFile({
+				libraryID: data.libraryID,
+				...context,
+			}),
+			upsertGlobalTypeScriptTypes({
+				filename: context.options.generatedTypesFilePath,
+				format: context.options.format,
+				helpers: context.helpers,
+				actions: context.actions,
+			}),
+		]),
+	);
+};

package/src/index.ts

@@ -0,0 +1,5 @@
+import { plugin } from "./plugin";
+
+export default plugin;
+
+export type { PluginOptions } from "./types";

package/src/lib/buildSrcPath.ts

@@ -0,0 +1,30 @@
+// TODO: If Nuxt provides a way to read `nuxt.config.js`'s `srcDir` value, we
+// can use the exact value given. The current implementation does not support
+// custom values different than "app" or "src".
+import * as path from "node:path";
+
+import { PluginSystemHelpers } from "@prismicio/plugin-kit";
+import { checkHasProjectFile } from "@prismicio/plugin-kit/fs";
+
+export async function buildSrcPath(args: {
+	filename: string;
+	helpers: PluginSystemHelpers;
+}): Promise<string> {
+	const hasAppDirectory = await checkHasProjectFile({
+		filename: "app",
+		helpers: args.helpers,
+	});
+	if (hasAppDirectory) {
+		return path.join("app", args.filename);
+	}
+
+	const hasSrcDirectory = await checkHasProjectFile({
+		filename: "src",
+		helpers: args.helpers,
+	});
+	if (hasSrcDirectory) {
+		return path.join("src", args.filename);
+	}
+
+	return args.filename;
+}

package/src/lib/checkIsTypeScriptProject.ts

@@ -0,0 +1,18 @@
+import { PluginSystemContext } from "@prismicio/plugin-kit";
+import { checkIsTypeScriptProject as baseCheckIsTypeScriptProject } from "@prismicio/plugin-kit/fs";
+
+import { PluginOptions } from "../types";
+
+type CheckIsTypeScriptProjectArgs = {
+	helpers: PluginSystemContext<PluginOptions>["helpers"];
+	options: PluginSystemContext<PluginOptions>["options"];
+};
+
+export const checkIsTypeScriptProject = async (
+	args: CheckIsTypeScriptProjectArgs,
+): Promise<boolean> => {
+	return (
+		args.options.typescript ??
+		baseCheckIsTypeScriptProject({ helpers: args.helpers })
+	);
+};