sveltekit-temporal 0.1.0 → 0.2.0

package/README.md

@@ -4,7 +4,20 @@ One-shot CLI that wires the Temporal API polyfill into a SvelteKit project, with
 
 ## Usage
 
+## Using with the Svelte CLI (`sv add`)
+
+If you prefer the official Svelte CLI, this package also works as an `sv` add-on:
+
 ```bash
+# Or when creating a new project
+npx sv create my-app
+cd my-app
+npx sv add sveltekit-temporal
+
+# Into an existing project
+npx sv add sveltekit-temporal
+
+#Alternatively, you can run the CLI directly
 npx sveltekit-temporal
 ```
 
@@ -59,18 +72,18 @@ export async function handle({ event, resolve }) {
 
 ## Runtime support
 
-| Runtime | Native Temporal | Notes |
-|---------|----------------|-------|
-| Node.js ≤ 25 | No | Polyfill required |
-| Node.js 26+ | Yes (behind `--experimental-temporal`) | Polyfill still safe to include — the conditional check skips loading it |
-| Bun | No | Polyfill required; Bun tracks V8 but has not shipped Temporal yet |
-| Deno | No | Polyfill required; Deno tracks V8 but has not shipped Temporal yet |
-| Chrome 144+ | Yes | Polyfill skipped automatically |
-| Firefox 139+ | Yes | Polyfill skipped automatically |
-| Safari | No | Polyfill required |
+| Runtime      | Native Temporal                        | Notes                                                                   |
+| ------------ | -------------------------------------- | ----------------------------------------------------------------------- |
+| Node.js ≤ 25 | No                                     | Polyfill required                                                       |
+| Node.js 26+  | Yes (behind `--experimental-temporal`) | Polyfill still safe to include — the conditional check skips loading it |
+| Bun          | No                                     | Polyfill required; Bun tracks V8 but has not shipped Temporal yet       |
+| Deno         | No                                     | Polyfill required; Deno tracks V8 but has not shipped Temporal yet      |
+| Chrome 144+  | Yes                                    | Polyfill skipped automatically                                          |
+| Firefox 139+ | Yes                                    | Polyfill skipped automatically                                          |
+| Safari       | No                                     | Polyfill required                                                       |
 
 The conditional bootstrap in `src/lib/temporal.ts` checks `typeof Temporal !== 'undefined'` before loading the polyfill, so upgrading your runtime later requires no code changes.
 
 ## Switching polyfills later
 
-Just re-run the CLI and pick the other option. Only the two files that name the package (`src/lib/temporal.*` and `src/app.d.ts`) will change.
+Re-run either the CLI or `sv add` and pick the other option. Only the two files that name the package (`src/lib/temporal.*` and `src/app.d.ts`) will change.

package/package.json

@@ -1,9 +1,13 @@
 {
 	"name": "sveltekit-temporal",
 	"author": "Scott Rhamy",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "Set up the Temporal API polyfill in a SvelteKit project with conditional loading on client and server.",
 	"type": "module",
+	"exports": {
+		".": "./src/index.js",
+		"./sv": "./src/addon.js"
+	},
 	"bin": {
 		"sveltekit-temporal": "bin/cli.js"
 	},
@@ -19,12 +23,21 @@
 		"@clack/prompts": "^0.7.0",
 		"picocolors": "^1.0.0"
 	},
+	"peerDependencies": {
+		"sv": "*"
+	},
+	"peerDependenciesMeta": {
+		"sv": {
+			"optional": true
+		}
+	},
 	"keywords": [
 		"svelte",
 		"sveltekit",
 		"temporal",
 		"polyfill",
-		"cli"
+		"cli",
+		"sv-add"
 	],
 	"license": "MIT"
 }

package/src/addon.js

@@ -0,0 +1,54 @@
+import { defineAddon, defineAddonOptions } from 'sv';
+import { MARKER, buildBootstrap, buildNewAppDts, processAppDts } from './shared.js';
+
+const options = defineAddonOptions()
+	.add('polyfill', {
+		question: 'Which Temporal polyfill would you like to use?',
+		type: 'select',
+		options: ['@js-temporal/polyfill', 'temporal-polyfill'],
+		default: '@js-temporal/polyfill'
+	})
+	.build();
+
+export default defineAddon({
+	id: 'temporal',
+	shortDescription: 'Temporal API polyfill with conditional loading for SvelteKit',
+	options,
+
+	setup({ isKit, unsupported }) {
+		if (!isKit) unsupported('Requires SvelteKit.');
+	},
+
+	run({ sv, options, language, directory }) {
+		const pkgName = options.polyfill;
+		const isTs = language === 'ts';
+		const ext = language;
+
+		sv.dependency(pkgName, 'latest');
+
+		sv.file(`${directory.lib}/temporal.${ext}`, (content) => {
+			if (content && !content.includes(MARKER)) return false;
+			return buildBootstrap(pkgName, isTs);
+		});
+
+		sv.file(`${directory.kitRoutes}/+layout.${ext}`, (content) =>
+			content.includes("import '$lib/temporal'")
+				? false
+				: `import '$lib/temporal';\n${content}`
+		);
+
+		sv.file(`${directory.src}/hooks.server.${ext}`, (content) =>
+			content.includes("import '$lib/temporal'")
+				? false
+				: `import '$lib/temporal';\n${content}`
+		);
+
+		if (isTs) {
+			sv.file(`${directory.src}/app.d.ts`, (content) =>
+				content.trim() ? processAppDts(content, pkgName) : buildNewAppDts(pkgName)
+			);
+		}
+	},
+
+	nextSteps: () => ['Reference Temporal directly anywhere in your app — no imports needed.']
+});

package/src/index.js

@@ -1,8 +1,9 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { join, resolve, dirname } from 'node:path';
+import { join, dirname } from 'node:path';
 import { execSync } from 'node:child_process';
 import * as p from '@clack/prompts';
 import pc from 'picocolors';
+import { MARKER, buildBootstrap, buildNewAppDts, processAppDts } from './shared.js';
 
 const POLYFILLS = {
 	official: {
@@ -17,8 +18,6 @@ const POLYFILLS = {
 	}
 };
 
-const MARKER = '// sveltekit-temporal: managed block';
-
 export async function run() {
 	console.log();
 	p.intro(pc.bgCyan(pc.black(' sveltekit-temporal ')));
@@ -190,41 +189,6 @@ function installCommand(pm, pkg) {
 	}
 }
 
-// ─── File generation ────────────────────────────────────────────────────────
-
-function buildBootstrap(pkgName, isTypeScript) {
-	const tsLine1 = isTypeScript ? `\t// @ts-expect-error - polyfilling globalThis\n` : '';
-	const tsLine2 = isTypeScript ? `\t// @ts-expect-error - patching Date.prototype\n` : '';
-
-	return `${MARKER}
-// Conditionally load the Temporal polyfill when the runtime lacks native support.
-// Native (Chrome 144+, Firefox 139+) keeps zero overhead — the dynamic import is
-// code-split by Vite and only fetched on browsers that need it.
-
-if (typeof globalThis.Temporal === 'undefined') {
-	const { Temporal, toTemporalInstant } = await import('${pkgName}');
-${tsLine1}\tglobalThis.Temporal = Temporal;
-${tsLine2}\tDate.prototype.toTemporalInstant = toTemporalInstant;
-}
-
-export {};
-`;
-}
-
-function buildAppDtsBlock(pkgName) {
-	return `${MARKER}
-import type { Temporal as TemporalNS } from '${pkgName}';
-
-declare global {
-	const Temporal: typeof TemporalNS;
-
-	interface Date {
-		toTemporalInstant(): TemporalNS.Instant;
-	}
-}
-// end sveltekit-temporal managed block`;
-}
-
 // ─── File writers (idempotent) ──────────────────────────────────────────────
 
 function writeManaged(path, contents, log) {
@@ -266,58 +230,22 @@ function ensureImportInFile(path, importLine, log) {
 }
 
 function updateAppDts(path, pkgName, log) {
-	const block = buildAppDtsBlock(pkgName);
-
 	if (!existsSync(path)) {
-		const stub = `// See https://svelte.dev/docs/kit/types#app.d.ts for information about these interfaces
-declare global {
-	namespace App {
-		// interface Error {}
-		// interface Locals {}
-		// interface PageData {}
-		// interface PageState {}
-		// interface Platform {}
-	}
-}
-
-${block}
-
-export {};
-`;
 		mkdirSync(dirname(path), { recursive: true });
-		writeFileSync(path, stub);
+		writeFileSync(path, buildNewAppDts(pkgName));
 		log.created.push(rel(path));
 		return;
 	}
 
 	const existing = readFileSync(path, 'utf8');
+	const result = processAppDts(existing, pkgName);
 
-	// Already has our managed block — replace it (handles polyfill switch)
-	if (existing.includes(MARKER)) {
-		const pattern = new RegExp(
-			`${escapeRegex(MARKER)}[\\s\\S]*?// end sveltekit-temporal managed block\\n?`,
-			'm'
-		);
-		const replaced = existing.replace(pattern, `${block}\n`);
-		if (replaced === existing) {
-			log.skipped.push(rel(path));
-		} else {
-			writeFileSync(path, replaced);
-			log.updated.push(rel(path));
-		}
+	if (result === false) {
+		log.skipped.push(rel(path));
 		return;
 	}
 
-	// No managed block yet — append before any trailing `export {}` if present,
-	// otherwise just append.
-	const exportMatch = existing.match(/\n\s*export\s*\{\s*\};?\s*$/);
-	let next;
-	if (exportMatch) {
-		next = existing.replace(exportMatch[0], `\n\n${block}\n${exportMatch[0]}`);
-	} else {
-		next = `${existing.trimEnd()}\n\n${block}\n\nexport {};\n`;
-	}
-	writeFileSync(path, next);
+	writeFileSync(path, result);
 	log.updated.push(rel(path));
 }
 
@@ -326,7 +254,3 @@ export {};
 function rel(absPath) {
 	return absPath.replace(process.cwd() + '/', '');
 }
-
-function escapeRegex(s) {
-	return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}

package/src/shared.js

@@ -0,0 +1,76 @@
+export const MARKER = '// sveltekit-temporal: managed block';
+const END_MARKER = '// end sveltekit-temporal managed block';
+
+export function buildBootstrap(pkgName, isTypeScript) {
+	const tsLine1 = isTypeScript ? `\t// @ts-expect-error - polyfilling globalThis\n` : '';
+	const tsLine2 = isTypeScript ? `\t// @ts-expect-error - patching Date.prototype\n` : '';
+
+	return `${MARKER}
+// Conditionally load the Temporal polyfill when the runtime lacks native support.
+// Native (Chrome 144+, Firefox 139+) keeps zero overhead — the dynamic import is
+// code-split by Vite and only fetched on browsers that need it.
+
+if (typeof globalThis.Temporal === 'undefined') {
+	const { Temporal, toTemporalInstant } = await import('${pkgName}');
+${tsLine1}\tglobalThis.Temporal = Temporal;
+${tsLine2}\tDate.prototype.toTemporalInstant = toTemporalInstant;
+}
+
+export {};
+`;
+}
+
+export function buildAppDtsBlock(pkgName) {
+	return `${MARKER}
+import type { Temporal as TemporalNS } from '${pkgName}';
+
+declare global {
+	const Temporal: typeof TemporalNS;
+
+	interface Date {
+		toTemporalInstant(): TemporalNS.Instant;
+	}
+}
+${END_MARKER}`;
+}
+
+export function buildNewAppDts(pkgName) {
+	return `// See https://svelte.dev/docs/kit/types#app.d.ts for information about these interfaces
+declare global {
+	namespace App {
+		// interface Error {}
+		// interface Locals {}
+		// interface PageData {}
+		// interface PageState {}
+		// interface Platform {}
+	}
+}
+
+${buildAppDtsBlock(pkgName)}
+
+export {};
+`;
+}
+
+export function processAppDts(content, pkgName) {
+	const block = buildAppDtsBlock(pkgName);
+
+	if (content.includes(MARKER)) {
+		const pattern = new RegExp(
+			`${escapeRegex(MARKER)}[\\s\\S]*?${escapeRegex(END_MARKER)}\\n?`,
+			'm'
+		);
+		const replaced = content.replace(pattern, `${block}\n`);
+		return replaced === content ? false : replaced;
+	}
+
+	const exportMatch = content.match(/\n\s*export\s*\{\s*\};?\s*$/);
+	if (exportMatch) {
+		return content.replace(exportMatch[0], `\n\n${block}\n${exportMatch[0]}`);
+	}
+	return `${content.trimEnd()}\n\n${block}\n\nexport {};\n`;
+}
+
+export function escapeRegex(s) {
+	return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}