kuinetic 0.2.1 → 0.2.3

package/dist/types/showcase/lightbox.d.ts

@@ -1,3 +1,25 @@
-import type { Preset, Primitive } from '../core/types.js';
+import type { DeckViewerRequest } from '../core/deck-viewer.js';
+import type { Cleanup, Preset, Primitive } from '../core/types.js';
+/**
+ * Click-to-view for a deck: `carousel-3d lightbox:true` and every other deck with the parameter.
+ * Provided to the decks through `core/deck-viewer.ts` by `registerShowcase`.
+ *
+ * Every card of the deck becomes one gallery, opened at the card clicked, through the same
+ * `galleryContent` the `lightbox` effect opens — buttons, keys, swipe, `loop`, the media rules and
+ * the one shared modal shell, unforked.
+ *
+ * What counts as a click is the deck's to say, and it already says it. The listener is on the host
+ * in the *bubble* phase, and a deck's drag consumes the click that ends a drag in the *capture*
+ * phase on the same host (`carousel/drag.ts`'s `guardClicks`), with `stopPropagation` — so a drag
+ * never reaches this listener, and nothing here re-derives a threshold. (That a tap's click lands
+ * on the card at all, rather than on the host, rests on the drag taking pointer capture only once a
+ * press becomes a drag — `capturePointer: 'drag'` in `createRingDrag`.) A card turned away from
+ * the viewer is `pointer-events: none` (`carousel.css`) and cannot be the target; the
+ * `data-kui-ring-face` check repeats that for an engine whose hit-testing ignores it.
+ *
+ * @returns Removes the listener and releases this deck's hold on the shared modal.
+ * @complexity O(n) per click in the deck's cards; O(1) space between clicks.
+ */
+export declare function attachDeckLightbox(request: DeckViewerRequest): Cleanup;
 export declare const LIGHTBOX_PRIMITIVE: Primitive;
 export declare const LIGHTBOX_PRESETS: Preset[];

package/dist/types/showcase/modal-shell.d.ts

@@ -7,6 +7,17 @@ export interface ModalContent {
     reducedMotion: boolean;
     onKey?: (event: KeyboardEvent) => void;
     onClose?: () => void;
+    /**
+     * Whether a click on `target` lands on the content and keeps the viewer open. Omitted, anything
+     * inside the content node counts; a viewer whose node fills the screen narrows it to its media.
+     */
+    inside?: (target: Element) => boolean;
+    /**
+     * The element that opened this content — a deck's card, a `lightbox` trigger. The shell announces
+     * `kui:viewer` from it on open and on close (`core/deck-viewer.ts`), which is how a deck it sits in
+     * pauses its own motion for exactly as long as the viewer shows one of its cards.
+     */
+    opener?: Element;
 }
 export interface ModalShell {
     open(content: ModalContent): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kuinetic",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Declarative web animation from HTML attributes. Native CSS where possible, JS only where necessary.",
   "type": "module",
   "license": "MIT",
@@ -37,6 +37,10 @@
       "types": "./dist/types/advanced/index.d.ts",
       "default": "./dist/esm/advanced/index.mjs"
     },
+    "./notes": {
+      "types": "./dist/types/notes/index.d.ts",
+      "default": "./dist/esm/notes/index.mjs"
+    },
     "./css": "./dist/kuinetic.css",
     "./package.json": "./package.json"
   },
@@ -50,8 +54,8 @@
     "lint:dead": "knip",
     "ci": "npm run build:dist && node scripts/verify-tiers.mjs && npm run typecheck && npm run lint && npm run lint:deps && npm run lint:dead && npm run check:css-coverage && npm run test:coverage && npm run test:browser",
     "size": "npm run build:dist && size-limit",
-    "build": "npm run generate:css && esbuild src/index.ts --bundle --format=iife --global-name=kuinetic --minify --sourcemap=linked --outfile=demo/kuinetic.js && esbuild src/css/index.css --bundle --outfile=demo/kuinetic.css && npx @tailwindcss/cli -i demo/tailwind-entry.css -o demo/tailwind.css && node scripts/build-tiers.mjs demo && node scripts/build-standalone.mjs demo && npm run sync:docs",
-    "build:dist": "npm run clean:dist && npm run generate:css && esbuild src/index.ts src/core/index.ts src/effects/index.ts src/advanced/index.ts --bundle --format=esm --splitting --outdir=dist/esm --out-extension:.js=.mjs && esbuild src/index.ts --bundle --format=iife --global-name=kuinetic --outfile=dist/kuinetic.js && esbuild src/css/index.css --bundle --outfile=dist/kuinetic.css && esbuild src/index.ts --bundle --format=iife --global-name=kuinetic --minify --outfile=dist/kuinetic.min.js && esbuild src/css/index.css --bundle --minify --outfile=dist/kuinetic.min.css && tsc -p tsconfig.build.json && node scripts/build-tiers.mjs && node scripts/build-standalone.mjs",
+    "build": "npm run generate:css && esbuild src/index.ts --bundle --format=iife --global-name=kuinetic --minify --sourcemap=linked --outfile=demo/kuinetic.js && esbuild src/notes/index.ts --bundle --format=iife --global-name=kuineticNotes --minify --outfile=demo/kuinetic.notes.js && esbuild src/css/index.css --bundle --outfile=demo/kuinetic.css && npx @tailwindcss/cli -i demo/tailwind-entry.css -o demo/tailwind.css && node scripts/build-tiers.mjs demo && node scripts/build-standalone.mjs demo && npm run sync:docs",
+    "build:dist": "npm run clean:dist && npm run generate:css && esbuild src/index.ts src/core/index.ts src/effects/index.ts src/advanced/index.ts src/notes/index.ts --bundle --format=esm --splitting --outdir=dist/esm --out-extension:.js=.mjs && esbuild src/index.ts --bundle --format=iife --global-name=kuinetic --outfile=dist/kuinetic.js && esbuild src/notes/index.ts --bundle --format=iife --global-name=kuineticNotes --minify --outfile=dist/kuinetic.notes.js &&esbuild src/css/index.css --bundle --outfile=dist/kuinetic.css && esbuild src/index.ts --bundle --format=iife --global-name=kuinetic --minify --outfile=dist/kuinetic.min.js && esbuild src/css/index.css --bundle --minify --outfile=dist/kuinetic.min.css && tsc -p tsconfig.build.json && node scripts/build-tiers.mjs && node scripts/build-standalone.mjs",
     "verify:standalone": "npm run build:dist && node scripts/verify-standalone.mjs",
     "verify:tiers": "npm run build:dist && node scripts/verify-tiers.mjs",
     "verify:pack": "npm run build:dist && node scripts/verify-pack.mjs",
@@ -63,6 +67,9 @@
     "test:browser": "npm run build && node scripts/run-browser-tests.mjs",
     "test:visual": "npm run build && node scripts/visual-regression.mjs",
     "test:visual:update": "npm run build && node scripts/visual-regression.mjs --update",
+    "test:visual:pages": "npm run build && node scripts/visual-regression-pages.mjs",
+    "test:visual:pages:update": "npm run build && node scripts/visual-regression-pages.mjs --update",
+    "test:pages": "npm run build && node scripts/run-browser-tests.mjs --only page-",
     "generate:css": "node scripts/generate-preset-css.mjs",
     "generate:nav": "node scripts/generate-nav-header.mjs",
     "record": "npm run build && node scripts/verify-browser.mjs --record",
@@ -89,7 +96,6 @@
     "pngjs": "^7.0.0",
     "size-limit": "^13.0.3",
     "tailwindcss": "^4.3.3",
-    "three": "^0.186.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.66.0",
     "vitest": "^2.1.9"