kuinetic 0.2.0 → 0.2.2

package/dist/types/advanced/camera-3d.d.ts

@@ -7,10 +7,6 @@ import type { Animator } from '../core/animator.js';
 import { type AdvancedEnv, type WindowLike, type RafFunction, type CafFunction, clamp } from './base.js';
 import { type AudioBand } from './audio.js';
 export { clamp };
-export type CameraParamAccessor = EffectParams | {
-    num?: (name: string, fallback?: number) => number;
-    text?: (name: string, fallback?: string) => string;
-};
 export interface CameraLayer {
     element: HTMLElement;
     depthZ: number;

package/dist/types/advanced/fluid-cursor.d.ts

@@ -6,10 +6,6 @@ import type { Registry } from '../core/registry.js';
 import type { Animator } from '../core/animator.js';
 import { type AdvancedEnv, type WindowLike, type DocumentLike, type RafFunction, type CafFunction, clamp } from './base.js';
 export { clamp };
-export type FluidParamAccessor = EffectParams | {
-    num?: (name: string, fallback?: number) => number;
-    text?: (name: string, fallback?: string) => string;
-};
 export interface FluidDrop {
     x: number;
     y: number;

package/dist/types/advanced/particles.d.ts

@@ -6,10 +6,6 @@ import type { Registry } from '../core/registry.js';
 import type { Animator } from '../core/animator.js';
 import { type AdvancedEnv, type WindowLike, type DocumentLike, type RafFunction, type CafFunction, clamp } from './base.js';
 export { clamp };
-export type ParticleParamAccessor = EffectParams | {
-    num?: (name: string, fallback?: number) => number;
-    text?: (name: string, fallback?: string) => string;
-};
 export interface Particle {
     x: number;
     y: number;

package/dist/types/advanced/scenes.d.ts

@@ -6,10 +6,6 @@ import type { Registry } from '../core/registry.js';
 import type { Animator } from '../core/animator.js';
 import { type AdvancedEnv, type WindowLike, type RafFunction, type CafFunction, clamp, lerp } from './base.js';
 export { clamp, lerp };
-export type SceneParamAccessor = EffectParams | {
-    num?: (name: string, fallback?: number) => number;
-    text?: (name: string, fallback?: string) => string;
-};
 export interface TransitionValue {
     from: number;
     to: number;

package/dist/types/browser/boot.d.ts

@@ -39,16 +39,21 @@
  *
  * ## Opt-out
  *
- * `data-kui-manual` on a bundle's own `<script>` tag means "this bundle does not auto-init". Put it
- * on every tag to get exactly the pre-auto-start behaviour back. Marking *core* manual necessarily
- * disables the whole chain, because core is the only thing that creates an animator — so a tier
- * that sees core go manual stays quiet rather than complaining that core is missing.
+ * `data-kui-manual` on a bundle's own `<script>` tag means "this bundle does not auto-init". On a
+ * tier it takes that tier out entirely. On *core* it means "do not auto-START": core makes no
+ * animator and starts nothing, and the author builds one by hand, as before auto-start existed.
+ * It does not mean "do not wire tiers" — a page that loads `kuinetic.advanced.js` next to a manual
+ * core still wants the advanced effects on the animator it builds. So core keeps its factory
+ * wrapped in a registration-only mode (`guarded`, below): every animator built by hand gets the
+ * tiers that have loaded, in either tag order, before its first scan whenever that is possible.
  */
 /** Only what this file calls. Structural, because it cannot import the real types. */
 interface AnimatorLike {
     start(): unknown;
     scan(root?: ParentNode): unknown;
     reset(el: Element): void;
+    /** Present on the real `Animator`; a destroyed one must stop receiving tiers. */
+    destroy?(): unknown;
 }
 type Options = Record<string, unknown>;
 /** The IIFE namespace object a bundle built with `--global-name=kuinetic` exposes. */

package/dist/types/core/activation.d.ts

@@ -235,8 +235,19 @@ export interface ActivationDiagnosticsRequest {
     spec: ActivationSpec;
     /** Declared support from the composed primitives; empty means no primitive claimed anything. */
     supported: NamedActivation[];
+    /**
+     * What each composed effect declares on its own. Optional: without it the check can only compare
+     * against the intersection in `supported`, exactly as it did before compositions were told apart.
+     */
+    claims?: ActivationSupportClaim[];
     reporter: Reporter;
 }
+/** One composed effect's own declaration, as `compile.ts` records it. */
+export interface ActivationSupportClaim {
+    supported: NamedActivation[];
+    /** The effect is an entrance — a reveal, which is what an `enter` trigger is written for. */
+    entrance: boolean;
+}
 /**
  * Report every way an authored activation looks like a mistake.
  *

package/dist/types/core/compile.d.ts

@@ -1,3 +1,4 @@
+import type { ActivationSupportClaim } from './activation.js';
 import type { Registry, ResolvedEffect } from './registry.js';
 import type { SequenceStep } from './sequence.js';
 import type { TargetScope } from './target.js';
@@ -115,6 +116,12 @@ export interface CompiledPlan {
     defaultActivation?: Activation;
     /** Activations every composed primitive supports, for enforcement by the animator. */
     supportedActivations: NamedActivation[];
+    /**
+     * What each composed effect declares on its own, in authoring order. `supportedActivations` above
+     * is their intersection and cannot say *which* effect a trigger does not suit, or whether an
+     * entrance beside it is what the trigger was written for — `warnAboutActivation` needs both.
+     */
+    activationClaims: ActivationSupportClaim[];
     /**
      * Timelines every composed primitive supports. Empty means none — `style-plan.ts` must not
      * apply a native `view()`/`scroll()` timeline the author's effect doesn't declare support for,

package/dist/types/core/derived/types.d.ts

@@ -6,7 +6,6 @@ import type { ElementConfig } from '../element-config.js';
 import type { Registry } from '../registry.js';
 import type { Reporter } from '../reporter.js';
 import type { Activation, InstanceState, ParsedValue, Timeline } from '../types.js';
-export type { StaggerGroupKeys } from '../stagger-config.js';
 /** Everything `Animator.install` needs. Moved here verbatim from `animator.ts`'s own
  *  `InstallRequest`, plus three optional fields that are absent for every HEAD code path. */
 export interface InstallRequest {

package/dist/types/core/gesture.d.ts

@@ -49,8 +49,13 @@ export interface GestureOptions {
      * shell swallowed every click on its own dots and buttons, because the click was delivered to the
      * shell. `swipeable` recognises and publishes an attribute — it never moves anything — so it has
      * nothing to stay under the cursor for and opts out.
+     *
+     * `'drag'` is the middle path for a gesture that moves nothing but must still *finish*: no capture
+     * on `pointerdown` (so a tap or click reaches its real target), capture once movement crosses the
+     * threshold. A flick that leaves a small element otherwise never delivers `pointerup` to it, and
+     * the swipe is never reported. A drag is not a click, so retargeting after it costs nothing.
      */
-    capturePointer?: boolean;
+    capturePointer?: boolean | 'drag';
 }
 export interface GestureDeps {
     now(): number;

package/dist/types/core/stagger.d.ts

@@ -2,7 +2,7 @@ import type { StyleLedger } from './owned-styles.js';
 import type { Reporter } from './reporter.js';
 import type { StaggerFrom, StaggerGroupKeys, StaggerLayout } from './stagger-config.js';
 export { parseStaggerAttribute, resolveStaggerConfig } from './stagger-config.js';
-export type { GridOrigin, StaggerAxis, StaggerColumns, StaggerConfig, StaggerFrom, StaggerGroupKeys, StaggerLayout, } from './stagger-config.js';
+export type { StaggerFrom, StaggerGroupKeys, StaggerLayout, } from './stagger-config.js';
 /**
  * Rank every child of a group of `count` animated children.
  *

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "kuinetic",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Declarative web animation from HTML attributes. Native CSS where possible, JS only where necessary.",
   "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AINSEP/kuinetic.git"
+  },
+  "homepage": "https://kuinetic.com",
   "sideEffects": [
     "*.css"
   ],
@@ -58,6 +63,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",
@@ -84,7 +92,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"