sveltekit-temporal 0.1.0 → 0.3.0

package/README.md

@@ -1,10 +1,26 @@
 # sveltekit-temporal
 
+Think about it, temporal may be supported in big 3 wrosers soon, but your users may bit update for some time.
+
 One-shot CLI that wires the Temporal API polyfill into a SvelteKit project, with conditional loading so browsers that ship Temporal natively (Chrome 144+, Firefox 139+) and server runtimes that do too (Node.js 26+) pay zero bytes.
 
+
 ## 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 +75,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/bin/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { run } from '../src/index.js';
+import { run } from '../dist/index.js';
 
 run().catch((err) => {
 	console.error(err);

package/dist/addon.js

@@ -0,0 +1,129 @@
+// src/addon.js
+import { defineAddon, defineAddonOptions } from "sv";
+
+// src/shared.js
+var MARKER = "// sveltekit-temporal: managed block";
+var END_MARKER = "// end sveltekit-temporal managed block";
+function buildBootstrap(pkgName, isTypeScript) {
+  const tsLine1 = isTypeScript ? `	// @ts-expect-error - polyfilling globalThis
+` : "";
+  const tsLine2 = isTypeScript ? `	// @ts-expect-error - patching Date.prototype
+` : "";
+  return `${MARKER}
+// Conditionally load the Temporal polyfill when the runtime lacks native support.
+// Native (Chrome 144+, Firefox 139+) keeps zero overhead \u2014 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}	globalThis.Temporal = Temporal;
+${tsLine2}	Date.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_MARKER}`;
+}
+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 {};
+`;
+}
+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}
+`);
+    return replaced === content ? false : replaced;
+  }
+  const exportMatch = content.match(/\n\s*export\s*\{\s*\};?\s*$/);
+  if (exportMatch) {
+    return content.replace(exportMatch[0], `
+
+${block}
+${exportMatch[0]}`);
+  }
+  return `${content.trimEnd()}
+
+${block}
+
+export {};
+`;
+}
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/addon.js
+var 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();
+var addon_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: options2, language, directory }) {
+    const pkgName = options2.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';
+${content}`
+    );
+    sv.file(
+      `${directory.src}/hooks.server.${ext}`,
+      (content) => content.includes("import '$lib/temporal'") ? false : `import '$lib/temporal';
+${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 \u2014 no imports needed."]
+});
+export {
+  addon_default as default
+};