kenspeckle 0.1.2 → 0.1.4

package/README.md

@@ -206,6 +206,18 @@ const dispose = viewTransitionName(element, 'back-button');
 `viewTransition(update)` on a same-route step names nothing. Morph a stepping element with static
 `view-transition-name` in CSS instead.
 
+## Claude Code plugin
+
+This repo doubles as a Claude Code plugin. `skills/view-transitions/` is the
+agent-facing guide to the view-transition tier — the `data-view-transition`
+contract, `viewTransitionName` claims and their phases, the duplicate-name
+abort, and the list of things the library already handles so an agent stops
+reimplementing them. Point a marketplace entry at this repo
+(`.claude-plugin/plugin.json` is at the root) and it installs as `kenspeckle`,
+invoked as `/kenspeckle:view-transitions`.
+
+The skill and the code ship in the same change, same rule as the docs pages.
+
 ## Provenance
 
 kenspeckle is a curation, not a fork. [runed](https://runed.dev) has genuinely useful utilities under three naming regimes at once — PascalCase classes, bare functions, and React-style `use` hooks, with pairs like `Debounced` / `useDebounce` coexisting. [svelte-put](https://svelte-put.vnphanquang.com) has good actions from the Svelte 4 era, before attachments existed. kenspeckle reshapes both pools under one convention and adds what neither ships: attachments as a first-class layer.

package/dist/kit/types.d.ts

@@ -2,6 +2,8 @@
 export interface Navigation {
     complete: Promise<void>;
     type?: string;
+    /** Optional because SvelteKit 2 has no such field; only Kit 3 reports it. */
+    shallow?: boolean;
     delta?: number | null;
     from?: {
         url: URL;

package/dist/kit/view-transition.js

@@ -25,30 +25,39 @@ export function isRetreat(navigation) {
 }
 /** @internal — the handler `viewTransition()` registers, exported so it is testable without a component. */
 export function navigationTransition({ onStart, onSettle, ...rest } = {}) {
-    return (navigation) => new Promise((resolve) => {
-        let transitioning = false;
-        runViewTransition(async () => {
-            // resolve() BEFORE awaiting breaks a mutual wait: Kit holds the navigation until this
-            // promise settles, the browser holds the snapshot until the callback settles.
-            resolve();
-            await navigation.complete;
-            if (transitioning)
-                beginPhase(navigation, 'arrival');
-        }, {
-            ...rest,
-            state: isRetreat(navigation) ? 'retreat' : 'forward',
-            onStart: () => {
-                transitioning = true;
-                beginPhase(navigation, 'capture');
-                onStart?.(navigation);
-            },
-            onSettle: () => {
-                transitioning = false;
-                endTransition();
-                onSettle?.();
-            }
+    return (navigation) => {
+        // SvelteKit 3 fires onNavigate for a shallow navigation; Kit 2 never did. The route is
+        // unchanged, so there is no arrival to cross-fade to, and holding the navigation suspends
+        // rendering — a call site that strips a query param and then calls window.print()
+        // synchronously would print a suspended page. A consumer who does want a shallow change
+        // animated has `viewTransition(update)`, which says so at the call site.
+        if (navigation.shallow)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            let transitioning = false;
+            runViewTransition(async () => {
+                // resolve() BEFORE awaiting breaks a mutual wait: Kit holds the navigation until this
+                // promise settles, the browser holds the snapshot until the callback settles.
+                resolve();
+                await navigation.complete;
+                if (transitioning)
+                    beginPhase(navigation, 'arrival');
+            }, {
+                ...rest,
+                state: isRetreat(navigation) ? 'retreat' : 'forward',
+                onStart: () => {
+                    transitioning = true;
+                    beginPhase(navigation, 'capture');
+                    onStart?.(navigation);
+                },
+                onSettle: () => {
+                    transitioning = false;
+                    endTransition();
+                    onSettle?.();
+                }
+            });
         });
-    });
+    };
 }
 export function viewTransition(first, second) {
     if (typeof first === 'function')

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "kenspeckle",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"description": "Svelte 5 utilities under one naming convention: attachments first-class, view transitions, and a state machine with context.",
 	"license": "MIT",
 	"author": "Brandon Pittman <brandon@brandonpittman.com>",
@@ -51,7 +51,7 @@
 	},
 	"peerDependencies": {
 		"svelte": "^5.40.0",
-		"@sveltejs/kit": "^2.0.0"
+		"@sveltejs/kit": "^2.0.0 || ^3.0.0-next.0"
 	},
 	"peerDependenciesMeta": {
 		"@sveltejs/kit": {